Configura un almacén de datos de Gmail

En esta página, se describe cómo crear un almacén de datos y conectar Gmail a Gemini Enterprise.

Antes de comenzar

  • Accede a la consola de Google Cloud con la misma cuenta que usas para la instancia de Google Workspace que planeas conectar. Gemini Enterprise usa tu ID de cliente de Google Workspace para conectarse a Gmail. 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.

  • 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 Cómo activar o desactivar las funciones inteligentes de Google Workspace.

  • Incluye en la lista de entidades permitidas la app de OAuth (solo para administradores): El almacén de datos de Gmail usa una app de OAuth administrada por Googlepara acceder a tus datos. Si tu organización restringe el acceso a las apps de OAuth, el administrador de Google Workspace debe agregar esta app a la lista de entidades permitidas de la organización. Para obtener más información, consulta Cómo agregar a la lista de entidades permitidas la app de OAuth administrada por Google.

Crea el almacén de datos de Gmail

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

  1. En la consola de Google Cloud Google Cloud, ve a la página de 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 Fuente, busca Google Mail y haz clic en Seleccionar.

  6. En la sección Acciones, elige las acciones de la lista para habilitarlas en el conector de Gmail.

    Para administrar la lista de acciones, consulta Administra acciones.

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

  10. Opcional: En la sección Política de Sensitive Data Protection, adjunta una política de Sensitive Data Protection existente para inspeccionar y desidentificar los datos que Gemini Enterprise recupera a través de este almacén de datos. Si tu organización no requiere una política de Sensitive Data Protection, puedes omitir este paso.

  11. Haz clic en Crear. Gemini Enterprise crea tu almacén de datos y lo muestra en la página Almacenes de datos.

En la página Almacenes de datos, haz clic en el nombre del almacén de datos para ver el estado. Cuando el estado del almacén de datos cambia de Creando a Activo, el conector de Gmail 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 Gmail antes de ejecutar la consulta.

Ejecución de las consultas

En esta sección, se describe cómo Gemini Enterprise administra tu búsqueda y las implicaciones de privacidad del uso del almacén de datos federado.

Después de autorizar Gmail y enviar una búsqueda a Gemini Enterprise, ocurrirá lo siguiente:

  • Gemini Enterprise envía tu búsqueda directamente a la API de Gmail.
  • Gemini Enterprise combina los resultados con los de otras fuentes de datos conectadas y muestra un resultado de búsqueda integral.

Mensajes de error y solución de problemas

En la siguiente tabla, se describen los mensajes de error comunes que puedes encontrar cuando trabajas con el conector de Gmail, incluidos los posibles códigos de error de HTTP y los pasos sugeridos para la solución de problemas.

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 de Google administrada.
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 Agent Space. 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.

¿Qué sigue?