Conecta Microsoft SharePoint Online con la federación de datos

En esta página, se describe cómo conectar Microsoft SharePoint Online a Gemini Enterprise con la federación de datos.

Sigue este procedimiento para realizar búsquedas en tu cuenta de SharePoint con la búsqueda federada.

Acerca de la federación de datos

Con la federación de datos, Gemini Enterprise recupera información directamente de las fuentes de datos de terceros a través de APIs, en lugar de copiar los datos en Gemini Enterprise. Con este enfoque, puedes acceder a fuentes de datos externas de inmediato, sin esperar a la transferencia.

Antes de comenzar

Antes de crear el conector en Gemini Enterprise, debes configurar un registro de aplicación de Entra para habilitar el acceso seguro a SharePoint.

1. Para registrar Gemini Enterprise como una aplicación de OAuth 2.0 en Entra, haz lo siguiente:

   1. Navega al centro de administración de Microsoft Entra.
   2. En el menú, expande la sección Aplicaciones y selecciona Registros de aplicaciones.
   3. En la página Registros de aplicaciones, selecciona Nuevo registro.

      

      Registra una app nueva en el centro de administración de Microsoft Entra

   4. Crea un registro de la app en la página Registrar una aplicación:

      

      Selecciona el tipo de cuenta y, luego, ingresa el URI de redireccionamiento

   5. En la sección Tipos de cuentas compatibles, selecciona Cuentas solo en el directorio de la organización.

   6. En la sección URI de redireccionamiento, selecciona Web y, luego, ingresa las siguientes URLs como URLs de devolución de llamada web (o URLs de redireccionamiento):

      • https://vertexaisearch.cloud.google.com/console/oauth/sharepoint_oauth.html
      • https://vertexaisearch.cloud.google.com/oauth-redirect

   7. Haz clic en Registrar. Se creará tu app.

2. Para obtener el ID y el secreto del cliente de la app, haz lo siguiente:

   1. En la página de la app, selecciona Certificados y secretos.
   2. Haz clic en Nuevo secreto de cliente.
   3. Ingresa una descripción para el secreto.
   4. Selecciona una duración de vencimiento. Te recomendamos que selecciones el valor predeterminado.
   5. Haz clic en Agregar.
   6. Copia el secreto que se muestra en la columna Value (Client Secret) y el identificador de la columna Secret ID (Client ID), y almacena ambos de forma segura para usarlos más adelante.

3. Para configurar los permisos de API necesarios para la app, haz lo siguiente:

   1. En la página de la app, selecciona Permisos de API.

   2. Haz clic en Agregar permisos.

   3. En la página Solicitar permisos de API, selecciona SharePoint.

   4. Selecciona Permisos delegados.

   5. Busca y selecciona los siguientes permisos:

      • Sites.Search.All

      Para el acceso al sitio, elige cualquiera de los siguientes permisos:

      • AllSites.Read: Te permite buscar en todos los documentos a los que tiene acceso en cualquier sitio.
      • Sites.Selected: Te brinda más control administrativo. Los administradores pueden restringir los sitios que el usuario puede consultar, pero deben otorgar acceso a cada sitio individual que quieran habilitar. Para obtener más información, consulta Cómo otorgar permisos a una colección de sitios específica.

   6. Haz clic en Agregar permisos.

Crea un conector de búsqueda federada con SharePoint

Console

Sigue estos pasos para que la consola Google Cloud realice una búsqueda federada en SharePoint desde Gemini Enterprise.

1. En la consola Google Cloud , ve a la página Gemini Enterprise.

   Gemini Enterprise

2. En el menú de navegación, haz clic en Almacenes de datos.

3. Haz clic en Crear almacén de datos.

4. En la página Selecciona una fuente de datos, desplázate o busca SharePoint Federated para conectar tu fuente de terceros.

   

   Search for SharePoint Federated

5. En Configuración de autenticación, haz lo siguiente:

   1. Ingresa el ID de cliente, el secreto de cliente, la URL de la instancia y el ID del arrendatario.
   2. Haz clic en Autenticar.

   3. Haz clic en Continuar.

      

      Ingresa la información de autenticación

6. Selecciona los tipos de entidades que deseas buscar.

   

   Selecciona los tipos de entidades

7. Selecciona una región para tu fuente de datos.

8. Ingresa un nombre para la fuente de datos.

   

   Configura tu conector de datos

9. Haz clic en Crear. Gemini Enterprise crea tu almacén de datos y lo muestra en la página Almacenes de datos.

Una vez que se cree el almacén de datos, ve a la página Almacenes de datos y haz clic en el nombre del almacén de datos para ver el estado. Si el estado del conector cambia de Creando a Activo, el conector de búsqueda federada estará listo para usarse.

Autorización de usuarios

Después de crear un almacén de datos de búsqueda federada, lo verás en la lista de fuentes de datos en el panel de administración de fuentes. Si no autorizaste Gemini Enterprise anteriormente, no podrás seleccionar la fuente de datos. En su lugar, aparece un botón Autorizar junto a él.

Para iniciar el flujo de autorización, haz lo siguiente:

1. Haz clic en Autorizar. Se te redireccionará al servidor de autorización de SharePoint.

   

   Haz clic en Autorizar.

2. Accede a tu cuenta.

3. Haz clic en Otorgar acceso. Después de otorgar acceso, se te redireccionará de nuevo a Gemini Enterprise para completar el flujo de autorización. Gemini Enterprise obtiene el access_token y lo usa para acceder a la búsqueda de terceros.

Ejecución de las consultas

Cuando ingresas una búsqueda, sucede lo siguiente:

• Si se autoriza SharePoint, Gemini Enterprise envía la consulta a la API de SharePoint.
• Gemini Enterprise combina los resultados con los de otras fuentes y los muestra.

Manejo de datos

Cuando usas la búsqueda federada de terceros, tu cadena de consulta se envía al backend de búsqueda de terceros. Estos terceros pueden asociar las búsquedas con tu identidad. Si hay varias fuentes de datos de búsqueda federada habilitadas, es posible que la consulta se envíe a todas ellas.

Una vez que los datos llegan al sistema de terceros, se rigen por las Condiciones del Servicio y las políticas de privacidad de ese sistema (no por las condiciones de Google Cloud).

Nota: Es posible que un LLM vuelva a escribir tu búsqueda antes de que se envíe. Esta consulta reescrita puede incorporar información de tu historial de consultas basadas en la sesión. Como resultado, es posible que partes de ese historial también se incluyan en lo que se envía a los backends de terceros.