N8N
Ir para notas que citam estaN8N é uma plataforma de automação de fluxos de baixo código, com interface visual baseada em nós conectados, que virou um dos caminhos mais curtos para construir agentes de IA sem escrever o sistema inteiro em código.
A origem dela não é agentes: é automação de processos, ligando serviços uns aos outros por blocos prontos. O que a aproximou de IA foi o catálogo de integrações — centenas delas, incluindo provedores de modelos de linguagem configuráveis com poucos cliques — somado a nós específicos de agente, memória e busca vetorial. Na prática, quem consegue desenhar mentalmente o fluxo que o agente deve seguir consegue montá-lo ali. É por isso que a ferramenta se firmou como instrumento de prototipação: valida uma ideia em dias, não em semanas. O contraponto dessa velocidade é o controle menor sobre o comportamento, discutido em N8N versus LangGraph.
O fluxo como grafo de nós
Um workflow é uma tela em que se encaixam nós, cada um representando uma etapa, e a informação caminha de um para o outro. Todo fluxo começa por um Gatilho no N8N e só existe execução quando esse gatilho dispara. Do gatilho em diante, os nós fazem o trabalho: chamar um modelo, consultar uma base, decidir um caminho, formatar uma saída, entregar o resultado a outro sistema.
O nó de agente é o que transforma a automação em Agente de IA. Ele já vem parcialmente configurado, puxando automaticamente a mensagem que veio do gatilho de chat; o que falta é conectar-lhe um modelo de linguagem e, opcionalmente, memória e ferramentas. São conexões laterais, penduradas no nó, e não etapas da linha principal — a leitura visual disso é exatamente a arquitetura de um agente: um modelo, com instrução, com acesso a ferramentas.
Nem tudo se resolve arrastando blocos. Quando a manipulação de dados não cabe na configuração de um nó nativo, entra o Nó de Código no N8N, que aceita trechos curtos de JavaScript ou Python puros e funciona como cola entre os blocos.
Credenciais, execuções e o que a interface mostra
As credenciais ficam em uma seção separada dos fluxos: uma chave de API é cadastrada uma vez e depois referenciada por qualquer nó que precise dela, sem aparecer no corpo do workflow. A tela principal lista todos os fluxos e indica quais estão ativos, permitindo ligar e desligar uma automação a qualquer momento.
A seção de execuções guarda o histórico e é a ferramenta de diagnóstico mais usada: ela mostra o caminho percorrido, onde a falha aconteceu, quantas vezes o modelo foi chamado e quantos tokens cada chamada consumiu, além do total da execução — observabilidade de Custo de Tokens sem instrumentar nada. O histórico global vem misturado entre automações diferentes; para ver o de um fluxo específico é preciso abri-lo individualmente.
Limites conhecidos e como se contornam
- Documentação. A plataforma não tem mecanismo próprio de documentar um fluxo além das notas adesivas em Markdown coladas na tela. A comunidade recomenda fortemente usá-las descrevendo cada nó; um fluxo bem anotado é reaproveitável por outra pessoa, um fluxo sem anotação não é.
- Paralelismo. A estrutura padrão executa uma etapa por vez. Disparar vários agentes simultaneamente depende de Subworkflows no N8N, que permitem chamar um fluxo de dentro de outro.
- Escala. A plataforma roda sobre um runtime de thread única, então uma instância sozinha satura quando as execuções se acumulam. O modo fila distribui o processamento entre vários trabalhadores que se comunicam entre si, comportando-se como microsserviços. O escalonamento não é automático: é preciso identificar o gargalo para então aumentar o número de trabalhadores.