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 se habilita el almacén de datos de Microsoft OneDrive, 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.
Copia los archivos 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 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, también selecciona 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 los usuarios. 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.

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 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 los archivos adjuntos.
  • Acceso delegado: El acceso a los 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 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 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 archivos PDF 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?