Configurar un almacén de datos de Gmail

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

Antes de empezar

  • Inicia sesión en la Google Cloud consola con la misma cuenta que usas para la instancia de Google Workspace que quieres conectar. La búsqueda de Vertex AI usa tu ID de cliente de Google Workspace para conectarse a Gmail.

  • Para aplicar el control de acceso a las fuentes de datos y proteger los datos en Gemini Enterprise, asegúrate de haber configurado tu proveedor de identidades.

  • Antes de añadir acciones al almacén de datos de Gmail, un administrador debe completar los pasos de la sección Configurar la autenticación y los permisos de Gmail para configurar la autenticación OAuth 2.0, proporcionarte el ID y el secreto del cliente, y configurar los permisos mínimos. Google Cloud

Crear 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 Google Cloud , ve a la página de Gemini Enterprise.

    Gemini Enterprise

  2. Selecciona o crea un Google Cloud proyecto.

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

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

  5. En Origen, busca Gmail y haz clic en Seleccionar.

  6. En la sección Acciones:

    1. Introduce el ID de cliente y el secreto de cliente obtenidos de la aplicación OAuth 2.0 y, a continuación, haz clic en Verificar autenticación.

      Para obtener información sobre cómo obtener el ID y el secreto de cliente, consulta Crear credenciales de cliente de OAuth. Para ver los ámbitos necesarios para las búsquedas y las acciones, consulta Ámbitos necesarios.

    2. Opcional: Expande Configuración avanzada e introduce el Nombre del servicio, el nombre del recurso de tu servicio creado en Service Directory. Este campo es obligatorio cuando Controles de Servicio de VPC está habilitado.

    3. Elige las acciones de la lista para habilitarlas en el conector de Gmail.

    Para ver la lista de acciones, consulta Ver acciones.

  7. Haz clic en Continuar.

  8. En la sección Configuración:

    1. En la lista Multirregión, selecciona la ubicación del conector de datos.
    2. En el campo Nombre del conector de datos, escriba un nombre para el conector.
    3. Si has seleccionado US o EU como ubicación, configura los ajustes de cifrado:
      • Selecciona Clave de cifrado gestionada porGoogle o Clave de Cloud KMS.
      • Si has seleccionado Clave de Cloud KMS:
        • En la lista Tipo de gestió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 cifrado gestionadas por el cliente.

  9. Haz clic en Continuar.

  10. En la sección Facturación, seleccione Precios generales o Precios configurables. Para obtener más información, consulta Verificar 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.

En la página Data Stores (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 Creating (Creando) a Active (Activo), el conector de Gmail está listo para usarse.

Después de crear el almacén de datos, crea una aplicación y conéctala al almacén de datos de Gmail antes de ejecutar la consulta.

Ejecución de consultas

En esta sección se describe cómo gestiona Gemini Enterprise tu consulta y las implicaciones para la privacidad del uso del almacén de datos federado.

Después de autorizar Gmail y enviar una consulta de búsqueda a Gemini Enterprise:

  • Gemini Enterprise envía tu consulta de 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 completo.

Mensajes de error y solución de problemas

En la siguiente tabla se describen los mensajes de error habituales que pueden aparecer al trabajar con el conector de Gmail, incluidos los posibles códigos de error de HTTP y los pasos sugeridos para solucionar los problemas.

Código de error Mensaje de error Descripción Solución de problemas
403 (Permiso denegado) No se admite la búsqueda con credenciales de cuenta de servicio en 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 transferidas son de una cuenta de servicio. No se admite la búsqueda mediante credenciales de cuentas de servicio en almacenes de datos de Google Workspace. Llamar a la búsqueda con las credenciales de usuario o eliminar los almacenes de datos de Google Workspace del motor.
403 (Permiso denegado) Las cuentas de consumidor no se admiten en los almacenes de datos de Google Workspace. La búsqueda se llama con una credencial de cuenta de consumidor (@gmail.com), que no se admite en los almacenes de datos de Google Workspace. Quita los almacenes de datos de Google Workspace del motor o usa una cuenta de Google gestionada.
403 (Permiso denegado) El ID de cliente no coincide con el del almacén de datos Solo pueden realizar búsquedas los usuarios que pertenezcan a la misma organización que los almacenes de datos de Google Workspace. Quita los almacenes de datos de Google Workspace del motor o ponte en contacto 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 ha inhabilitado el acceso a Workspace para Agent Space. Un administrador de Google Workspace ha inhabilitado el acceso a los datos de Google Workspace para Gemini Enterprise. Ponte en contacto con tu administrador de Google Workspace para habilitar el acceso.

Siguientes pasos