Tools no AI Agent do n8n: dando mãos de verdade ao seu agente

Consequência direta: ferramenta com descrição vaga não é usada. Ferramenta com descrição ampla demais é usada onde não deveria.

A boa descrição diz o que faz e quando usar. A segunda parte é a que quase todo mundo esquece.

O impacto é grande. Tudo que você já sabe montar — consultar banco, chamar API com autenticação, ler planilha, gravar registro — vira capacidade do agente sem precisar de nada novo. Você monta o fluxo normalmente, com toda a lógica e tratamento de erro, e o expõe como ferramenta.

É também a forma mais segura de dar poder ao agente: ele não escolhe como fazer, só decide quando chamar. A execução segue o caminho que você desenhou.

2. HTTP Request Tool

Deixa o agente chamar uma API ou buscar uma página. Útil quando a informação está numa fonte externa simples e não vale construir um fluxo inteiro.

3. Custom Code Tool

Permite escrever código que o agente pode executar. Serve para cálculos e transformações específicas que não existem prontas.

Sem ela, você precisaria fixar os valores ou criar uma ferramenta para cada variação. Com ela, você declara que aquele campo será preenchido pelo agente conforme a conversa — o CPF que o cliente informou, a data que ele mencionou, o produto que ele citou.

Ao usar parâmetros dinâmicos, valide o que chegou antes de executar a ação. O agente pode preencher com algo malformado, e uma ferramenta que grava dados precisa se defender disso. Trate o valor vindo do modelo como entrada de usuário — porque, em última análise, é isso que ele é.

Uma regra que funciona bem: comece com o mínimo, observe onde ele falha por não ter capacidade, e acrescente só o que faltou. Agentes com quinze ferramentas costumam decidir pior que agentes com quatro.

Quando as ferramentas se multiplicarem, o caminho não é dar mais ao mesmo agente — é dividir em agentes especializados, assunto de outra aula.

Um fluxo que notifica uma pessoa e transfere a conversa, exposto como ferramenta com descrição clara — "use quando o cliente pedir atendente, reclamar, ou quando você não tiver certeza da resposta" —, resolve a maior fonte de reclamação em atendimento automatizado.

Sem essa saída, o agente insiste. E cliente preso num robô que insiste é pior que nenhum atendimento.

A descrição é o que faz o agente escolher: diga o que a ferramenta faz e quando usar. Prefira expor fluxos seus como ferramenta, valide parâmetros vindos do modelo e sempre inclua a saída para humano.