En esta página, se describe cómo crear un almacén de datos y conectar Google Drive a Gemini Enterprise. Esta conexión permite que Gemini Enterprise recupere información directamente de Google Drive. Como los datos no se copian en el índice de Gemini Enterprise, no tienes que administrar el almacenamiento de datos.
Antes de comenzar
Para preparar tu entorno de Google Drive antes de crear el almacén de datos, haz lo siguiente:
Debes acceder a la consola de Google Cloud con la misma cuenta que usas para la instancia de Google Drive que planeas conectar. Gemini Enterprise usa tu ID de cliente de Google Workspace para conectarse a Google Drive. Las Cuentas de Google personales (cuentas de consumidor que terminan en
@gmail.com) no tienen un ID de cliente y no se admiten.Para aplicar el control de acceso a la fuente de datos y proteger los datos en Gemini Enterprise, asegúrate de configurar tu proveedor de identidad.
Verifica que se pueda acceder a todos los documentos. Para ello, colócalos en una unidad compartida que sea propiedad del dominio o asigna la propiedad a un usuario del dominio.
Habilita el acceso de Gemini Enterprise en Google Workspace: En la Consola del administrador deGoogle , un administrador de Google Workspace de la organización en la que residen tus usuarios y los datos de Google Drive debe activar Permitir que Gemini Enterprise acceda a los datos de Google Workspace. Si este parámetro de configuración está desactivado, las búsquedas de Google Drive no devolverán resultados en la app web de Gemini Enterprise (y pueden devolver un error
403 Permission Denied: Workspace access for Agentspace disabled by organization admin.en la API). Para obtener instrucciones, consulta Controla el acceso de Gemini Enterprise a los datos de Google Workspace.Habilita las funciones inteligentes: En tu cuenta de Google Workspace, activa las Funciones inteligentes en Google Workspace y las Funciones inteligentes en otros productos deGoogle . Para obtener más información, consulta Activa o desactiva las funciones inteligentes de Google Workspace.
Agrega la app de OAuth a tu lista de entidades permitidas: El almacén de datos de Google Drive usa una app de OAuth administrada por Googlepara acceder a tus datos. Si tu organización restringe el acceso a la app de OAuth, el administrador de Google Workspace debe agregar esta app a la lista de entidades permitidas de tu organización. Para obtener más detalles, consulta Agrega la app de OAuth administrada por Google a la lista de entidades permitidas.
Configura el acceso entre organizaciones (si corresponde): 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 . Si tus usuarios o datos de Google Drive pertenecen a una organización de Google Workspace diferente (por ejemplo, cuando tu proyecto de Google Cloud está en un dominio y los usuarios acceden desde uno o más dominios de Google Workspace o usuarios de prueba independientes), completa los siguientes pasos:
- Comunícate con el Atención al cliente de Cloud para agregar
el ID de cliente de la organización de Google Workspace de cada usuario (por ejemplo,
C01234567) a la lista de entidades permitidas de tu proyecto de Google Cloud . - Haz que un administrador de Google Workspace en cada organización de Google Workspace active Permitir que Gemini Enterprise acceda a los datos de Google Workspace en la Consola del administrador de Google esa organización. No basta con habilitar este parámetro de configuración solo en la organización del proyecto de Google Cloud . Para obtener más detalles, consulta Controla el acceso de Gemini Enterprise a los datos de Google Workspace.
Además, si los usuarios necesitan encontrar documentos que no pertenecen a su organización, habilita Incluir documentos de varios dominios para tu app. Puedes seleccionar esta opción cuando creas la app o habilitarla más adelante en Administrar funciones de la app web.
- Comunícate con el Atención al cliente de Cloud para agregar
el ID de cliente de la organización de Google Workspace de cada usuario (por ejemplo,
Crea el almacén de datos de Google Drive
Para crear el almacén de datos de Google Drive, sigue estos pasos:
En la consola de Google Google Cloud , ve a la página Gemini Enterprise.
Selecciona o crea un proyecto de Google Cloud .
En el menú de navegación, haz clic en Almacenes de datos.
Haz clic en Crear almacén de datos.
En la sección Fuente, busca Google Drive y haz clic en Seleccionar.
Opcional: En la sección Datos, configura filtros que definan el alcance del contenido de Google Drive en el que busca el almacén de datos. Para configurar filtros con la consola de Google Cloud o la API de REST, selecciona una de las siguientes opciones:
Console
- En el campo IDs de unidades compartidas, en el campo IDs de carpetas o en ambos, ingresa los IDs por los que quieres filtrar.
- Para cada campo, elige Incluir para buscar solo los IDs especificados o Excluir para omitirlos de la búsqueda. Configura el modo Incluir o Excluir para cada campo, pero no ambos.
- Para ubicar el ID de una carpeta o de una unidad compartida, abre la carpeta o la unidad compartida
en Google Drive y copia el ID de la URL. La URL
sigue este formato:
https://drive.google.com/drive/folders/ID. Por ejemplo:https://drive.google.com/drive/folders/123456789012345678901
API de REST
Para crear un almacén de datos con filtros, llama al método
setUpDataConnector.Las listas de inclusión se configuran en
admin_filtery las listas de exclusión, enadmin_exclusion_filter. Para cada tipo de filtro, completa la lista enadmin_filtero enadmin_exclusion_filter, pero no en ambos.curl -X POST \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ -H "Content-Type: application/json" \ -H "X-Goog-User-Project: PROJECT_ID" \ "https://ENDPOINT_LOCATION-discoveryengine.googleapis.com/v1alpha/projects/PROJECT_ID/locations/LOCATION:setUpDataConnector" \ -d '{ "collectionId": "COLLECTION_ID", "collectionDisplayName": "COLLECTION_DISPLAY_NAME", "dataConnector": { "dataSource": "google_drive", "params": { "FILTER_TYPE": { "FILTER_KEY": [ "FILTER_VALUE_1", "FILTER_VALUE_2" ] } }, "entities": [ { "entityName": "google_drive" } ], "connectorModes": [ "FEDERATED" ] } }'
Reemplaza lo siguiente:
-
PROJECT_ID: el ID de tu proyecto. -
ENDPOINT_LOCATION: Es la multirregión para tu solicitud a la API. Especifica uno de los siguientes valores:uspara la multirregión de EE.UU.eupara la multirregión de la UEglobalpara la ubicación global
-
LOCATION: Es la multirregión de tu almacén de datos:globalous. -
COLLECTION_ID: Es el ID único del almacén de datos. -
COLLECTION_DISPLAY_NAME: Es el nombre visible del almacén de datos. -
FILTER_TYPE: Es el tipo de filtro, ya seaadmin_filterpara la inclusión oadmin_exclusion_filterpara la exclusión. Completa la lista enadmin_filtero enadmin_exclusion_filter, pero no en ambos. -
FILTER_KEY: Es la entidad de Drive por la que se filtrará, ya seaSharedDriveIdsoFolderIds. -
FILTER_VALUE_1,FILTER_VALUE_2: Son los IDs de unidades compartidas o IDs de carpetas por los que se filtrará.
En la sección Acciones, elige las acciones de la lista para habilitarlas en el conector de Google Drive.
Para administrar la lista de acciones, consulta Administra acciones.
Haz clic en Continuar.
En la sección Configuración, haz lo siguiente:
- En la lista Multirregional, selecciona la ubicación de tu conector de datos.
- En el campo Nombre del conector de datos, ingresa un nombre para tu conector.
- Si seleccionaste
usoeucomo ubicación, configura los parámetros de configuración de encriptación:- Selecciona Clave de encriptación administrada porGoogle o Clave de Cloud KMS.
- Si seleccionaste Clave de Cloud KMS, haz lo siguiente:
- En la lista Tipo de administración de claves, selecciona el tipo adecuado.
- En la lista Clave de Cloud KMS, selecciona la clave.
Opcional: En el campo Etiqueta, ingresa un identificador estable para el almacén de datos. Este identificador se usa en diferentes versiones del conector y se vuelve inmutable después de que se crea el almacén de datos, por lo que debes elegir un valor que no necesites cambiar más adelante.
Opcional: En la sección Política de Sensitive Data Protection, adjunta una política de contenido de Sensitive Data Protection existente para inspeccionar y bloquear los datos sensibles que Gemini Enterprise recupera a través de este almacén de datos. Para obtener más información, consulta Protege los datos sensibles en las fuentes. Si tu organización no requiere una política de contenido de Sensitive Data Protection, puedes omitir este paso.
Haz clic en Crear. Gemini Enterprise crea tu almacén de datos y lo muestra en la página Almacenes de datos.
Para verificar el estado del almacén de datos, comprueba lo siguiente:
- Navega al conector en la lista de almacén de datos y supervisa su estado hasta que cambie a Activo.
- Cuando el estado del almacén de datos cambia de Creando a Activo, el conector de Google Drive está listo para usarse.
Después de crear el almacén de datos, crea una app y conéctala al almacén de datos de Google Drive antes de ejecutar la consulta.
Ejecución de las consultas
Después de autorizar Google Drive, cuando ingreses una búsqueda, ocurrirá lo siguiente:
Gemini Enterprise envía tu búsqueda a la API de Google Drive.
Gemini Enterprise combina los resultados con los de otras fuentes y los muestra.
Mensajes de error y solución de problemas
En la siguiente tabla, se describen los mensajes de error, incluidos los códigos de error de HTTP y los pasos sugeridos para la solución de problemas, que puedes encontrar cuando trabajas con esta fuente de datos de Google .
| Código de error | Mensaje de error | Descripción | Soluciona problemas |
|---|---|---|---|
| 403 Permiso denegado | La búsqueda con credenciales de cuentas de servicio no es compatible con los almacenes de datos de Google Workspace. | El motor en el que se realiza la búsqueda tiene almacenes de datos de Google Workspace, y las credenciales que se pasan son de una cuenta de servicio. No se admite la búsqueda con credenciales de cuentas de servicio en los almacenes de datos de Google Workspace. | Llama a la búsqueda con las credenciales del usuario o quita los almacenes de datos de Google Workspace del motor. |
| 403 Permiso denegado | Las cuentas personales no son compatibles con los almacenes de datos de Google Workspace. | La búsqueda se llama con una credencial de cuenta personal (@gmail.com), que no es compatible con los almacenes de datos de Google Workspace. | Quita los almacenes de datos de Google Workspace del motor o usa una cuenta administrada de Google . |
| 403 Permiso denegado | No coincide el ID de cliente para el almacén de datos | La búsqueda solo se permite para los usuarios cuyo ID de cliente de Google Workspace coincida con la organización del almacén de datos de Google Workspace y el proyecto de Google Cloud , a menos que el ID de cliente de Google Workspace del usuario esté en la lista de entidades permitidas del proyecto. | Si la discrepancia no es intencional, vuelve a crear el almacén de datos en un proyecto de Google Cloud que pertenezca a la misma organización que tus usuarios de Google Workspace o quita el almacén de datos de Google Workspace de la app. Si los usuarios y el almacén de datos de Google Workspace deben estar en organizaciones diferentes, comunícate con la Atención al cliente de Cloud para agregar el ID de cliente de Google Workspace de cada usuario a la lista de entidades permitidas de tu proyecto de Google Cloud , asegúrate de que un administrador de Google Workspace en cada organización de usuarios habilite el acceso de Gemini Enterprise a los datos de Google Workspace. Además, si los usuarios necesitan encontrar documentos que pertenecen a personas ajenas a su organización, habilita Incluir documentos de varios dominios en Administrar funciones de la app web. |
| 403 Permiso denegado | El administrador de la organización inhabilitó el acceso de Workspace para Agentspace. | Un administrador de Google Workspace de la organización de Google Workspace del usuario inhabilitó el acceso a los datos de Google Workspace para Gemini Enterprise. En la app web de Gemini Enterprise, es posible que este error no se muestre directamente. En su lugar, las consultas no devuelven archivos de Google Drive que coincidan. | Comunícate con el administrador de Google Workspace de la organización de Google Workspace del usuario para habilitar el acceso. En las configuraciones entre organizaciones, este parámetro se debe habilitar en la Consola del administrador de Google de cada organización de Google Workspace cuyos usuarios consulten Google Drive. |
| 400 Argumento no válido | La solicitud contiene un argumento no válido. | Este error se produce si el nombre del conector de datos en la solicitud no cumple con los requisitos de nomenclatura. Verifica el nombre del conector de datos y asegúrate de que tenga entre 1 y 63 caracteres, comience con una letra minúscula, termine con una letra minúscula o un dígito, y solo contenga letras minúsculas, dígitos, guiones o guiones bajos. Por ejemplo, usa un nombre como cymbal-collection-123456789 en lugar de 123456789-cymbal-collection. |
|
Si tienes problemas de búsqueda habituales cuando consultas tus datos de Google Drive, consulta Problemas de búsqueda habituales.
¿Qué sigue?
- Para proporcionar una interfaz de usuario para consultar tus datos, crea una app y conéctala al almacén de datos de Google Drive.
- Para agregar o actualizar filtros de carpetas y unidades compartidas en tu almacén de datos, consulta Agrega filtros a un almacén de datos de Google Drive.
- Para obtener una vista previa de cómo aparecerán los resultados de la búsqueda después de configurar tu app, consulta Cómo obtener resultados de la búsqueda.
- Para habilitar las alertas del almacén de datos, consulta Configura alertas para almacenes de datos de terceros.
- Si tu app no se configuró inicialmente para incluir documentos de varios dominios, habilita la función Incluir documentos de varios dominios en la configuración para administrar funciones de la app web. Para obtener más información, consulta Administra las funciones de la app web.