InícioGuias › Agentes de IA
Guia

n8n multi-agente: como orquestrar vários agentes de IA num só fluxo

Atualizado em 2026-07-12 · por Redação Automação Hoje
Profissional montando sistema multi-agente no n8n com agente orquestrador delegando para agentes de IA
Resposta rápida: No n8n, você orquestra vários agentes de IA conectando nós AI Agent Tool a um agente principal (o orquestrador). Ele lê o pedido, decide qual especialista chamar e delega — tudo numa execução, no mesmo canvas. É a alternativa ao antigo padrão de sub-workflows, que exigia gerenciar contexto e variáveis na mão.
· espaço publicitário ·
Em resumo
  • Um agente orquestrador delega para agentes especialistas via nó AI Agent Tool, sem sair do mesmo fluxo.
  • A 'Description' de cada agente-ferramenta é o que ensina o orquestrador quando chamar cada um — capriche nela.
  • Multi-agente rende mais em tarefas amplas, mas consome muito mais tokens que um agente único; nem sempre compensa.
  • Existem dois caminhos: roteamento (Switch + sub-workflows) e orquestração (AI Agent Tool). O segundo é mais simples.
  1. 1. Decida se você realmente precisa de multi-agente

    Antes de montar o time, seja honesto: se a tarefa tem um conjunto pequeno e bem definido de ferramentas, um agente único resolve — e é mais barato de rodar e de manter. Multi-agente faz sentido quando o trabalho se divide em domínios distintos (ex.: atendimento com trilhas de cobrança, suporte técnico e vendas) ou quando você quer perspectivas diferentes sobre a mesma entrada. A própria n8n documenta quatro topologias: requisições encadeadas, agente único com estado, multi-agente com 'porteiro' (gatekeeper) e times de agentes colaborando.

  2. 2. Crie o agente orquestrador

    Adicione um nó AI Agent comum. Ele será o coordenador: recebe a mensagem do usuário, mantém o contexto (conecte um nó de memória, como o Simple Memory) e decide o que fazer. No system prompt dele, deixe claro o papel: 'Você coordena um time. Analise o pedido e delegue para o especialista certo. Não responda sozinho o que for domínio de um especialista.' Escolha aqui o modelo de linguagem — costuma valer usar o modelo mais capaz no orquestrador e modelos mais leves nos especialistas.

  3. 3. Adicione os agentes especialistas como AI Agent Tool

    Para cada especialista, adicione um nó AI Agent Tool e conecte-o à entrada de ferramentas (tools) do orquestrador. Cada um vira uma 'ferramenta' que o agente principal pode acionar. Dê a cada especialista seu próprio system prompt focado (ex.: 'Você é o especialista em cobrança. Responda só sobre faturas, boletos e prazos') e, se precisar, suas próprias ferramentas — busca em base de dados, HTTP Request, e por aí vai.

  4. 4. Escreva a Description de cada especialista com cuidado

    Esse é o passo que a maioria pula e depois reclama que 'o agente chama a ferramenta errada'. O campo Description do AI Agent Tool não é decoração: é o texto que o orquestrador lê para decidir quando delegar. Seja específico. 'Especialista em cobrança' é fraco; 'Use este agente para dúvidas sobre faturas em aberto, segunda via de boleto, datas de vencimento e negociação de atraso' dá ao orquestrador critério real de roteamento.

  5. 5. Empilhe camadas se precisar (multi-tier)

    Um AI Agent Tool pode, ele mesmo, ter outros AI Agent Tool conectados. Isso te dá uma hierarquia: um coordenador geral chama um coordenador de suporte, que chama o especialista técnico. Serve para operações que imitam uma estrutura organizacional. Só não exagere na profundidade — cada camada adiciona latência e tokens.

  6. 6. Trate o que sai: escalonamento e resposta unificada

    Defina no orquestrador o que acontece quando nenhum especialista resolve. Um padrão comum: pedidos ambíguos ou que falharam vão para escalonamento humano antes de devolver a resposta. Peça ao orquestrador para consolidar tudo num formato de saída previsível (por exemplo, um JSON com o campo de resposta e o campo de rota usada) — assim o resto do seu fluxo, e você, sabem sempre o que esperar.

  7. 7. Teste com casos de borda antes de colocar no ar

    Rode entradas propositalmente ambíguas: uma pergunta que toca dois domínios, uma fora de escopo, uma mal escrita. Observe qual especialista o orquestrador escolhe. Se ele erra o roteamento, o problema quase sempre está na Description ou no system prompt do coordenador — não no modelo. Ajuste o texto, teste de novo. Só suba para produção quando o roteamento estiver estável.

