Ir para o conteúdo
Promovaweb

Visão geral dos agentes

Revisado em

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.