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 admitidas

Cuando el almacén de datos de Microsoft OneDrive está habilitado, los usuarios finales pueden usar comandos en 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.
Copia el 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.

Permisos necesarios

Para permitir que Gemini Enterprise realice búsquedas y la transferencia 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 Búsqueda federada o Transferencia de datos, también selecciona 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 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 Drive 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 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 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 para 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 del 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 el usuario puede acceder.

Para obtener información sobre cómo agregar los permisos de 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 de 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 archivos adjuntos.
  • Acceso delegado: El acceso a archivos o carpetas compartidos de Microsoft OneDrive puede requerir permisos específicos que no se incluyen en la autorización estándar del usuario.
  • Analizador de diseño en 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 requieren 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 necesarios para el análisis detallado que realiza el analizador de diseño durante la transferencia de datos.

  • Funciones de PDF no admitidas: Por lo tanto, es posible que las estructuras de PDF complejas no se analicen ni se puedan buscar por completo. 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

Para los datos de Microsoft OneDrive que contienen PDFs 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 búsquedas eficaces. Este modo permite que el analizador de diseño procese y también indexe en profundidad todo el contenido del documento.

¿Qué sigue?