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. A Vertex AI para Pesquisa usa seu ID de cliente do Google Workspace para se conectar ao Gmail.

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

  • Antes de adicionar ações ao repositório de dados do Gmail, um administrador Google Cloud precisa concluir as etapas na seção Configurar autenticação e permissões para o Gmail para configurar a autenticação do OAuth 2.0 e fornecer o ID do cliente e a chave secreta do cliente, além de configurar as permissões mínimas.

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. Selecione ou crie um projeto do 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:

    1. Insira o ID do cliente e a chave secreta do cliente obtidos no aplicativo OAuth 2.0 e clique em Verificar autenticação.

      Para informações sobre como obter o ID do cliente e o segredo do cliente, consulte Criar credenciais do cliente OAuth. Para saber mais sobre os escopos necessários para pesquisa e ações, consulte Escopos necessários.

    2. Opcional: expanda Configurações avançadas e insira o Nome do serviço, o nome do recurso do serviço criado no Diretório de Serviços. Este campo é obrigatório quando o VPC Service Controls está ativado.

    3. Escolha as ações na lista para ativá-las no conector do Gmail.

    Para conferir a lista de ações, consulte Ver 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. 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 Enterprise 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 de consultas

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 de cliente para o repositório de dados 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 admin 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