Conexão Google Gemini no Jitterbit Studio
Introdução
Uma conexão Google Gemini, criada usando o conector Google Gemini, estabelece acesso ao Google Gemini. Após configurar uma conexão, você pode criar instâncias de atividades Google Gemini associadas a essa conexão para serem usadas como fontes (para fornecer dados em uma operação) ou como destinos (para consumir dados em uma operação).
Criar ou editar uma conexão Google Gemini
Uma nova conexão Google Gemini é criada usando o conector Google Gemini em um destes locais:
- A aba Project endpoints and connectors (Endpoints e conectores de projeto) da paleta de componentes de design (consulte Paleta de componentes de design).
- A página Global Endpoints (Endpoints globais) (consulte Criar um endpoint global em Global Endpoints).
Uma conexão Google Gemini existente pode ser editada nestes locais:
- A aba Project endpoints and connectors (Endpoints e conectores de projeto) da paleta de componentes de design (consulte Paleta de componentes de design).
- A aba Components (Componentes) do painel do projeto (consulte Menu de ações de componentes em Aba Components do painel do projeto).
- A página Global Endpoints (Endpoints globais) (consulte Editar um endpoint global em Global Endpoints).
Configurar uma conexão Google Gemini
Cada elemento da interface do usuário da tela de configuração da conexão Google Gemini é descrito abaixo.
Dica
Campos com um ícone de variável permitem usar variáveis globais, variáveis de projeto e variáveis Jitterbit. Comece digitando um colchete de abertura [ no campo ou clicando no ícone de variável para exibir uma lista das variáveis existentes para escolher.
-
Nome da conexão: Digite um nome para identificar a conexão. O nome deve ser único para cada conexão Google Gemini e não deve conter barras
/ou dois-pontos:. Este nome também é usado para identificar o endpoint Google Gemini, que se refere a uma conexão específica e suas atividades. -
Plataforma: Selecione a plataforma Google Gemini para conectar, AI Studio ou Vertex AI.
-
AI Studio: Selecione esta opção para conectar ao Google AI Studio. Quando esta opção é selecionada, este campo fica visível:
- Chave de API: Digite sua chave de API do Gemini.
-
Vertex AI: Selecione esta opção para conectar à Plataforma Gemini Enterprise Agent (anteriormente conhecida como Vertex AI). Quando esta opção é selecionada, estes campos ficam visíveis:
-
ID do projeto: Digite o
project_idfornecido pelo arquivo JSON de credenciais da conta de serviço. -
Local: Digite a região do Google Cloud onde seus recursos da Plataforma Gemini Enterprise Agent estão hospedados (por exemplo,
us-central1). -
Email do cliente: Digite o
client_emailfornecido pelo arquivo JSON de credenciais da conta de serviço. -
Sequência de chave privada: Digite a
private_keyfornecida pelo arquivo JSON de credenciais da conta de serviço. A chave privada deve ser inserida neste formato:
-
-
-----BEGIN PRIVATE KEY-----
<private_key>
-----END PRIVATE KEY-----
Nota
Todos os caracteres de quebra de linha (\n) presentes na string private_key devem ser substituídos por um retorno de carro no campo Cadeia de chaves privadas. Caso contrário, ocorrerá um erro ao testar a conexão.
-
Armazenar contexto de chat entre operações: Clique para ativar a memória de curto prazo que armazena o contexto de chat além do escopo de uma única operação.
Importante
Ativar essa configuração armazena o contexto de chat entre cadeias de operações apenas para grupos de agentes na nuvem. Agentes privados sempre armazenam o contexto de chat na memória para operações dentro da mesma cadeia de operações que compartilham o mesmo
chatId, independentemente dessa configuração.Quando ativado, as seguintes configurações adicionais são exibidas:
-
Chat context TTL: Insira o tempo de retenção do contexto de chat na memória de curto prazo em segundos. O valor padrão é
86400segundos (1 dia). -
Máximo de mensagens salvas no contexto: Insira o número máximo de mensagens a serem salvas no contexto de chat da memória de curto prazo. O valor padrão e mínimo é
10mensagens. -
Quando o contexto de chat não for encontrado: Selecione a ação a executar se o contexto de chat não for encontrado na memória de curto prazo:
-
Criar um novo contexto: (Padrão.) Um novo contexto de chat é criado.
-
Falhar na solicitação: A solicitação falha.
-
-
-
Configurações opcionais: Clique para expandir configurações opcionais adicionais:
-
Tempo limite: Insira o valor do tempo limite em segundos.
-
Usar configurações de proxy (apenas agente privado): Ao usar um agente privado, essa configuração pode ser selecionada para usar configurações de proxy do agente privado.
-
-
Testar: Clique para verificar a conexão usando a configuração especificada. Quando a conexão é testada, a versão mais recente do conector é baixada pelo(s) agente(s) no grupo de agentes associado ao ambiente atual. Este conector oferece suporte à suspensão do download da versão mais recente do conector usando a política organizacional Desabilitar atualização automática de conector.
-
Salvar: Clique para salvar e fechar a configuração de conexão.
-
Descartar alterações: Após fazer alterações em uma configuração nova ou existente, clique para fechar a configuração sem salvar. Uma mensagem pede confirmação de que você deseja descartar as alterações.
-
Excluir: Após abrir uma configuração de conexão existente, clique para excluir permanentemente a conexão do projeto e fechar a configuração (consulte Dependências de componentes, exclusão e remoção). Uma mensagem pede confirmação de que você deseja excluir a conexão.
Próximas etapas
Depois de criar uma conexão Google Gemini, coloque um tipo de atividade na tela de design para criar instâncias de atividade a serem usadas como fontes (para fornecer dados em uma operação) ou como destinos (para consumir dados em uma operação).
As ações de menu para uma conexão e seus tipos de atividade são acessíveis no painel de projeto e na paleta de componentes de design. Para obter detalhes, consulte Menus de ações em Noções básicas de conector.
Estes tipos de atividade estão disponíveis:
-
Registrar ferramentas: Registra funções (ferramentas) no modelo especificado no Google Gemini e deve ser usado como destino em uma operação.
-
Prompt: Envia um prompt para o modelo especificado no Google Gemini e deve ser usado como destino em uma operação.