n8n 3.0: O Que Muda nos Agentes de IA e Como Migrar Seus Workflows Antes de Dezembro

n8n 3.0 beta chegou em outubro de 2026 com mudanças que quebram workflows de IA: o AI Agent node v1 foi removido. Veja como migrar para o Tools Agent antes do release estável em dezembro.

O Que Aconteceu

Em 27 de outubro de 2026, o n8n lançou o beta oficial da versão 3.0 — a maior atualização da plataforma desde o lançamento do AI Agent node em 2024. O release estável está previsto para o início de dezembro de 2026, e a partir dele, novos recursos serão entregues exclusivamente na versão 3. A versão 2.x continuará recebendo correções de segurança e bugs críticos por 12 meses após o estável, mas o desenvolvimento de produto migra completamente para o 3.x.

Para quem constrói automações com agentes de IA no n8n — especialmente integrações com Kommo CRM, qualificação de leads via WhatsApp, ou pipelines de enriquecimento de dados — essa atualização tem mudanças que quebram compatibilidade. A principal delas: o AI Agent node na versão 1 e os modos legados desse node foram removidos. O substituto oficial é o Tools Agent, que existe desde a versão 2.x mas que agora passa a ser o único ponto de entrada para construir agentes no n8n.

A remoção do modo legado não é uma surpresa — o n8n vinha sinalizando a depreciação desde meados de 2025. Mas o prazo chegou. E para quem tem workflows em produção construídos com o AI Agent node v1 (o que inclui a grande maioria dos tutoriais públicos disponíveis até 2025 e boa parte dos templates do marketplace), a janela de migração antes do release estável de dezembro é curta: menos de 6 semanas.

Além do AI Agent node, a versão 3.0 remove a aba Ask AI do nó de Código (Code node). Essa funcionalidade permitia gerar código JavaScript ou Python diretamente dentro do n8n com assistência de IA. A remoção faz parte do esforço de consolidar as interações de IA dentro do fluxo de ferramentas do Tools Agent, em vez de tê-las espalhadas por nós individuais. Para quem usava o Ask AI frequentemente para escrever transformações de dados ou lógica de roteamento, o impacto é operacional — não técnico, mas de hábito de trabalho.

Por Que Isso Importa Para Você

Se você tem automações com agentes de IA rodando em produção no n8n — para clínicas, escritórios de advocacia, e-commerces, ou imobiliárias — a versão 3.0 cria três cenários de risco que você precisa avaliar agora:

Cenário de risco 1 — Workflow com AI Agent node v1 em produção. Se você criou o agente usando o modo legado do AI Agent node (antes da introdução do Tools Agent), esse workflow não vai funcionar na versão 3.0. A migração precisa ser feita manualmente, substituindo o nó antigo pelo Tools Agent e reconfigurando as ferramentas (tools) que o agente usa. Não é uma migração automática — o n8n não converte os workflows existentes.

Cenário de risco 2 — Self-hosted no n8n 2.x sem processo de atualização definido. Se você roda o n8n em servidor próprio (VPS, Docker, Railway, Render) e não tem um processo claro de atualização, o risco é atualizar para a 3.0 sem perceber as breaking changes e ter agentes parando de funcionar em produção. A recomendação é não atualizar para 3.0 ainda se você não testou seus workflows no ambiente de staging — e se você não tem ambiente de staging, agora é o momento de criar um.

Cenário de risco 3 — Templates e tutoriais desatualizados. A maioria dos tutoriais de n8n + OpenAI ou n8n + Claude disponíveis no YouTube e em blogs foi gravada com a versão 1 do AI Agent node. Se você ou seu cliente seguiram esses tutoriais para construir um agente de qualificação de leads, o workflow provavelmente usa o modo legado. Testar agora em ambiente de desenvolvimento antes que o cliente perceba a falha em produção é muito mais barato do que investigar uma parada durante o horário de pico de atendimento.

Análise Técnica: O Que É o Tools Agent e Como Ele Funciona

O Tools Agent não é apenas uma atualização cosmética do AI Agent node — ele representa uma mudança de paradigma na forma como o n8n estrutura agentes de IA. No modelo legado, o AI Agent node era um nó monolítico que encapsulava o modelo de linguagem, as ferramentas, a memória e o loop de execução em uma única configuração. Poderoso para casos simples, mas difícil de debugar e de escalar.

No Tools Agent, a arquitetura é modular:

• O nó central do Tools Agent define o modelo de linguagem (Claude, GPT, Gemini), o system prompt, e a estratégia de execução (quantas iterações máximas, o que fazer em caso de erro).
• As ferramentas (tools) são nós separados conectados ao Tools Agent: uma busca no Supabase, uma chamada à API do Kommo, uma pesquisa na web, um cálculo de preço. Cada ferramenta é um nó n8n normal, com inputs e outputs visíveis, testável individualmente.
• A memória é um nó separado — Window Buffer Memory, Redis Memory, ou PostgreSQL Memory — conectado explicitamente ao agente. Isso significa que você pode trocar a estratégia de memória sem reconfigurar o agente inteiro.

Essa separação tem impacto direto na produtividade de quem constrói e mantém automações comerciais. Debugar um agente no modelo legado significava adivinhar o que acontecia dentro do nó monolítico. No Tools Agent, cada ferramenta tem sua própria saída visível na tela de execução — você vê exatamente quais dados foram passados para a API do Kommo, quais foram retornados, e onde o agente tomou cada decisão. Para uma clínica com 500 leads por mês rodando qualificação automatizada, a diferença entre debugar em 10 minutos vs. 2 horas por falha é significativa.

