Seu primeiro agente de IA no n8n: o node AI Agent na prática
Como montar um agente do zero no n8n, por que não existe mais escolha de tipo de agente e a instrução em quatro partes que evita invenção.
Resumo por IA
Resumo gerado por IA, revisado pela redação.
Montar o primeiro agente no n8n leva poucos minutos: você adiciona o node AI Agent, conecta um modelo de chat e pelo menos uma ferramenta. Um detalhe importante e recente: desde a versão 1.82.0 não existe mais escolha de tipo de agente — todos funcionam como Tools Agent, que era a opção recomendada. Se um tutorial manda você escolher entre tipos, ele está desatualizado.
Adicione ao Google NotíciasA anatomia do node
O AI Agent é o que a documentação chama de node raiz: ele não trabalha sozinho, precisa de sub-nodes conectados por baixo. Três conexões possíveis:
Modelo de chat — obrigatório. É o cérebro.
Ferramentas — pelo menos uma é obrigatória, segundo a documentação.
Memória — opcional, mas necessária se a conversa tiver mais de uma mensagem.
A exigência de pelo menos uma ferramenta pega desprevenido quem só quer testar. Se o objetivo é apenas conversar com o modelo, sem ações, você não precisa de agente — uma cadeia simples resolve, custa menos e é mais previsível.
Adicione o gatilho de chat
Para testar, o mais prático é o gatilho de chat, que abre uma janela de conversa dentro do próprio n8n. Você digita, o agente responde, e você vê cada decisão que ele tomou no caminho.
Adicione o node AI Agent
Ao conectar, aparecem os pontos de encaixe dos sub-nodes embaixo do node. É por ali que entram modelo, ferramentas e memória.
Conecte o modelo
Escolha o provedor e cadastre a credencial. Uma recomendação prática: comece por um modelo pequeno e barato. Se o agente errar, você vai querer testar dezenas de variações da instrução, e cada teste custa. Depois que o comportamento estiver certo, avalie se um modelo maior melhora o resultado o suficiente para justificar o preço.
Conecte uma ferramenta
Para o primeiro teste, uma ferramenta simples basta — uma calculadora ou uma busca. O objetivo aqui é ver o mecanismo funcionando: o agente decidindo sozinho que precisa usar aquilo.
Escreva a instrução
É aqui que a qualidade se decide, e é a etapa que mais gente faz às pressas. Uma instrução útil cobre quatro coisas:
Quem ele é. "Você atende clientes de uma clínica odontológica."
O que pode fazer. "Você pode consultar horários disponíveis e agendar."
O que nunca deve fazer. "Nunca invente preço. Nunca prometa prazo."
Quando sair de cena. "Se o cliente reclamar ou pedir atendente, transfira imediatamente."
O item 3 é o que separa agente que funciona de agente que cria problema. Sem proibição explícita, o modelo preenche lacunas com invenção plausível — e um preço inventado vira reclamação real.
Teste vendo as decisões
Execute e observe. O painel mostra o raciocínio: qual ferramenta ele escolheu, o que enviou, o que recebeu de volta e como usou aquilo na resposta.
Vale gastar tempo aqui. É observando essa sequência que você entende por que o agente errou — e quase sempre a resposta é "a instrução não dizia o que fazer nesse caso".
Os erros do primeiro dia
Ele responde mas não usa a ferramenta. Normalmente a descrição da ferramenta está vaga. O agente escolhe pela descrição — se ela não deixa claro quando usar, ele não usa.
Ele esquece o que foi dito. Falta memória. Sem ela, cada mensagem começa do zero.
Ele inventa. Falta proibição explícita na instrução, ou falta a ferramenta que traria o dado real.
Custou mais que o esperado. Comportamento normal: o agente roda várias vezes por pergunta.
Gatilho de chat, node AI Agent, modelo, uma ferramenta e uma instrução que diz o que ele nunca deve fazer. Teste observando as decisões, não só a resposta final.
Perguntas frequentes
Como criar um agente de IA no n8n?
Adicionando o node AI Agent e conectando a ele um modelo de chat e pelo menos uma ferramenta como sub-nodes. Para testar, o gatilho de chat abre uma janela de conversa dentro do próprio n8n e mostra as decisões tomadas a cada resposta.
Qual tipo de agente devo escolher no n8n?
Não há mais escolha. A partir da versão 1.82.0, a configuração de tipo foi removida e todos os nodes de agente funcionam como Tools Agent, que era a opção recomendada. Fluxos antigos configurados nesse tipo continuam funcionando normalmente.
Preciso conectar uma ferramenta ao agente?
Sim, pelo menos uma — é exigência do node. Se o seu caso não precisa de ferramenta nenhuma, provavelmente você não precisa de um agente: uma cadeia simples atende, custa menos e é mais previsível.
Por que o agente não usa a ferramenta que conectei?
Quase sempre porque a descrição da ferramenta está vaga. O agente decide qual acionar lendo essa descrição, então ela precisa deixar claro em que situação a ferramenta serve.
Qual modelo usar para começar?
Um modelo pequeno e barato. Ajustar o comportamento exige muitos testes, e cada teste tem custo. Depois que a instrução estiver madura, vale comparar com um modelo maior para ver se a melhora justifica a diferença de preço.
Este tutorial faz parte do guia Curso de n8n do zero ao avançado: o guia completo em português. Veja também: Node, trigger e workflow: o vocabulário do n8n em 10 minutos · A estrutura de dados do n8n: por que tudo é um array com json · Item linking no n8n: como ele decide qual item vai pra saída · Execuções passo a passo: como achar onde o fluxo do n8n quebrou · A Canvas UI do n8n 2.0: o que mudou e como se orientar · n8n Cloud ou self-hosted: a decisão que define seu custo e sua liberdade
