Configure um arquivo de dados do Gmail

Esta página descreve como criar um repositório de dados e associar o Gmail ao Gemini Enterprise.

Antes de começar

  • Inicie sessão na Google Cloud consola com a mesma conta que usa para a instância do Google Workspace que planeia associar. O Vertex AI Search usa o seu ID de cliente do Google Workspace para se ligar ao Gmail.

  • Para aplicar o controlo de acesso à origem de dados e proteger os dados no Gemini Enterprise, certifique-se de que configurou o seu fornecedor de identidade.

  • Antes de adicionar ações ao arquivo de dados do Gmail, um Google Cloud administrador tem de concluir primeiro os passos na secção Configure a autenticação e as autorizações para o Gmail para configurar a autenticação OAuth 2.0 de modo a fornecer-lhe o ID do cliente e o segredo do cliente, bem como configurar as autorizações mínimas.

Crie o arquivo de dados do Gmail

Para criar o arquivo de dados do Gmail, siga estes passos:

  1. Na consola Google Cloud Google, aceda à página do Gemini Enterprise.

    Gemini Enterprise

  2. Selecione ou crie um Google Cloud projeto.

  3. No menu de navegação, clique em Armazenamentos de dados.

  4. Clique em + Criar arquivo de dados.

  5. Em Origem, pesquise Gmail e clique em Selecionar.

  6. Na secção Ações:

    1. Introduza o ID de cliente e o segredo do cliente obtidos na aplicação OAuth 2.0 e, de seguida, clique em Validar autorização.

      Para obter informações sobre como obter o ID de cliente e o segredo do cliente, consulte o artigo Crie credenciais do cliente OAuth. Para os âmbitos necessários para a pesquisa e as ações, consulte Âmbitos necessários.

    2. Opcional: expanda as Definições avançadas e introduza o Nome do serviço, o nome do recurso do seu serviço criado no Service Directory. Este campo é obrigatório quando o VPC Service Controls está ativado.

    3. Escolha as ações na lista para as ativar para o conector do Gmail.

    Para ver a lista de ações, consulte o artigo Ver ações.

  7. Clique em Continuar.

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

    1. Na lista Várias regiões, selecione a localização do conetor de dados.
    2. No campo Nome do conetor de dados, introduza um nome para o conetor.
    3. Se selecionou US ou EU como a localização, configure as Definições de encriptação:
      • Selecione chave de encriptação gerida pelaGoogle ou chave do Cloud KMS.
      • Se selecionou Chave do Cloud KMS:
        • Na lista Tipo de gestão de chaves, selecione o tipo adequado.
        • Na lista Chave do Cloud KMS, selecione a chave.
      Para mais informações, consulte o artigo Chaves de encriptação geridas pelo cliente.

  9. Clique em Continuar.

  10. Na secção Faturação, selecione Preços gerais ou Preços configuráveis. Para mais informações, consulte os artigos Valide o estado de faturação dos seus projetos e Licenças.

  11. Clique em Criar. O Gemini Enterprise cria o seu arquivo de dados e apresenta os seus arquivos de dados na página Arquivos de dados.

Na página Armazenamentos de dados, clique no nome do armazenamento de dados para ver o estado. Quando o estado do arquivo de dados muda de A criar para Ativo, o conetor do Gmail está pronto a ser usado.

Depois de criar o arquivo de dados, crie uma app e associe-a ao arquivo de dados do Gmail antes de executar a consulta.

Execução de consultas

Esta secção descreve como o Gemini Enterprise gere a sua consulta e as implicações de privacidade da utilização do repositório de dados federado.

Depois de autorizar o Gmail e enviar uma consulta de pesquisa ao Gemini Enterprise:

  • O Gemini Enterprise envia a sua consulta de pesquisa diretamente para a API Gmail.
  • O Gemini Enterprise mistura os resultados com os de outras origens de dados ligadas e apresenta um resultado de pesquisa abrangente.

Mensagens de erro e resolução de problemas

A tabela seguinte descreve as mensagens de erro comuns que pode encontrar quando trabalha com o conector do Gmail, incluindo possíveis códigos de erro HTTP e passos de resolução de problemas sugeridos.

Código de erro Mensagem de erro Descrição Resolução de problemas
403 (Autorização recusada) A pesquisa através das credenciais da conta de serviço não é suportada para armazenamentos de dados do Google Workspace. O motor pesquisado tem arquivos de dados do Google Workspace e as credenciais transmitidas são de uma conta de serviço. A pesquisa através das credenciais da conta de serviço em arquivos de dados do Google Workspace não é suportada. Pesquisar chamadas através das credenciais do utilizador ou remover arquivos de dados do Google Workspace do motor.
403 (Autorização recusada) As contas de consumidor não são suportadas para arquivos de dados do Google Workspace. A pesquisa é chamada através de uma credencial de conta de consumidor (@gmail.com), que não é suportada para arquivos de dados do Google Workspace. Remova os arquivos de dados do Google Workspace do motor ou use uma Conta Google gerida.
403 (Autorização recusada) Falha de correspondência do ID de cliente para o armazenamento de dados A pesquisa só é permitida para utilizadores que pertencem à mesma organização que os armazenamentos de dados do Google Workspace. Remova os arquivos de dados do Google Workspace do motor ou contacte o apoio técnico se o utilizador e os arquivos de dados do Google Workspace se destinarem a estar em organizações diferentes.
403 (Autorização recusada) O acesso ao Workspace para o espaço de agentes foi desativado pelo administrador da organização. Um administrador do Google Workspace desativou o acesso aos dados do Google Workspace para o Gemini Enterprise. Contacte o seu administrador do Google Workspace para ativar o acesso.

O que se segue?