Outro ponto técnico relevante para quem integra com Claude via API: o Tools Agent do n8n 3.0 suporta tool calling nativo dos modelos Anthropic, incluindo o formato de ferramentas do Claude 3.x e 4.x. Isso significa que você pode passar ferramentas no formato JSON Schema diretamente para o Claude via o nó do Tools Agent, e o Claude vai escolher e executar as ferramentas com a mesma lógica que usaria na API direta. Para agentes que precisam de raciocínio mais estruturado sobre quando usar cada ferramenta — como um agente de qualificação de advocacia que precisa distinguir entre coletar dados básicos, consultar uma base de jurisprudência, ou escalar para um humano — isso é uma melhoria real de qualidade de resposta.

Como Aplicar Hoje: Guia de Migração em 4 Passos

Passo 1 — Inventariar todos os workflows com AI Agent node. No painel do n8n, use o campo de busca para filtrar workflows que contêm o nó "AI Agent". Separe os que estão ativos em produção dos que são templates ou testes. Crie uma planilha simples com: nome do workflow, se está ativo, qual modelo de LLM usa, quais ferramentas tem, e se tem clientes dependendo dele. Esse inventário vai guiar a prioridade da migração.

Passo 2 — Montar o ambiente de staging. Se você roda o n8n em self-hosted, suba uma instância separada com a versão 3.0 (disponível como imagem Docker n8nio/n8n:3.0.1). Se você usa o n8n Cloud, verifique com o suporte deles quando o upgrade automático para 3.0 está previsto — normalmente há um período de opt-in antes da migração forçada. Nunca teste breaking changes diretamente na instância de produção.

Passo 3 — Reconstruir o agente com Tools Agent. Para cada workflow com AI Agent node legado, o processo de migração é:

1. Abra o workflow no ambiente de staging (ainda na versão 2.x se possível).
2. Adicione um nó Tools Agent ao lado do AI Agent node existente.
3. Copie o system prompt e as configurações de modelo do AI Agent node para o Tools Agent.
4. Reconecte cada ferramenta ao Tools Agent (elas já são nós separados no n8n 2.x — só a conexão muda).
5. Reconecte o nó de memória ao Tools Agent (se existir).
6. Remova o AI Agent node legado.
7. Execute um teste com dados reais do fluxo de qualificação — leads de WhatsApp, dados de Kommo, etc.

Passo 4 — Validar e promover para produção antes de dezembro. Após migrar e testar no staging, atualize o ambiente de produção para a versão 3.0 e ative o workflow migrado. Monitore as primeiras 24 a 48 horas com atenção especial às execuções dos agentes. Os logs do n8n 3.0 têm mais granularidade na visualização de execuções de agentes, o que facilita identificar comportamentos inesperados logo após a migração.

"A mudança do n8n 3.0 não é sobre o que você perde — é sobre o que você ganha. Um agente modular, debugável e escalável vale muito mais do que um nó monolítico que funciona até o dia que para de funcionar e ninguém sabe por quê."

Recomendação Metrik

A versão 3.0 do n8n é, fundamentalmente, uma atualização de qualidade de engenharia — e não de novos recursos de produto. O n8n está consolidando a base técnica para crescer com mais estabilidade. Para quem trabalha no modelo Product Service da Metrik, isso é positivo a médio prazo: a plataforma fica mais robusta, o debugging fica mais transparente, e a arquitetura de Tools Agent facilita construir agentes que realmente escalam para dezenas de clientes com configurações diferentes.

Mas o impacto de curto prazo é real: se você tem workflows em produção com o AI Agent node legado, a janela de migração é agora. Não espere o release estável de dezembro para começar a testar — quando ele chegar, você quer estar operando normalmente, não correndo contra um deadline com clientes vendo falhas em produção.

Para novos projetos iniciados a partir de outubro de 2026, a recomendação é direta: use o Tools Agent desde o início, com Claude como modelo de linguagem (Haiku 4.5 para qualificação de alto volume, Sonnet 5 para análise contextual profunda), Kommo como CRM de destino via API, e PostgreSQL Memory se o cliente precisar de histórico de conversa entre sessões. Essa arquitetura é compatível com o n8n 3.0 desde o primeiro commit, e você não vai precisar migrar nada quando o estável chegar em dezembro.

O stack n8n 3.0 + Claude + Kommo que a Metrik recomenda para novos agentes comerciais: Tools Agent como orquestrador central, nó HTTP Request para chamadas à API do Kommo (criação de leads, atualização de campos, avanço de etapas), nó Claude para geração de texto contextual quando o agente precisa redigir mensagens personalizadas, PostgreSQL Memory para sessões de qualificação que duram múltiplas mensagens, e webhook de entrada para receber mensagens do WhatsApp Business API. Essa arquitetura é mais verbosa de configurar do que o AI Agent node monolítico legado — mas é totalmente visível, testável nó a nó, e pronta para produção em escala.

A mensagem final é simples: quem migra para o Tools Agent hoje sai na frente em dezembro. Quem espera, corre o risco de acertar quebras em produção justo no período mais movimentado do ano — final de novembro e início de dezembro, quando e-commerces e serviços têm os maiores volumes de leads. Migre agora, valide no staging, e entre em dezembro com os agentes rodando na arquitetura nova.