Conectar Microsoft OneDrive con la federación de datos

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

Sigue este procedimiento para buscar en tu cuenta de Microsoft OneDrive mediante la búsqueda federada.

Acerca de la federación de datos

Con la federación de datos, Gemini Enterprise obtiene directamente información de las fuentes de datos de terceros mediante APIs, en lugar de copiar los datos en Gemini Enterprise. Con este método, puedes acceder a fuentes de datos externas inmediatamente, sin tener que esperar a que se ingieran.

Antes de empezar la configuración federada de Microsoft OneDrive

Sigue estos pasos antes de conectarte a tu almacén de datos de Microsoft OneDrive mediante la búsqueda federada.

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

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

  2. Configura los siguientes permisos de 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 puede acceder el usuario

    Sites.Read.All

    Delegada

    Leer elementos de todas las colecciones de sitios

  3. Añade las siguientes URLs como URLs de retrollamada web:

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

Crear un conector de búsqueda federada con OneDrive

Sigue estos pasos para usar la consola y realizar una búsqueda federada en Microsoft OneDrive desde Gemini Enterprise. Google Cloud

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

    Gemini Enterprise

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

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

  4. En la página Seleccionar una fuente de datos, selecciona Búsqueda federada de OneDrive para conectar tu fuente de datos de terceros.

  5. En Ajustes de autenticación, selecciona el método de autenticación que quieras usar.

    1. Introduce el ID de cliente, el secreto de cliente, la URL de instancia y el ID de cliente.

    2. Haz clic en Autenticar.

    3. Haz clic en Continuar.

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

  7. Escribe el nombre de 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 creado 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 usuario

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

Para iniciar el flujo de autorización, sigue estos pasos:

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

  2. Inicia sesión en tu cuenta.

  3. Haz clic en Conceder acceso. Después de conceder acceso, se te redirigirá a Gemini Enterprise para completar el proceso 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 consultas

Después de autorizar Microsoft OneDrive, cuando introduzcas una consulta de búsqueda:

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

  2. Gemini Enterprise combina los resultados con los de otras fuentes y los muestra.

Tratamiento de datos

Cuando se usa la búsqueda federada de terceros, la cadena de consulta se envía al backend de búsqueda de terceros. Estos terceros pueden asociar las consultas con tu identidad. Si hay varias fuentes de datos de búsqueda federada habilitadas, la consulta se puede enviar a todas ellas.

Una vez que los datos llegan al sistema de terceros, se rigen por los términos 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 necesario para la API Graph.
ONEDRIVE_MISSING_PERMISSION_2 La aplicación no tiene el rol Group.Read.All necesario para la API Graph.
ONEDRIVE_MISSING_PERMISSION_3 La aplicación no tiene los roles obligatorios User.Read.All o User.ReadBasic.All para la API Graph.
ONEDRIVE_INVALID_SITE_URI La URL de la instancia no es válida.
ONEDRIVE_INVALID_AUTH Se ha producido un error al obtener el token de acceso de la API de Graph. Esto puede deberse a un ID de cliente no válido, a un valor secreto no válido o a que faltan credenciales federadas.
ONEDRIVE_UNCATEGORIZED_ERROR El archivo no tiene ninguna ACL o no es válida.
ONEDRIVE_TOO_MANY_REQUESTS OneDrive ha recibido demasiadas solicitudes HTTP y ha devuelto una respuesta HTTP 429.

Pasos siguientes