Descripción general

El almacén de datos de Microsoft OneDrive para Gemini Enterprise te permite buscar y realizar acciones en tus archivos y carpetas.

Versiones compatibles de Microsoft OneDrive

El almacén de datos de Microsoft OneDrive admite todas las versiones alojadas de Microsoft OneDrive a través de la API de Microsoft Graph v1.0.

Acciones compatibles

Cuando el almacén de datos de Microsoft OneDrive está habilitado, los usuarios finales pueden usar comandos de lenguaje natural en Gemini Enterprise para realizar las siguientes acciones.

Acción Descripción
Crear carpeta Crea una carpeta nueva en una ruta de acceso especificada en Microsoft OneDrive.
Copiar archivo Copia un archivo de un origen a un destino en Microsoft OneDrive.
Subir archivo Sube un archivo a una ubicación especificada en Microsoft OneDrive.
Descargar el archivo Descarga un archivo de Microsoft OneDrive en una ubicación especificada.
Copiar carpeta Copia una carpeta de un origen a un destino en Microsoft OneDrive.
Mover el archivo Mueve un archivo de un origen a un destino en Microsoft OneDrive.
Mover carpeta Mueve una carpeta de un origen a un destino en Microsoft OneDrive.
Cambiar el nombre del archivo Cambia el nombre de un archivo en Microsoft OneDrive.
Cambiar nombre de carpeta Cambia el nombre de una carpeta en Microsoft OneDrive.
Comparte un archivo o una carpeta Comparte un archivo o una carpeta con los destinatarios especificados o genera un vínculo para compartir.
Actualiza las propiedades de los archivos Actualiza las propiedades de metadatos de un archivo en Microsoft OneDrive.

Permisos necesarios

Para permitir que Gemini Enterprise realice búsquedas y transferencias de datos con el almacén de datos de Microsoft OneDrive, necesitas los siguientes permisos:

Permisos de la API de Microsoft Graph

En la siguiente tabla, se describen los permisos necesarios para cada modo de conexión.

Nota: En la siguiente tabla, se describen los permisos necesarios para cada modo de conexión. Si habilitas las Acciones para el modo de conexión Búsqueda federada o Transferencia de datos, selecciona también los permisos que se indican en la fila Acciones.

Modo de conexión Permiso Purpose
Búsqueda federada Files.Read.All (Delegado) Permite que el almacén de datos lea todos los archivos a los que el usuario puede acceder.
Sites.Read.All (Delegado) Permite que el almacén de datos lea documentos y enumere elementos en todas las colecciones de sitios a las que el usuario puede acceder.
User.Read.All (Delegado) Permite que el almacén de datos resuelva las ubicaciones de las unidades de los usuarios para el descubrimiento de contenido.
Ingesta de datos GroupMember.Read.All (Credenciales federadas y token de actualización de OAuth 2.0) Permite que el almacén de datos lea las membresías y las propiedades básicas de todos los grupos sin un usuario que haya accedido.
User.Read (Credenciales federadas y token de actualización de OAuth 2.0) Permite que el almacén de datos lea el perfil de los usuarios que accedieron. También permite que el almacén de datos lea la información básica de la empresa de los usuarios que accedieron.
User.Read.All (Solo para el token de actualización de OAuth 2.0) Permite que el almacén de datos lea los perfiles de usuario.
Sites.FullControl.All (Opción 1)
Sites.Selected (Opción 2)		 (Credenciales federadas y token de actualización de OAuth 2.0) La opción 1 permite que el almacén de datos tenga control total de todas las colecciones de sitios. La opción 2 permite que el almacén de datos acceda a un subconjunto de colecciones de sitios. Las colecciones de sitios específicas y los permisos otorgados se pueden configurar en Microsoft OneDrive.
User.Read.All (Opción 1)
User.ReadBasic.All (Opción 2)		 (Solo credenciales federadas) La opción 1 permite que el almacén de datos lea los perfiles de usuario. La opción 2 permite que el almacén de datos lea un conjunto básico de propiedades de perfil de otros usuarios de la organización.
Actions Files.ReadWrite.AppFolder (Delegado) Permite que el almacén de datos lea, cree, actualice y borre archivos en la carpeta de Microsoft OneDrive.
Files.ReadWrite Delegado: Permite que el almacén de datos lea, descargue, cree, suba, actualice y borre los archivos a los que puede acceder el usuario.
Files.ReadWrite.All (Delegado) Permite que el almacén de datos lea y actualice archivos en todas las unidades a las que tiene acceso el usuario. Es obligatorio para las acciones de mutación de archivos y carpetas (copiar, mover, cambiar el nombre, compartir y actualizar propiedades) que operan en archivos almacenados en unidades más allá de la propia cuenta de Microsoft OneDrive del usuario.