Orquestração vs. roteamento: os dois padrões do n8n

Vale separar duas coisas que costumam ser confundidas. No padrão de roteamento (routing), você usa um classificador de texto para rotular a entrada — 'status do pedido', 'dúvida de política', 'cobrança', 'fora de escopo' — e um nó Switch manda a execução para a trilha certa. Dentro de cada trilha roda um sub-workflow com um agente focado e suas próprias ferramentas. É determinístico e fácil de auditar.

No padrão de orquestração, quem decide é o próprio agente principal, via nó AI Agent Tool. Não há Switch: o orquestrador lê as Descriptions dos especialistas e escolhe na hora. A grande vantagem, segundo a própria n8n, é rodar tudo numa execução só, no mesmo canvas, sem a dor de cabeça de gerenciar contexto e variáveis entre sub-workflows separados. A troca: você abre mão de um pouco de previsibilidade em favor de flexibilidade.

  • Roteamento (Switch + sub-workflows): previsível, auditável, bom quando as categorias são fixas e conhecidas.
  • Orquestração (AI Agent Tool): flexível, tudo num canvas, bom quando a decisão de rota é nuançada demais para regras.

O custo que ninguém mostra no tutorial

Multi-agente parece sempre melhor até chegar a fatura de tokens. Uma pesquisa da Anthropic citada em análises do ecossistema mostrou sistemas multi-agente superando o agente único em torno de 90% em certas tarefas — mas consumindo cerca de 15 vezes mais tokens. Não é detalhe: é a diferença entre um fluxo que se paga e um que sangra dinheiro rodando 24 horas.

A regra prática: comece com um agente único bem construído. Só quebre em vários quando você tiver evidência de que um agente sozinho não dá conta — respostas rasas, mistura de domínios, prompt inchado demais para ser confiável. Dividir instruções complexas em agentes menores e focados melhora a qualidade, sim, mas cobra por isso.

As novidades de 2026 que mudam o jogo

Dois lançamentos recentes do n8n empurram o multi-agente para dentro de um único fluxo. O primeiro é o próprio nó AI Agent Tool, que transformou o que antes exigia vários sub-workflows costurados em uma conexão direta de agentes como ferramentas. O segundo é o MCP Client Tool: o nó AI Agent passou a usar ferramentas expostas por servidores MCP remotos diretamente, o que amplia muito o que cada agente consegue fazer sem você programar integrações na mão.

Na prática, isso significa que dá para montar um time de agentes — cada um com seu escopo, sua memória e suas ferramentas, incluindo ferramentas de MCP externas — sem sair do editor visual. É o tipo de arquitetura que, dois anos atrás, exigia código.

Perguntas frequentes

Qual a diferença entre AI Agent Tool e usar sub-workflows?
O sub-workflow roda um agente num fluxo separado, e você precisa gerenciar contexto e variáveis entre eles. O AI Agent Tool conecta agentes especialistas direto ao agente principal, no mesmo canvas e numa execução só. É mais simples de montar e de depurar, e evita a passagem manual de dados entre fluxos.
Preciso saber programar para montar multi-agente no n8n?
Não para a estrutura básica. Orquestrador, especialistas e as conexões são todos nós visuais. Você mexe em código só quando precisa de transformações complexas (nó Code) ou de integrações sem nó nativo (HTTP Request). Se está começando com agentes, veja antes o guia de agente de IA no n8n sem programar.
Quando NÃO devo usar multi-agente?
Quando a tarefa é bem definida e usa poucas ferramentas. Nesses casos, um agente único é mais barato, mais rápido e mais fácil de manter. Multi-agente só compensa quando o trabalho se divide em domínios distintos ou exige perspectivas diferentes — e mesmo aí ele consome muito mais tokens.
Por que meu orquestrador chama o especialista errado?
Quase sempre o problema está na 'Description' do AI Agent Tool ou no system prompt do orquestrador, não no modelo. A Description é o texto que o agente principal lê para decidir a rota. Descreva com precisão o que cada especialista cobre — casos, exemplos, limites — e teste com entradas ambíguas.

Leia também