Conecta Microsoft OneDrive con la federación de datos

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

Sigue este procedimiento para buscar en tu cuenta de Microsoft OneDrive 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 la configuración federada de Microsoft OneDrive

Realiza los siguientes pasos antes de conectarte a tu almacén de datos de Microsoft OneDrive con la búsqueda federada.

  1. Registra Gemini Enterprise como una aplicación de OAuth 2.0 en Microsoft Entra ID y recopila la siguiente información:

    • ID de cliente
    • Secreto del cliente
    • URL de la instancia: Es la URL de OneDrive de tu organización. Por ejemplo, https://example-my.sharepoint.com.
    • ID de usuario

  2. Configura los siguientes permisos de la aplicación de Microsoft Graph con el consentimiento de un administrador de Microsoft OneDrive:

    Permiso

    Tipo

    Descripción

    Files.Read.All

    Delegada

    Leer todos los archivos a los que el usuario puede acceder

    Sites.Read.All

    Delegada

    Leer los elementos en todas las colecciones de sitios

  3. Agrega las siguientes URLs como URLs de devolución de llamada web:

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

Crea un conector de búsqueda federada con OneDrive

Usa los siguientes pasos para que la consola de Google Cloud realice una búsqueda federada en Microsoft OneDrive desde Gemini Enterprise.

  1. En la consola de 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, elige OneDrive Federated Search para conectar tu fuente de datos externa.

  5. En Configuración de autenticación, selecciona el método de autenticación que deseas usar.

    1. Ingresa el ID de cliente, el secreto de cliente, la URL de la instancia y el ID del usuario.

    2. Haz clic en Autenticar.

    3. Haz clic en Continuar.

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

  7. Ingresa un nombre para la fuente de datos.

  8. 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. Cuando el estado del conector cambia de Creando a Activo, el conector de búsqueda federada está 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, aparecerá el botón Autorizar.

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

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

  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 token de acceso y lo usa para acceder a la búsqueda de Microsoft OneDrive.

Ejecución de las consultas

Después de autorizar a Microsoft OneDrive, cuando ingreses una búsqueda, ocurrirá lo siguiente:

  1. Gemini Enterprise envía tu búsqueda a la API de Microsoft Graph.

  2. 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.

Códigos de error

En la siguiente tabla, se enumeran los códigos de error y las descripciones de OneDrive.

Código de error Descripción
ONEDRIVE_MISSING_PERMISSION_1 La aplicación no tiene el rol Files.Read.All requerido para la API de Graph.
ONEDRIVE_MISSING_PERMISSION_2 La aplicación no tiene el rol Group.Read.All requerido para la API de Graph.
ONEDRIVE_MISSING_PERMISSION_3 La aplicación no tiene los roles requeridos User.Read.All o User.ReadBasic.All para la API de Graph.
ONEDRIVE_INVALID_SITE_URI La URL de la instancia no es válida.
ONEDRIVE_INVALID_AUTH Se produjo un error cuando se recuperaba el token de acceso a la API de Graph. Esto puede deberse a un ID de cliente o un valor secreto no válidos, o a la falta de credenciales federadas.
ONEDRIVE_UNCATEGORIZED_ERROR El archivo no contiene una ACL válida o no contiene ninguna.
ONEDRIVE_TOO_MANY_REQUESTS OneDrive recibió demasiadas solicitudes HTTP y devolvió una respuesta HTTP 429.

Próximos pasos