Atividade Ollama Register Tools no Jitterbit Studio
Introdução
Uma atividade Register Tools do Ollama, usando sua conexão Ollama, registra ferramentas com o modelo Ollama especificado e destina-se a ser usada como fonte para fornecer dados em uma operação. As definições de ferramentas podem ser originadas da atividade List Tools do conector MCP Client ou fornecidas diretamente através da transformação de requisição como definições de ferramentas personalizadas.
Quando a operação é executada, o Jitterbit armazena as definições de ferramentas registradas na memória do agente privado, associadas à ID de conversa. Qualquer operação encadeada para ser executada após esta, que use a mesma ID de conversa, tem automaticamente acesso a essas ferramentas ao chamar o modelo. Não é necessário passar as definições de ferramentas explicitamente para a operação Prompt subsequente. Se uma ferramenta com o mesmo nome já estiver registrada para a ID de conversa, a nova definição a substitui. As ferramentas armazenadas e o histórico de conversa são limpos quando o agente é reiniciado.
Importante
Para usar a atividade Register Tools, você deve usar um agente privado.
Criar uma atividade Ollama Register Tools
Uma instância de uma atividade Register Tools do Ollama é criada a partir de uma conexão Ollama usando seu tipo de atividade Register Tools.
Para criar uma instância de uma atividade, arraste o tipo de atividade para a tela de design ou copie o tipo de atividade e cole-o na tela de design. Para detalhes, consulte Criando uma instância de atividade em Reutilização de componentes.
Uma atividade Register Tools do Ollama existente pode ser editada a partir destes locais:
- A tela de design (consulte Menu de ações de componente em Tela de design).
- A guia Componentes do painel do projeto (consulte Menu de ações de componente em Guia Componentes do painel do projeto).
Configurar uma atividade Ollama Register Tools
Siga estas etapas para configurar uma atividade Register Tools do Ollama:
-
Etapa 1: Informe um nome e especifique as configurações
Forneça um nome para a atividade, selecione um modelo e especifique um prompt e configurações opcionais. -
Etapa 2: Revise os esquemas de dados
Qualquer requisição ou esquema de resposta é exibido.
Etapa 1: Informe um nome e especifique as configurações
Nesta etapa, forneça um nome para a atividade, selecione um modelo e especifique um prompt e configurações opcionais. Cada elemento da interface do usuário desta etapa é 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 de abertura [ no campo ou clique no ícone de variável para exibir um menu listando as variáveis existentes para escolher.
-
Menu Endpoint: Se você tiver vários endpoints do mesmo tipo de conector configurados, um menu na parte superior da tela exibe o nome do endpoint atual. Clique no menu para mudar para um endpoint diferente. Para mais informações, consulte Alterar o endpoint atribuído em Telas de configuração.
- Editar endpoint: Aparece quando você passa o mouse sobre o nome do endpoint atual. Clique para editar a configuração de conexão do endpoint selecionado no momento.
-
Nome: Digite um nome para identificar a atividade. O nome deve ser único para cada atividade Ollama Register Tools e não pode conter barras
/ou dois-pontos:. -
Chat ID: Digite um chat ID para recuperar o contexto de uma conversa anterior. Se deixado em branco e não fornecido na transformação de solicitação, um novo chat ID é gerado e fornecido na resposta da atividade.
-
Escolher opção: Especifique o método de seleção de modelo, Listar todos os modelos ou Inserir identificador de modelo.
-
Listar todos os modelos: Selecione esta opção para escolher entre uma lista de modelos recuperados do endpoint Ollama:
-
Selecionar um modelo: Esta seção exibe os modelos disponíveis no endpoint Ollama. Apenas modelos que suportam chamadas de ferramentas são listados. Modelos DeepSeek são excluídos da lista.
-
Modelo selecionado: Após um modelo ser selecionado, ele aparece listado aqui.
-
Pesquisar: Digite o valor de qualquer coluna na caixa de pesquisa para filtrar a lista de modelos. A pesquisa não diferencia maiúsculas de minúsculas. Se os modelos já estiverem exibidos na tabela, os resultados são filtrados em tempo real a cada pressionamento de tecla. Para recarregar modelos do endpoint durante a pesquisa, digite os critérios de pesquisa e atualize conforme descrito abaixo.
-
Atualizar: Clique no ícone de atualização ou na palavra Atualizar para recarregar modelos do endpoint Ollama. Isso pode ser útil se modelos foram baixados para um servidor Ollama auto-hospedado. Esta ação atualiza todos os metadados usados para construir a tabela de modelos exibida na configuração.
-
Selecionando um modelo: Na tabela, clique em qualquer lugar de uma linha para selecionar um modelo. Apenas um modelo pode ser selecionado. As informações disponíveis para cada modelo são obtidas do endpoint Ollama:
-
Nome de exibição: O nome do modelo.
-
ID: O ID do modelo usado em solicitações da API, incluindo sua tag (por exemplo,
llama3.2:latest). -
Modificado: A data e hora em que o modelo foi modificado pela última vez.
-
Dica
Se a tabela não for preenchida com os modelos disponíveis, a conexão Ollama pode não ter sido bem-sucedida. Certifique-se de estar conectado reabrindo a conexão e testando novamente as credenciais. Para um servidor Ollama auto-hospedado, confirme também que pelo menos um modelo foi baixado para o servidor.
Como alternativa, o modelo pode ser especificado no campo Model ID ou fornecido na transformação de solicitação. Se um modelo for especificado em vários locais, esta ordem de precedência é seguida:
- Um modelo fornecido na transformação de solicitação substitui todos os campos abaixo.
- Um modelo especificado no campo Model ID substitui o campo restante abaixo, mesmo se Listar todos os modelos estiver selecionado.
- Um modelo selecionado na lista Selecionar um modelo tem a menor precedência.
-
-
-
Inserir identificador de modelo: Selecione esta opção para inserir manualmente o ID de um modelo:
- Model ID: Digite o ID do modelo (por exemplo,
llama3.2). Para Ollama Cloud, use um nome de modelo listado em modelos em nuvem do Ollama. Para um servidor auto-hospedado, o modelo já deve ter sido baixado para o servidor.
- Model ID: Digite o ID do modelo (por exemplo,
-
Prompt: Opcionalmente, digite um prompt para enviar ao modelo após as ferramentas serem registradas. Se um prompt for fornecido, o modelo poderá responder com chamadas de ferramentas, que são retornadas no campo
toolCallsda resposta da atividade. -
Configurações opcionais: Clique para expandir configurações opcionais adicionais:
-
Habilitar pensamento (modelos de raciocínio): Selecione para habilitar o pensamento, que permite que um modelo de raciocínio pense sobre um problema antes de gerar uma resposta. O raciocínio do modelo é retornado no campo
thinkingda resposta. Esta opção está desabilitada por padrão. Quando esta opção é desmarcada, o pensamento é desativado, inclusive para modelos que raciocinam por padrão.Nota
O pensamento é suportado apenas por modelos de raciocínio. Consulte a documentação de pensamento do Ollama para confirmar se o modelo selecionado suporta pensamento.
-
-
Manter modelo carregado: Selecione por quanto tempo o modelo permanece carregado na memória após a conclusão da solicitação (veja Como manter um modelo carregado na memória ou descarregá-lo imediatamente?). Manter um modelo carregado evita tempo de carregamento em solicitações subsequentes, mas continua usando memória no servidor Ollama:
- 5 minutos: (Padrão.) Mantém o modelo carregado por 5 minutos.
- 30 minutos: Mantém o modelo carregado por 30 minutos.
- 1 hora: Mantém o modelo carregado por 1 hora.
- Manter carregado indefinidamente: Mantém o modelo carregado até que o servidor Ollama seja reiniciado ou o modelo seja descarregado.
- Descarregar após cada chamada: Descarrega o modelo imediatamente após o retorno da resposta.
-
Aleatoriedade e diversidade:
- Temperature: Insira um parâmetro de temperature. Valores mais altos produzem respostas mais variadas, e valores mais baixos produzem respostas mais determinísticas. O valor deste parâmetro pode variar entre
0e2, por exemplo:0.8. - Top P: Insira um parâmetro Top P para amostragem por núcleo, que restringe a seleção de tokens ao menor conjunto de tokens cuja probabilidade cumulativa atinge este valor. O valor deste parâmetro pode variar entre
0e1, por exemplo:0.9. - Top K: Insira um parâmetro Top K, que restringe a seleção de tokens ao número especificado de tokens com maior probabilidade, por exemplo:
40. - Seed: Insira um parâmetro de seed. Usar o mesmo valor de seed com o mesmo prompt reproduz a mesma saída. Deixe este campo vazio para obter uma saída não determinística.
Quando um campo neste grupo está vazio, o valor padrão do modelo é usado.
- Temperature: Insira um parâmetro de temperature. Valores mais altos produzem respostas mais variadas, e valores mais baixos produzem respostas mais determinísticas. O valor deste parâmetro pode variar entre
-
Contexto e comprimento:
- Context Window: Insira o tamanho da janela de contexto em tokens, que limita o comprimento combinado do prompt, do histórico de conversa e da saída gerada. O padrão é
4096. O valor máximo depende do modelo selecionado e da memória disponível no servidor Ollama (veja Como especificar o tamanho da janela de contexto?). - Max Output Tokens: Insira o número máximo de tokens a gerar na resposta. O padrão é
2000. Insira-1para gerar sem limite.
- Context Window: Insira o tamanho da janela de contexto em tokens, que limita o comprimento combinado do prompt, do histórico de conversa e da saída gerada. O padrão é
-
Continuar em caso de erro: Selecione para retornar uma resposta com detalhes de erro em vez de falhar na atividade quando um erro ocorre. O erro é gravado no log de operação e retornado na matriz
errorsda resposta da atividade. -
Salvar e sair: Se ativado, clique para salvar a configuração desta etapa e fechar a configuração da atividade.
-
Próximo: Clique para armazenar temporariamente a configuração desta etapa e continuar para a próxima etapa. A configuração não será salva até que você clique no botão Concluído na última etapa.
-
Descartar alterações: Após fazer alterações, clique para fechar a configuração sem salvar as alterações feitas em nenhuma etapa. Uma mensagem solicita que você confirme que deseja descartar as alterações.
Etapa 2: Revise os esquemas de dados
Todos os esquemas de solicitação ou resposta são exibidos. Cada elemento da interface de usuário desta etapa é descrito abaixo.
-
Esquema de dados: Estes esquemas de dados são herdados por transformações adjacentes e são exibidos novamente durante o mapeamento de transformação.
Nota
Os dados fornecidos em uma transformação têm precedência sobre a configuração da atividade.
No esquema de solicitação, cada item na matriz
toolsdefine uma ferramenta com umname, umadescriptione uma matrizarguments. Cada argumento tem umname, umtype, umadescriptione um sinalizadorisRequired. Os camposnameedescriptionsão obrigatórios tanto para uma ferramenta quanto para seus argumentos.
O conector Ollama usa a API Ollama. Consulte a documentação do endpoint de chat para obter informações sobre os nós de esquema e campos.
-
Atualizar: Clique no ícone de atualização ou na palavra Atualizar para regenerar esquemas a partir do endpoint Ollama. Esta ação também regenera um esquema em outros locais do projeto onde o mesmo esquema é referenciado, como em uma transformação adjacente.
-
Voltar: Clique para armazenar temporariamente a configuração desta etapa e retornar à etapa anterior.
-
Concluído: Clique para salvar a configuração de todas as etapas e fechar a configuração da atividade.
-
Descartar alterações: Após fazer alterações, clique para fechar a configuração sem salvar as alterações feitas em nenhuma etapa. Uma mensagem solicita que você confirme que deseja descartar as alterações.
Próximas etapas
Após configurar uma atividade Register Tools do Ollama, conclua a configuração da operação adicionando e configurando outras atividades, transformações ou scripts como etapas da operação. Você também pode configurar as definições da operação, que incluem a capacidade de encadear operações que estão no mesmo fluxo de trabalho ou em fluxos de trabalho diferentes.
Para concluir um fluxo de trabalho de chamada de ferramenta, encadeie uma operação Prompt para ser executada após esta. Como o Jitterbit armazena as definições de ferramenta na memória do agente privado, a operação Prompt as recebe automaticamente sem mapeamento adicional necessário. Para vincular a operação Prompt a esta conversa, configure-a com o mesmo ID de chat ou capture o chatId da resposta Register Tools e passe-o para a atividade Prompt na transformação de solicitação.
As ações de menu de uma atividade são acessíveis a partir do painel de projeto e da tela de design. Para obter detalhes, consulte Menu de ações de atividade em Noções básicas do conector.
As atividades Register Tools do Ollama podem ser usadas como uma fonte com estes padrões de operação:
- Padrão de transformação
- Padrão de arquivo de dois destinos (apenas como primeira fonte)
- Padrão de arquivo HTTP de dois destinos (apenas como primeira fonte)
- Padrão de duas transformações (como primeira ou segunda fonte)
Para usar a atividade com funções de script, grave os dados em um local temporário e use esse local temporário na função de script.
Quando estiver pronto, implante e execute a operação e valide o comportamento verificando os logs de operação.