Ir para o conteúdo

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. Uma vez que uma conexão é configurada, é possível criar instâncias de atividades do Google Gemini associadas a essa conexão para serem usadas como fontes (para fornecer dados em uma operação) ou como alvos (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 a partir de uma destas localizações:

Uma conexão Google Gemini existente pode ser editada a partir destas localizações:

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 suportam o uso de variáveis globais, variáveis de projeto, e variáveis Jitterbit. Comece digitando um colchete aberto [ no campo ou clicando no ícone de variável para exibir uma lista das variáveis existentes para escolher.

  • Nome da conexão: Insira um nome para identificar a conexão. O nome deve ser exclusivo para cada conexão do Google Gemini e não deve conter barras / ou dois pontos :. Este nome também é usado para identificar o endpoint do Google Gemini, que se refere tanto a uma conexão específica quanto às suas atividades.

  • Plataforma: Selecione a plataforma do Google Gemini para se conectar, seja AI Studio ou Vertex AI.

    • AI Studio: Selecione esta opção para se conectar ao Google AI Studio. Quando esta opção é selecionada, este campo fica visível:

    • Vertex AI: Selecione esta opção para se conectar à Plataforma de Agente Empresarial do Gemini (anteriormente conhecida como Vertex AI). Quando esta opção é selecionada, estes campos ficam visíveis:

      • ID do projeto: Insira o project_id fornecido pelo arquivo JSON das credenciais da conta de serviço.

      • Localização: Insira a região do Google Cloud onde seus recursos da Plataforma de Agente Empresarial do Gemini estão hospedados (por exemplo, us-central1).

      • Email do cliente: Insira o client_email fornecido pelo arquivo JSON das credenciais da conta de serviço.

      • String da chave privada: Insira a private_key fornecida pelo arquivo JSON das 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 nova linha (\n) presentes na string private_key devem ser substituídos por um retorno de carro no campo String da chave privada. Caso contrário, um erro ocorrerá ao testar a conexão.

  • 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, esta configuração pode ser selecionada para usar as 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 suporta suspender o download da versão mais recente do conector usando a política de organização Desativar Atualização Automática do Conector.

  • Salvar: Clique para salvar e fechar a configuração da 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 solicita que você confirme que 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 (veja Dependências de componentes, exclusão e remoção). Uma mensagem solicita que você confirme que deseja excluir a conexão.

Próximas etapas

Após a criação de uma conexão do Google Gemini, você coloca um tipo de atividade na tela de design para criar instâncias de atividade que serão usadas como fontes (para fornecer dados em uma operação) ou como alvos (para consumir dados em uma operação).

As ações do menu para uma conexão e seus tipos de atividade estão acessíveis no painel do projeto e na paleta de componentes de design. Para detalhes, veja Menus de ações em Conceitos Básicos do Conector.

Estes tipos de atividade estão disponíveis:

  • Registrar Ferramentas: Registra funções (ferramentas) no modelo especificado no Google Gemini e é destinado a ser usado como um alvo em uma operação.

  • Prompt: Envia um prompt para o modelo especificado no Google Gemini e é destinado a ser usado como um alvo em uma operação.