Configurar um repositório de dados do Gmail

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

Antes de começar

  • Faça login no console Google Cloud com a mesma conta usada na instância do Google Workspace que você planeja conectar. O Gemini Enterprise usa seu ID de cliente do Google Workspace para se conectar ao Gmail. 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 Gmail usa um Googleapp OAuth gerenciado pelo para 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 Gmail

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

  1. No console do Google Google Cloud , acesse a página do 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 Gmail e clique em Selecionar.

  6. Na seção Ações, escolha as ações na lista para ativá-las no conector do Gmail.

    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. Se o fluxo de criação do repositório de dados mostrar uma seção Opções avançadas, você poderá marcar a caixa de seleção Ativar endereços IP estáticos nela. Isso garante que o repositório de dados use um conjunto fixo de endereços IP para tráfego de saída, adequado para a lista de permissões no sistema de origem. Para mais informações, consulte Configurar a saída de IP estático.

  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 loja para conferir o status. Quando o estado do repositório de dados mudar de Criação para Ativo, o conector do Gmail estará pronto para uso.

Depois de criar o repositório de dados, crie um app e conecte-o ao repositório de dados do Gmail antes de executar a 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 Gmail e enviar uma consulta de pesquisa para o Gemini Enterprise:

  • O Gemini Enterprise envia sua consulta de pesquisa diretamente para a API Gmail.
  • 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 Gmail, 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