Configura un almacén de datos de Google Drive

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

  • 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.

  • 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 las funciones inteligentes de Google Workspace en otros productos de Google para conectar los datos de Google Drive a Gemini Enterprise. Para obtener más información, consulta Activa o desactiva las funciones inteligentes de Google Workspace.

Crea el almacén de datos de Google Drive

Para crear el almacén de datos de Google Drive, sigue estos pasos:

  1. En la consola de Google Google Cloud , ve a la página Gemini Enterprise.

    Gemini Enterprise

  2. Selecciona o crea un proyecto de Google Cloud .

  3. En el menú de navegación, haz clic en Almacenes de datos.

  4. Haz clic en Crear almacén de datos.

  5. En la sección Fuente, busca Google Drive y haz clic en Seleccionar.

  6. En la sección Datos, especifica la fuente de la unidad para tu almacén de datos. Puedes configurar filtros que definan el alcance del contenido de Google Drive que se indexa con la consola o la API de Google Cloud :

    Console

    1. Selecciona la fuente de Drive para tu almacén de datos:
      • Todo: Agrega todas las unidades del espacio de trabajo al almacén de datos.
      • Filtro de carpetas: Limita la búsqueda a un conjunto específico de carpetas. Elige Incluir para limitar la búsqueda solo a las carpetas de la lista o Excluir para quitar las carpetas de la lista de la búsqueda. Luego, agrega uno o más IDs de carpeta.
      • Filtro de unidades compartidas: Limita la búsqueda a un conjunto específico de unidades compartidas. Elige Incluir para limitar la búsqueda solo a las unidades compartidas de la lista o Excluir para quitar las unidades compartidas de la lista de la búsqueda. Luego, agrega uno o más IDs de unidades compartidas.
    2. Para cada tipo de filtro, configura el modo Incluir o el modo Excluir, pero no ambos.
    3. Para ubicar el ID de una carpeta o de una unidad compartida, navega a la carpeta o a la unidad compartida en Google Drive y copia el ID de la URL. La URL sigue este formato: https://drive.google.com/corp/drive/folders/ID. Por ejemplo, https://drive.google.com/corp/drive/folders/123456789012345678901

    REST

    Para crear un almacén de datos con filtros, llama al método setUpDataConnector.

    Las listas de inclusión se establecen en admin_filter y las listas de exclusión, en admin_exclusion_filter. Para cada tipo de filtro, completa la lista en admin_filter o en admin_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":{
             "admin_filter":{
               "SharedDriveIds": INCLUDED_SHARED_DRIVE_IDS,
               "FolderIds": INCLUDED_FOLDER_IDS
             },
             "admin_exclusion_filter":{
               "SharedDriveIds": EXCLUDED_SHARED_DRIVE_IDS,
               "FolderIds": EXCLUDED_FOLDER_IDS
             }
           },
           "entities":[
             {
               "entityName":"drive"
             }],
           "connectorModes":[
             "FEDERATED"
             ]
         }
       }'

    Reemplaza lo siguiente:

    • PROJECT_ID: ID del proyecto
    • ENDPOINT_LOCATION: Es la región de tu aplicación. Por ejemplo, us o eu.
    • LOCATION: Es la multirregión de tu almacén de datos: global o us.
    • COLLECTION_ID: Es el ID único del almacén de datos.
    • COLLECTION_DISPLAY_NAME: Es el nombre visible del almacén de datos.
    • INCLUDED_SHARED_DRIVE_IDS: Es una lista de IDs de unidades compartidas que se incluirán en la búsqueda, por ejemplo, ["0ABCdEfGhIjKlMnOpQ"]. Usa una lista vacía [] si no configuras una lista de inclusión para las unidades compartidas.
    • INCLUDED_FOLDER_IDS: Es una lista de IDs de carpetas para incluir en la búsqueda, por ejemplo, ["1AbCdEfGhIjKlMnOpQrStUvWxYz"]. Usa una lista vacía [] si no configuras una lista de inclusión para las carpetas.
    • EXCLUDED_SHARED_DRIVE_IDS: Es una lista de IDs de unidades compartidas que se excluirán de la búsqueda. Usa una lista vacía [] si no configuras una lista de exclusiones para las unidades compartidas.
    • EXCLUDED_FOLDER_IDS: Es una lista de IDs de carpetas que se excluirán de la búsqueda. Usa una lista vacía [] si no configuras una lista de exclusiones para las carpetas.

    Para obtener más detalles sobre los tipos de filtros y cómo agregarlos, consulta Agrega filtros a un almacén de datos de Google Drive.

  7. Haz clic en Continuar.

  8. En la sección Configuración, haz lo siguiente:

    1. En la lista Multirregional, selecciona la ubicación de tu conector de datos.
    2. En el campo Nombre del conector de datos, ingresa un nombre para tu conector.
    3. Si seleccionaste us o eu como 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.
      Para obtener más información, consulta Claves de encriptación administradas por el cliente.

  9. Haz clic en Continuar.

  10. En la sección Facturación, selecciona Precios generales o Precios configurables. Para obtener más información, consulta Verifica el estado de facturación de tus proyectos y Licencias.

  11. 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:

  1. Navega al conector en la lista de almacén de datos y supervisa su estado hasta que cambie a Activo.
  2. 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:

  1. Gemini Enterprise envía tu búsqueda a la API de Google Drive.

  2. 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 que pertenecen a la misma organización que los almacenes de datos de Google Workspace. Quita los almacenes de datos de Google Workspace del motor o comunícate con el equipo de asistencia si el usuario y los almacenes de datos de Google Workspace deben estar en organizaciones diferentes.
403 Permiso denegado El administrador de la organización inhabilitó el acceso de Workspace para Agentspace. Un administrador de Google Workspace inhabilitó el acceso a los datos de Google Workspace para Gemini Enterprise. Comunícate con tu administrador de Google Workspace para habilitar el acceso.
400, Invalid Argument 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?