Ir para o conteúdo

Pré-requisitos da Plataforma Gemini Enterprise Agent (Vertex AI) para o conector Google Gemini no Jitterbit Studio

Introdução

Estes são os pré-requisitos para autenticar com o conector Google Gemini usando a opção de plataforma Vertex AI, que se conecta à Plataforma Gemini Enterprise Agent (anteriormente conhecida como Vertex AI).

Nota

O acesso ao Google Cloud Console e um projeto do Google Cloud são necessários para esta configuração.

Para conectar usando a opção de plataforma AI Studio em vez disso, gere uma chave de API do Gemini no Google AI Studio e insira-a na configuração de conexão.

Criar uma conta de serviço

Siga estas etapas para criar uma conta de serviço e conceder funções para fornecer acesso ao projeto do Google Cloud a ser usado com o conector Google Gemini:

  1. No Google Cloud Console, crie um projeto do Google Cloud ou selecione um projeto existente.

  2. Ative a API da Plataforma Agent para o projeto selecionado.

  3. No menu de navegação, vá para IAM & Admin > Contas de Serviço.

  4. Clique em Criar Conta de Serviço, localizado na parte superior da página.

  5. Insira os Detalhes da conta de serviço:

    • Nome da conta de serviço: Insira qualquer string para o nome da conta de serviço.

    • ID da conta de serviço: Este campo é preenchido automaticamente para corresponder ao Nome da conta de serviço e pode ser editado, se desejado.

    • Descrição da conta de serviço: Insira uma descrição para a conta de serviço.

  6. Clique em Criar e Continuar.

  7. Atribua um papel para permitir o acesso à Plataforma de Agentes Empresariais Gemini (necessário para uma conexão bem-sucedida no conector Google Gemini):

    • Papel: Usando o menu, selecione Usuário da Plataforma de Agentes (Usuário do Vertex AI) como o Papel (roles/aiplatform.user) para permitir o acesso à Plataforma de Agentes Empresariais Gemini, em seguida, clique em Continuar.

  8. Opcionalmente, conceda acesso à conta de serviço para usuários específicos.

  9. Clique em Concluído.

Obter credenciais da conta de serviço

Siga estas etapas para obter as credenciais necessárias para a configuração da conexão:

  1. Na página Contas de serviço, clique no menu Ações para a conta de serviço criada acima, em seguida, clique em Gerenciar chaves.

  2. Clique em Adicionar chave > Criar nova chave, selecione JSON como o Tipo de chave, e então clique em Criar para baixar o arquivo de chave JSON para o seu computador.

  3. Abra o arquivo JSON baixado em um editor de texto e retenha os valores de project_id, client_email e private_key para serem usados durante a configuração da conexão.

Habilitar corpora RAG

Para usar o recurso de corpus RAG na atividade Prompt, estes pré-requisitos adicionais se aplicam:

  • O Motor RAG deve estar habilitado para o seu projeto do Google Cloud.

  • Um ou mais corpora RAG devem já existir em seu projeto do Google Cloud antes que possam ser selecionados na configuração da atividade Prompt. Consulte Criar um corpus RAG na documentação da Plataforma de Agentes Empresariais Gemini para mais detalhes.

  • A conta de serviço deve ter o papel RAG Engine User (Usuário do Motor RAG do Vertex AI) (roles/aiplatform.ragEngineUser) atribuído, além do papel Agent Platform User atribuído acima, para acessar os corpora RAG.