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. Registra Gemini Enterprise como una aplicación de OAuth 2.0 en Entra.

   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. Sigue estos pasos para agregar un secreto del cliente:

      1. Ve a Certificados y secretos y haz clic en Nuevo secreto del cliente.
      2. Copia y anota la cadena secreta.

2. Recopila las siguientes credenciales:

   • ID de cliente
   • Secreto del cliente
   • URL de la instancia
   • ID de usuario

3. Configura estos permisos de la API de SharePoint (aplicación) con el consentimiento del administrador:

   Permiso	Tipo
   AllSites.Read	Delegada
   MyFiles.Read	Delegada
   Sites.Search.All	Delegada

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.