Conecte ferramentas ao AI Agent

Uma ferramenta permite ao AI Agent consultar informações ou executar uma ação fora do modelo. Você conecta o Node ao conector de ferramentas do agente. O modelo avalia as ferramentas disponíveis e escolhe qual chamar conforme a mensagem recebida e as instruções configuradas.

Escolha a ferramenta pela função

O n8n oferece ferramentas para diferentes necessidades. Calculator executa cálculos. Call n8n Workflow Tool chama um workflow. HTTP Request pode funcionar como ferramenta para consultar uma API. O MCP Client Tool conecta o agente às ferramentas publicadas por um servidor MCP externo.

Descreva a finalidade da ferramenta quando a configuração oferecer esse campo. Em um exercício de consulta de catálogo, informe qual catálogo ela consulta e quais informações retorna. Informe, por exemplo, que a consulta retorna o nome e a disponibilidade de um item do catálogo.

Separe valores fixos de argumentos do modelo

Configure você mesmo os campos conhecidos do serviço. Nos parâmetros compatíveis que dependem da conversa, o n8n permite usar o botão de preenchimento por IA ou a função $fromAI().

O exemplo abaixo orienta o modelo a preencher um identificador textual:

1
{{ $fromAI('produto', 'Identificador do produto citado na conversa', 'string') }}

A chave produto funciona como orientação para o modelo. Ela não referencia automaticamente um campo existente no JSON. Se o valor já veio confirmado de um Node anterior, use a expressão que aponta para esse campo.

A função $fromAI() serve aos parâmetros de ferramentas conectadas ao agente. Ela não funciona no Custom Code Tool nem nos outros sub-Nodes que não são ferramentas.

Examine uma chamada completa

Ative Return Intermediate Steps no Tools Agent durante o exercício. Envie uma mensagem que exija a consulta e confira os argumentos, o retorno da ferramenta e a resposta final.

Se o agente escolheu a ferramenta errada, revise a descrição e a instrução. Se escolheu corretamente, mas enviou um identificador incorreto, confira o parâmetro preenchido pelo modelo antes de alterar a integração.

Revise ações que alteram sistemas

O Tools Agent permite inserir uma etapa de Human review antes de ferramentas específicas. No painel de ferramentas, escolha o canal de aprovação e conecte as ferramentas que precisam dessa revisão. Quando houver uma chamada, o workflow aguarda aprovação ou rejeição antes de executar a ação correspondente.