El conector de Microsoft OneDrive para Gemini Enterprise te permite acceder a tu cuenta de Microsoft OneDrive y, luego, interactuar con tus archivos y carpetas.
Versiones compatibles de Microsoft OneDrive
El conector 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 conector 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. |
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 conector lea todos los archivos a los que el usuario puede acceder. |
Sites.Read.All |
(Delegado) Permite que el conector lea documentos y elementos de lista en todas las colecciones de sitios a las que el usuario puede acceder. | |
| Transferencia de datos | GroupMember.Read.All |
(Credenciales federadas y token de actualización de OAuth 2.0) Permite que el conector 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 conector lea el perfil de los usuarios que accedieron. También permite que el conector lea 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 conector lea 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 conector tenga control total de todas las colecciones de sitios. La opción 2 permite que el conector 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 conector lea los perfiles de usuario. La opción 2 permite que el conector lea un conjunto básico de propiedades del perfil de otros usuarios de la organización. | |
| Actions | Files.ReadWrite.AppFolder |
(Delegado) Permite que el conector lea, cree, actualice y borre archivos en la carpeta de Microsoft OneDrive. |
Files.ReadWrite |
(Delegado) Permite que el conector lea, cree, 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 conector de Microsoft OneDrive.
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 ubicaciones globales, de EE.UU. y de la UE.
Cuando crees una aplicación nueva o agregues un almacén de datos a una aplicación existente, te recomendamos que agregues un almacén de datos con acciones que pertenezcan a un solo tipo de conector. Por ejemplo, no asocies dos almacenes de datos de Microsoft OneDrive con acciones habilitadas a la misma aplicación.
A continuación, se indican las limitaciones del conector 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.
A continuación, se indican las limitaciones del conector de transferencia de datos de Microsoft OneDrive:
- La sincronización incremental no detecta acciones a nivel de la carpeta, como Copiar, Mover o Cambiar nombre.
¿Qué sigue?
- Para crear y configurar un conector con Microsoft OneDrive, consulta Cómo configurar un almacén de datos de Microsoft OneDrive.