O que é um agente de IA no n8n (e o que ele definitivamente não é)

Um agente de IA no n8n é, na definição da própria documentação, uma cadeia que sabe tomar decisões. Enquanto uma cadeia comum segue uma sequência predeterminada de chamadas, o agente usa um modelo de linguagem para decidir quais ações executar — inclusive quais ferramentas acionar e em que ordem. Essa diferença é tudo, e entender onde ela ajuda e onde atrapalha evita a maior parte dos projetos frustrados com IA.

Agente x cadeia: a distinção que importa

Um detalhe que sai direto da documentação e vale destacar: agentes podem usar memória; cadeias não podem. Se o seu caso exige lembrar da conversa anterior, a decisão já está tomada.

Ele roda mais de uma vez por execução

Este é o ponto que surpreende na primeira conta de custo. Quando um fluxo com agente executa, o agente roda várias vezes: uma passagem inicial de preparação, outra para chamar uma ferramenta, outra para avaliar a resposta dessa ferramenta e formular a resposta final.

Ou seja: uma pergunta do usuário pode significar quatro ou cinco chamadas ao modelo. Quem calcula o custo assumindo uma chamada por mensagem erra por um fator de três a cinco.

Antes de colocar um agente para atender clientes, faça a conta real: rode dez perguntas típicas e olhe quantas chamadas cada uma consumiu. É a única forma de estimar a fatura, e a diferença entre a estimativa ingênua e o valor real costuma assustar.

O que ele não é

Não é um sistema que sabe da sua empresa. O modelo conhece o mundo até a data em que foi treinado. Preço do seu produto, prazo do seu fornecedor, política interna — nada disso ele sabe. Fazer o agente conhecer isso exige entregar a informação, e é assunto de outra aula.

Não é determinístico. A mesma pergunta pode receber respostas diferentes. Para processo que exige resultado idêntico sempre — cálculo, validação, regra fixa —, agente é a ferramenta errada. Use lógica comum.

Não substitui tratamento de erro. Ele erra, e erra com confiança. Um agente que decide chamar a ferramenta errada segue em frente sem avisar ninguém.

Não é mais barato que código. Para tarefa com regra clara, uma condição no fluxo custa zero e acerta sempre. Agente para decidir se um número é maior que outro é desperdício em todos os sentidos.

Quando compensa

A pergunta que separa bem: eu consigo escrever a regra?

Se você consegue descrever "se acontecer isso, faça aquilo" para todos os casos, escreva a regra. É mais barato, mais rápido e sempre correto.

Agente compensa quando a entrada é imprevisível e a decisão exige interpretação:

• Atendimento em que o cliente escreve o que quiser, do jeito que quiser.

• Classificação de texto livre que não cabe numa lista de palavras-chave.

• Extração de informação de documentos com formatos variados.

• Tarefas em que a sequência correta de passos depende do que foi encontrado no caminho.

As três peças de um agente que funciona

Modelo. O cérebro. Modelos maiores decidem melhor e custam mais; para tarefas simples, um modelo pequeno resolve por uma fração do preço.

Ferramentas. As mãos. Sem elas, o agente só conversa. A documentação é categórica: é obrigatório conectar pelo menos uma ferramenta ao node de agente.

Instrução. O contrato. Define o que ele é, o que pode fazer, o que nunca deve fazer e quando deve passar para um humano. É a peça que mais determina a qualidade do resultado e a que mais gente escreve às pressas.

Agente é cadeia com decisão. Use quando a entrada for imprevisível, calcule o custo contando várias chamadas por pergunta e nunca use para tarefa cuja regra você consegue escrever.

Perguntas frequentes