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 una fuente a un destino en Microsoft OneDrive.
Subir archivo Sube un archivo a una ubicación especificada en Microsoft OneDrive.
Descargar archivo Descarga un archivo de Microsoft OneDrive a una ubicación especificada.
Copiar carpeta Copia una carpeta de una fuente a un destino en Microsoft OneDrive.
Mover el archivo Mueve un archivo de una fuente a un destino en Microsoft OneDrive.
Mover carpeta Mueve una carpeta de una fuente 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.
Compartir archivo o carpeta Comparte un archivo o una carpeta con destinatarios especificados o genera un vínculo para compartir.
Actualizar las propiedades del archivo 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 Acciones para el modo de conexión de Búsqueda federada o Transferencia de datos, selecciona también los permisos que se indican en la fila Acciones.

Modo de conexión Alcance 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 elementos de lista 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 la unidad del usuario para el descubrimiento de contenido.
Transferencia 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 los grupos para 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 token de actualización de OAuth 2.0) Permite que el almacén de datos lea los perfiles de los usuarios.
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.
Acciones 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 el usuario puede acceder.
Files.ReadWrite.All (Delegado) Permite que el almacén de datos lea y actualice archivos en todas las unidades a las que el usuario tiene acceso. Es necesario para las acciones de mutación de archivos y carpetas (copiar, mover, cambiar nombre, compartir, actualizar propiedades) que operan en archivos almacenados en unidades más allá del propio 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 los Controles del servicio de VPC en los almacenes de datos de Microsoft OneDrive existentes. 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 las 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 global, us, y eu ubicaciones.

Las siguientes son las limitaciones del almacén de datos federado de Microsoft OneDrive:

  • Limitaciones de búsqueda: Los resultados de la búsqueda pueden variar y no siempre son integrales para todos los tipos de archivos. Es posible que no se pueda acceder al contenido de las carpetas archivadas o encriptadas para la búsqueda. La búsqueda federada no admite la búsqueda dentro de archivos adjuntos.
  • Acceso delegado: El acceso a archivos o carpetas compartidos de Microsoft OneDrive puede requerir permisos específicos que no están cubiertos por la autorización estándar del usuario.
  • Analizador de diseño en el modo de búsqueda federada: Si bien el analizador de diseño es estándar, su eficacia en PDFs 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 completos o el tiempo necesario para el análisis profundo que realiza el analizador de diseño durante la transferencia de datos.

  • Funciones de PDF no compatibles: Por lo tanto, 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

Las siguientes son 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

Para los datos de Microsoft OneDrive que contienen PDFs con funciones complejas (como tablas, diseños de varias columnas o contenido dependiente de OCR), te recomendamos que uses el modo de transferencia de datos para realizar búsquedas efectivas. Este modo permite que el analizador de diseño procese y, luego, indexe profundamente todo el contenido del documento.

¿Qué sigue?