Visão geral dos agentes
Antes de começar
Saber o que é um agente no n8n e quando ele resolve melhor do que um workflow com passos fixos.
- Instância do n8n na versão 2.32.3 ou posterior, para agentes em self-hosted.
- Chave de API de um provedor de modelo de linguagem.
Um workflow segue passos fixos. Um agente decide o próximo passo. Ele recebe uma solicitação, lê as instruções, escolhe uma ferramenta, avalia a resposta e repete até chegar ao resultado.
Quando usar um agente
A documentação do n8n indica o agente para trabalhos abertos demais para um fluxo fixo: responder perguntas com base em arquivos e serviços conectados, executar ações em ferramentas como Slack e Google Sheets e coordenar workflows para tarefas maiores. Para um processo com passos conhecidos, um workflow continua sendo a escolha mais previsível.
As partes de um agente
| Parte | O que faz |
|---|---|
| Model | O modelo de linguagem que raciocina e gera as respostas |
| Instructions | O prompt de sistema com papel, tom e limites do agente |
| Tools | As ações disponíveis: workflows, código, integrações do n8n e servidores MCP |
Cada conversa com um agente é uma sessão. O n8n guarda a sessão para você retomar a conversa depois. A memória do agente usa essa sessão para manter o histórico da conversa.
Duas formas de agente no n8n
| Forma | Onde fica |
|---|---|
| Agentes do Agent Builder | Ao lado dos workflows no projeto, com chat, canais e agendamentos |
| Node AI Agent | Dentro de um workflow, como um passo do fluxo |
Os agentes do Agent Builder estão em Preview. Em self-hosted, funcionam a partir da versão 2.32.3. O owner ou um admin liga e desliga o recurso em Settings > Agents. Essa configuração não afeta o node AI Agent.
No n8n 3.0
A versão 3.0 remove a versão 1 do node AI Agent e os modos antigos de agente. Fica o Tools Agent. Workflows que já usam o Tools Agent seguem com o mesmo comportamento.
Os guias da área de agentes mostram como montar um AI Agent, ligar memória e ferramentas e usar uma base de conhecimento.
Confira o resultado
Você encontra **Settings > Agents** na sua instância e sabe dizer quais partes um agente precisa: modelo, instruções e ferramentas.
Fontes e conferência
Conteúdo conferido na documentação oficial do n8n em 28 de outubro de 2026.
