Nó de Código no N8N
Ir para notas que citam estaNó de Código no N8N é o bloco Code, onde se escreve JavaScript ou Python puro para manipular dados em um ponto do fluxo que os nós visuais não resolvem bem.
Quase tudo no N8N se configura pela interface: cada nó nativo tem campos, opções e mapeamento de variáveis por arrastar e soltar, sem código. O nó Code é a exceção deliberada. Ele existe para os momentos em que o dado chega no formato errado, precisa ser juntado com outro ou tem de ser reorganizado antes do próximo passo, e montar isso com uma cadeia de nós visuais seria mais trabalhoso ou mais lento do que escrever algumas linhas.
O bloco aceita apenas a linguagem pura: não há como importar bibliotecas nem usar frameworks dentro dele. Isso define o seu tamanho natural. Ele serve para transformações pontuais, em geral uma ou duas linhas, e não para abrigar lógica de negócio inteira.
Montar um objeto único antes de uma bifurcação
O uso mais típico em fluxos com agentes é consolidar, em um só objeto JSON, os campos de que os passos seguintes vão precisar. Em um fluxo multiagente com classificador de intenção, o bloco colocado logo antes do Switch devolve um objeto com três campos: o caminho escolhido pelo classificador, o identificador da sessão e a pergunta original do usuário, que chegou pelo webhook.
A razão é prática. Variáveis que vêm de nós anteriores nem sempre são reconhecidas pelos ramos de um Switch: a primeira saída costuma enxergá-las, as demais podem falhar ao localizá-las. Empacotar tudo em um único bloco elimina a dependência da propagação automática do N8N entre ramos, e a partir dali cada caminho lê o mesmo objeto, independentemente do que veio do front-end ou da solução que disparou o fluxo.
O mesmo papel de cola aparece depois dos nós de agente, quando a saída de um modelo precisa ser formatada antes de alimentar o próximo agente ou a resposta final.
Trocar nós lentos por código para ganhar tempo
O segundo motivo para recorrer ao bloco é desempenho. Alguns nós nativos são lentos para certas ações, e um workflow inteiro pode ficar refém de um único gargalo. O procedimento é identificar, no histórico de execuções, qual nó concentra o tempo e reescrever só aquele trecho como código. Em um workflow que substituía um scraper, essa troca derrubou a execução de cerca de 50 para cerca de 30 segundos.
Essa otimização age no nível do nó. Quando o problema é volume de execuções concorrentes, e não um passo lento, o caminho é outro: escalar o N8N em modo fila, com vários workers. As duas medidas se complementam. Quando nem isso basta, a comparação de tempo de resposta entre plataformas visuais e código entra em N8N versus LangGraph.
O custo em legibilidade do fluxo
Um nó visual mostra na tela o que faz; um bloco de código esconde a lógica atrás de texto que precisa ser lido e entendido.
Cada troca de nós visuais por código torna o fluxo menos legível para quem não programa, justamente o público que o N8N atende. A regra que sai daí é usar o bloco onde ele se paga: transformação de dados que os nós nativos não fazem, montagem de campos que vários ramos vão consumir e gargalo de tempo medido. Mantê-lo curto, com campos de nome claro, preserva a leitura do restante do fluxo.