Configura un almacén de datos de Google Chat

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

Antes de comenzar

  • Accede a la Google Cloud consola de con la misma cuenta asociada con la instancia de Google Workspace que deseas conectar. Gemini Enterprise usa tu ID de cliente de Google Workspace para conectarse a Google Chat. Las Cuentas de Google personales (cuentas personales que terminan en @gmail.com) no tienen un ID de cliente y no son compatibles.

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

Crea el almacén de datos de Google Chat

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

  1. En la Google Cloud consola de, 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 Fuente, busca Google Chat y haz clic en Seleccionar.

  6. En la sección Datos , configura filtros para administrar el volumen, la relevancia y la privacidad de tus datos de chat indexados. Puedes agregar filtros al almacén de datos con la Google Cloud consola o la API de:

    Console

    1. En el campo Filtro de antigüedad de mensajes, ingresa la cantidad de días del historial de chat que se indexarán para los resultados de la búsqueda. Por ejemplo, si ingresas 90, te aseguras de que solo se puedan buscar los mensajes de los últimos 90 días, lo que filtra los datos más antiguos y menos relevantes.
    2. Selecciona la casilla de verificación Excluir mensajes directos para excluir todos los mensajes directos privados 1:1 de los resultados de la búsqueda. Cuando está habilitado, el conector de Google Chat solo indexa espacios multiusuario y chats grupales.

    REST

    Para agregar filtros cuando crees un almacén de datos, llama al método setUpDataConnector.

    

    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_chat",
          "params":{
            "admin_filter":{
              "MessageRecency":RECENCY_DAYS,
              "ExcludeDirectMessages":EXCLUDE_DMS
              }
            },
          "entities":[
            {
              "entityName":"google_chat"
            }],
            "connectorModes":[
              "FEDERATED"
              ]
        }
      }'

    Reemplaza lo siguiente:

    • PROJECT_ID: el ID de tu proyecto.
    • ENDPOINT_LOCATION: Es la región múltiple para tu solicitud a la API. Especifica uno de los siguientes valores:
      • us para la multirregión de EE.UU.
      • eu para la multirregión de la UE
      • global para la ubicación global
      Para obtener más información, consulta Cómo especificar una región múltiple para tu almacén de datos.
    • LOCATION: Es la multirregión de tu almacén de datos: global, us o eu.
    • COLLECTION_ID: Es el ID único del almacén de datos.
    • COLLECTION_DISPLAY_NAME: Es el nombre visible del almacén de datos.
    • EXCLUDE_DMS: Es un valor booleano (verdadero o falso).
    • RECENCY_DAYS: Es un número entero que representa el límite de antigüedad del mensaje. Por ejemplo, 90.

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

  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.

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 Google Chat está listo para usarse.

Después de crear el almacén de datos, conéctalo a una app existente o crea una app nueva y conéctala a ella, y autoriza a Gemini Enterprise para que acceda a Google Chat antes de ejecutar cualquier 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 Google Chat y enviar una búsqueda a Gemini Enterprise, ocurrirá lo siguiente:

  • Gemini Enterprise envía tu búsqueda directamente a la API de Google Chat.
  • 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 Google Chat, 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?