El almacén de datos de Google Drive para Gemini Enterprise te permite buscar y realizar acciones en tus datos de Google Drive, incluidos archivos y carpetas.
Acciones compatibles
Cuando el almacén de datos de Google Drive está habilitado, los usuarios finales pueden usar comandos de lenguaje natural en Gemini Enterprise para realizar las siguientes acciones.
| Acción | Descripción |
|---|---|
| Copiar archivo | Copia un archivo en Google Drive. |
| Crear archivo | Crea un archivo nuevo en Google Drive. |
| Descargar contenido del archivo | Descarga el contenido de un archivo de Google Drive. |
| Obtener valores de celdas | Lee los valores de las celdas de una hoja de cálculo de Google. |
| Obtén metadatos de archivos | Recupera los metadatos de un archivo de Google Drive. |
| Obtén permisos de archivo | Enumera los permisos de un archivo de Google Drive. |
| Obtener hoja de cálculo | Lee el contenido y los metadatos de una hoja de cálculo de Hojas de cálculo de Google. |
| Insertar dimensiones | Inserta filas o columnas en una hoja de cálculo de Google. |
| Enumera los archivos recientes | Muestra una lista de los archivos recientes en Google Drive. |
| Enumera las unidades compartidas | Enumera las unidades compartidas en Google Drive. |
| Leer documento | Lee el contenido de un documento de Google. |
| Leer el contenido del archivo | Lee el contenido de un archivo de Google Drive. |
| Leer presentación | Lee el contenido de una presentación de Google. |
| Buscar archivos | Busca archivos de Google Drive que coincidan con una consulta. |
| Compartir archivo | Comparte un archivo de Google Drive con uno o más usuarios. |
| Enviar archivo a la papelera | Mueve un archivo de Google Drive a la papelera. |
| Actualiza los valores de las celdas | Escribe valores de celda en una hoja de cálculo de Google. |
| Actualizar archivo | Actualiza un archivo de Google Drive existente. |
| Actualiza fórmulas | Escribe fórmulas en una hoja de cálculo de Hojas de cálculo de Google. |
Permisos obligatorios
La app de OAuth administrada por Googlesolicita los siguientes permisos de OAuth. Los usuarios otorgan estos permisos cuando autorizan el conector:
| Alcance | Objetivo |
|---|---|
https://www.googleapis.com/auth/drive.readonly |
Busca y recupera contenido de Google Drive. Permite que el almacén de datos enumere archivos y carpetas, vea metadatos, enumere permisos y lea el contenido de los archivos. |
https://www.googleapis.com/auth/drive.metadata.readonly |
Leer los metadatos de los archivos de Google Drive |
https://www.googleapis.com/auth/drive.file |
Crear y actualizar archivos que el usuario abre o crea con el conector |
https://www.googleapis.com/auth/drive.appdata |
Almacenar datos específicos de la aplicación en Google Drive |
https://www.googleapis.com/auth/drive |
Realizar acciones de escritura en archivos de Google Drive (por ejemplo, copiar, compartir, enviar a la papelera y actualizar) |
Limitaciones
- El almacén de datos de Google Drive solo se admite en las ubicaciones
global,usyeu.
Si usas controles de seguridad, ten en cuenta sus limitaciones relacionadas con los datos en Google Drive, como se explica en la siguiente tabla:
Control de seguridad Ten en cuenta lo siguiente Residencia de datos (DRZ) Gemini Enterprise solo garantiza la residencia de datos en Google Cloud. Para obtener información sobre la residencia de los datos y Google Drive, consulta la documentación y la guía de cumplimiento de Google Workspace, incluidas las regiones de datos de Google Workspace. También revisa ejemplos como Elige la región en la que se almacenan los datos y Soberanía digital. Claves de encriptación administradas por el cliente (CMEK) Tus claves solo encriptan datos dentro de Google Cloud. Los controles de Cloud Key Management Service no se aplican a los datos almacenados en Google Drive. Transparencia de acceso Los registros de Transparencia de acceso registran las acciones que realiza el personal de Google en el proyecto Google Cloud . También deberás revisar los registros de Transparencia de acceso que creó Google Workspace. Para obtener más información, consulta Eventos de registro de Transparencia de acceso en la documentación de la Ayuda para administradores de Google Workspace.
Problemas comunes con las búsquedas
Si la búsqueda no devuelve el archivo que buscas o si la app web de Gemini Enterprise informa que no se encontraron archivos de Google Drive que coincidan, revisa los siguientes problemas y soluciones.
El acceso de Gemini Enterprise a los datos de Google Workspace está inhabilitado
Síntoma: La app web de Gemini Enterprise informa que no se encontraron
archivos de Google Drive que coincidan, o las solicitudes de búsqueda enviadas a través de la
API de Search devuelven un error
(o una advertencia) 403 Permission
Denied: Workspace access for Agentspace disabled by organization admin.. También puedes inspeccionar los registros de errores del almacén de datos en Cloud Logging.
Consulta Soluciona problemas de los almacenes de datos de Gemini Enterprise.
Problema: El parámetro de configuración Permitir que Gemini Enterprise acceda a los datos de Google Workspace está desactivado en la Consola del administrador de Google la organización de Google Workspace del usuario.
Solución: Pídele a un administrador de Google Workspace de la organización del usuario que active Permitir que Gemini Enterprise acceda a los datos de Google Workspace. En las configuraciones entre organizaciones, un administrador de cada organización de Google Workspace cuyos usuarios consulten Google Drive debe activar este parámetro.
El usuario y el almacén de datos pertenecen a diferentes organizaciones de Google Workspace
Síntoma: Los usuarios que acceden desde una organización de Google Workspace diferente
a la del proyecto de Google Cloud no reciben resultados de Google Drive en la
app web de Gemini Enterprise, o las solicitudes enviadas a través de la API de Search
devuelven un error 403 Permission Denied: User
does not belong to the same organization as the Workspace data store. Workspace
data store is configured for customer ID ... while user belongs to customer ID
.... Para verificar si hay errores de 403 en los registros, consulta Accede a los registros de errores del conector de Gemini Enterprise con Cloud Logging.
Problema: De forma predeterminada, Gemini Enterprise solo permite que los usuarios busquen en un almacén de datos de Google Drive cuando el ID de cliente de Google Workspace del usuario coincide con la organización del almacén de datos de Google Drive y el proyecto de Google Cloud .
Solución: Completa la configuración entre organizaciones:
- Comunícate con la Atención al cliente de Cloud para agregar el ID de cliente de cada organización de Google Workspace cuyos usuarios accedan a Gemini Enterprise a la lista de entidades permitidas de tu proyecto de Google Cloud .
- Pídele a un administrador de Google Workspace de cada organización de Google Workspace que active la opción Permitir que Gemini Enterprise acceda a los datos de Google Workspace.
- Si los usuarios necesitan encontrar documentos que pertenecen a otra organización, habilita Incluir documentos de varios dominios en Administrar funciones de la app web.
No se pueden buscar las palabras clave que superen el límite de extracción de texto de 1 MB.
Síntoma: La búsqueda de palabras clave que aparecen más adelante en un archivo grande no devuelve el archivo.
Problema: Google Drive solo extrae 1 MB de datos de texto y formato de tu archivo para que se pueda buscar. No se pueden buscar las palabras clave que superen el límite de indexación de 1 MB.
Solución: Realiza la búsqueda con términos que aparezcan en el primer 1 MB del archivo o divide los documentos grandes en archivos más pequeños.
No se indexan los archivos que superan los límites de tamaño o de páginas de PDF
Síntoma: Algunos archivos grandes o PDFs extensos no aparecen en los resultados de la búsqueda.
Problema: Los archivos que superan los límites de tamaño o de páginas de Google Drive no se indexan y no aparecerán en los resultados de la búsqueda:
- En la mayoría de los tipos de archivos, el tamaño no puede superar los 10 MB, con las siguientes excepciones:
- Archivos XLSX: hasta 20 MB
- Archivos PDF: hasta 30 MB
- Archivos de texto: hasta 100 MB
- El reconocimiento óptico de caracteres (OCR) en archivos PDF se limita a 80 páginas. Google Drive no indexa los archivos PDF que superen los 50 MB o las 80 páginas.
Solución: Reduce el tamaño de los archivos o divide los archivos y los PDF que superen estos límites de indexación.
¿Qué sigue?
- Para crear y configurar un almacén de datos con Google Drive, consulta Configura un almacén de datos de Google Drive.