Configurar um repositório de dados do Google Chat

Nesta página, descrevemos como criar um repositório de dados e conectar o Google Chat ao Gemini Enterprise.

Antes de começar

  • Faça login no Google Cloud console com a mesma conta associada à instância do Google Workspace que você quer conectar. O Gemini Enterprise usa seu ID de cliente do Google Workspace para se conectar ao Google Chat.

  • Para aplicar o controle de acesso à fonte de dados e proteger os dados no Gemini Enterprise, verifique se você configurou seu provedor de identidade.

Criar o repositório de dados do Google Chat

Para criar o repositório de dados do Google Chat, siga estas etapas:

  1. No Google Cloud console, acesse a página Gemini Enterprise.

    Gemini Enterprise

  2. Selecionar ou criar um projeto Google Cloud

  3. No menu de navegação, selecione Repositório de dados.

  4. Clique em + Criar repositório de dados.

  5. Em Origem, pesquise Google Chat e clique em Selecionar.

  6. Na seção Dados , configure filtros para gerenciar o volume, a relevância e a privacidade dos dados de chat indexados. É possível adicionar filtros ao repositório de dados usando o Google Cloud console ou a API:

    Console

    1. No campo Filtro de recência de mensagens, insira o número de dias do histórico de chat a serem indexados para resultados da pesquisa. Por exemplo, inserir 90 garante que apenas mensagens dos últimos 90 dias possam ser pesquisadas, filtrando dados mais antigos e menos relevantes.
    2. Marque a caixa de seleção Excluir mensagens diretas para excluir todas as mensagens diretas privadas 1:1 dos resultados da pesquisa. Quando ativado, o conector do Google Chat indexa apenas espaços multiusuários e chats em grupo.

    REST

    Para adicionar filtros ao criar um repositório de dados, chame o 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"
              ]
        }
      }'

    Substitua:

    • PROJECT_ID: ID do projeto.
    • ENDPOINT_LOCATION: a multirregião da sua solicitação de API. Especifique um dos seguintes valores:
      • us para a multirregião dos EUA
      • eu para a multirregião da UE
      • global para o local global
      Para mais informações, consulte Especificar uma multirregião para seu repositório de dados.
    • LOCATION: a multirregião do seu repositório de dados: global, us ou eu
    • COLLECTION_ID: o ID exclusivo do repositório de dados.
    • COLLECTION_DISPLAY_NAME: o nome de exibição do repositório de dados.
    • EXCLUDE_DMS: um valor booleano (verdadeiro ou falso).
    • RECENCY_DAYS: um número inteiro que representa o limite de idade da mensagem. Por exemplo, 90.

    Para mais detalhes sobre tipos de filtros e como adicionar filtros, consulte Adicionar filtros ao repositório de dados do Google Chat.

  7. Clique em Continuar.

  8. Na seção Configuração:

    1. Na lista Multirregional, selecione o local do conector de dados.
    2. No campo Nome do conector de dados, insira um nome para o conector.
    3. Se você selecionou us ou eu como o local, configure as Configurações de criptografia:
      • Selecione Chave de criptografia gerenciada peloGoogle ou Chave do Cloud KMS.
      • Se você selecionou Chave do Cloud KMS:
        • Na lista Tipo de gerenciamento de chaves, selecione o tipo adequado.
        • Na lista Chave do Cloud KMS, selecione a chave.
      Para mais informações, consulte Chaves de criptografia gerenciadas pelo cliente.

  9. Clique em Continuar.

  10. Na seção Faturamento, selecione Preços gerais ou Preços configuráveis. Para mais informações, consulte Verificar o status de faturamento dos seus projetos e Licenças.

  11. Clique em Criar. O Gemini Enterpriserise cria e exibe os repositórios de dados na página Repositórios de dados.

Na página Repositórios de dados, clique no nome da repositório de dados para conferir o status. Quando o estado do repositório de dados muda de Criação para Ativo, o conector do Google Chat está pronto para uso.

Depois de criar o repositório de dados, conecte-o a um app existente ou crie um novo app e conecte-o ao novo app. Autorize o Gemini Enterprise a acessar o Google Chat antes de executar qualquer consulta.

Execução da consulta

Esta seção descreve como o Gemini Enterprise gerencia sua consulta e as implicações de privacidade do uso do repositório de dados federado.

Depois de autorizar o Google Chat e enviar uma consulta de pesquisa para o Gemini Enterprise:

  • O Gemini Enterprise envia sua consulta de pesquisa diretamente para a API Google Chat.
  • O Gemini Enterprise combina os resultados com os de outras fontes de dados conectadas e mostra um resultado da pesquisa abrangente.

Mensagens de erro e solução de problemas

A tabela a seguir descreve as mensagens de erro comuns que podem aparecer ao trabalhar com o conector do Google Chat, incluindo possíveis códigos de erro de HTTP e etapas de solução de problemas sugeridas.

Código do erro Mensagem de erro Descrição Solução de problemas
403 (Permissão recusada) A pesquisa usando credenciais de conta de serviço não é compatível com repositórios de dados do Google Workspace. O mecanismo pesquisado tem repositórios de dados do Google Workspace, e as credenciais transmitidas são de uma conta de serviço. Não é possível pesquisar usando credenciais de conta de serviço em repositórios de dados do Google Workspace. Chame a pesquisa usando as credenciais do usuário ou remova os repositórios de dados do Google Workspace do mecanismo.
403 (Permissão recusada) As contas pessoais não são compatíveis com os repositórios de dados do Google Workspace. A pesquisa é chamada usando uma credencial de conta pessoal (@gmail.com), que não é compatível com repositórios de dados do Google Workspace. Remova os repositórios de dados do Google Workspace do mecanismo ou use uma Conta do Google gerenciada.
403 (Permissão recusada) Incompatibilidade de ID do cliente para o datastore A pesquisa só é permitida para usuários que pertencem à mesma organização que os repositórios de dados do Google Workspace. Remova os repositórios de dados do Google Workspace do mecanismo ou entre em contato com o suporte se o usuário e os repositórios de dados do Google Workspace precisarem estar em organizações diferentes.
403 (Permissão recusada) O acesso do Agent Space ao Workspace foi desativado pelo administrador da organização. Um administrador do Google Workspace desativou o acesso aos dados do Google Workspace para o Gemini Enterprise. Entre em contato com o administrador do Google Workspace para ativar o acesso.

A seguir