Para obtener información sobre cómo agregar los permisos para Microsoft OneDrive, consulta Configura Microsoft OneDrive y establece los permisos necesarios.

Limitaciones

En esta sección, se describen los problemas y las limitaciones conocidos que pueden afectar el uso del almacén de datos de Microsoft OneDrive.

  • Cuando crees una app nueva o agregues un almacén de datos a una existente, te recomendamos que asocies solo un almacén de datos con acciones que pertenezcan a un solo tipo de conector.
  • No se admite la aplicación de un perímetro de Controles del servicio de VPC en los almacenes de datos existentes de Microsoft OneDrive. Para aplicar los Controles del servicio de VPC, debes borrar y volver a crear los almacenes de datos. Para obtener más información sobre los Controles del servicio de VPC y cómo usar acciones después de habilitarlos, consulta Protege tu app con los Controles del servicio de VPC.
  • El almacén de datos de Microsoft OneDrive solo se admite en las ubicaciones global, us y eu.

A continuación, se indican las limitaciones del almacén de datos federado de Microsoft OneDrive:

  • Limitaciones de la búsqueda: Los resultados de la búsqueda pueden variar y no siempre son exhaustivos para todos los tipos de archivos. Es posible que no se pueda acceder al contenido de las carpetas archivadas o encriptadas para realizar búsquedas. La búsqueda federada no admite la búsqueda dentro de los archivos adjuntos.
  • Acceso delegado: Es posible que el acceso a los archivos o las carpetas compartidos de Microsoft OneDrive requiera permisos específicos que no se incluyen en la autorización de usuario estándar.
  • Analizador de diseño en el modo de búsqueda federada: Si bien el analizador de diseño es estándar, su eficacia en archivos PDF complejos (con tablas, diseños de varias columnas o que necesitan OCR) es limitada en el modo de búsqueda federada. Es posible que las llamadas a la API en tiempo real de este modo no proporcionen los datos o el tiempo completos que se requieren para el análisis profundo que realiza el analizador de diseño durante la transferencia de datos.

  • Funciones de PDF no compatibles: En consecuencia, es posible que las estructuras de PDF complejas no se analicen por completo ni se puedan buscar. Incluye lo siguiente:

    • Diseños de texto de varias columnas
    • Datos dentro de tablas y gráficos incorporados
    • Texto en documentos escaneados que requieren reconocimiento óptico de caracteres (OCR)
    • Documentos con órdenes de lectura no lineales o formato complejo

A continuación, se indican las limitaciones del almacén de datos de transferencia de Microsoft OneDrive:

  • La sincronización incremental no detecta acciones a nivel de la carpeta, como Copiar, Mover o Cambiar nombre.

Recomendación

En el caso de los datos de Microsoft OneDrive que contienen archivos PDF con funciones complejas (como tablas, diseños de varias columnas o contenido que depende del OCR), recomendamos usar el modo de transferencia de datos para realizar una búsqueda eficaz. Este modo permite que el analizador de diseño procese e indexe en profundidad todo el contenido del documento.

¿Qué sigue?