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ê pretende conectar. O Gemini Enterprise usa seu ID de cliente do Google Workspace para se conectar ao Google Chat. As Contas do Google pessoais (contas de consumidor que terminam em @gmail.com) não têm um ID de cliente e não são aceitas.

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

  • Ative os recursos inteligentes: na sua conta do Google Workspace, ative os Recursos inteligentes no Google Workspace e os Recursos inteligentes em outros Google produtos. Para mais detalhes, consulte Ativar ou desativar os recursos inteligentes do Google Workspace.

  • Adicione o app OAuth à lista de permissões (somente administradores): o repositório de dados do Google Chat usa um app OAuth gerenciado pelo Googlepara acessar seus dados. Se sua organização restringir o acesso ao app OAuth, o administrador do Google Workspace precisará adicionar esse app à lista de permissões da organização. Para mais detalhes, consulte Adicionar o app OAuth gerenciado pelo Googleà lista de permissões.

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 Ações, escolha as ações na lista para ativá-las no conector do Google Chat.

    Para gerenciar a lista de ações, consulte Gerenciar ações.

  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. Opcional: na seção Política de Proteção de Dados Sensíveis, anexe uma política de Proteção de Dados Sensíveis para inspecionar e desidentificar os dados que o Gemini Enterprise recupera nesse repositório de dados. Se sua organização não exigir uma política de Proteção de Dados Sensíveis, pule esta etapa.

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