Release do n8n · 01 de julho de 2026

n8n n8n@2.28.4

Detalhamento editorial da versão, com mudanças publicadas e referência oficial para consulta técnica.

n8n n8n@2.28.4

Resumo

O n8n 2.28.4 ajusta o AI Agent Node, as variáveis de projeto, a autenticação Digest, a checagem de credenciais gerenciadas pelo AI Gateway e pontos de interface no editor. A versão também adiciona uma flag para imports transitivos no Python task runner e oculta parâmetros incompatíveis com gateway quando a credencial gerenciada está em uso.

Novidades

  • Python task runner: o core passa a aceitar N8N_RUNNERS_ALLOW_TRANSITIVE_IMPORTS, variável que habilita imports transitivos no runner de tarefas Python.

Melhorias

  • Parâmetros incompatíveis com gateway: o editor esconde parâmetros de nodes incompatíveis com gateway quando credenciais gerenciadas estão configuradas, reduzindo configuração inválida antes da execução.
  • Busca de nodes: o Human review node volta a aparecer na busca de adição de node, facilitando a montagem de fluxos com revisão humana explícita.

Correções

  • AI Agent Node: a memória de chat preserva a estrutura de chamadas paralelas de ferramentas, evitando perda de forma quando o agente usa mais de uma tool na mesma interação.
  • Escopo de variáveis: o n8n passa a priorizar a variável de projeto quando ela usa a mesma chave de uma variável global, preservando o escopo mais específico na execução.
  • Autenticação Digest: as credenciais Digest só são enviadas depois do desafio do servidor, evitando exposição desnecessária de segredo em requisições que ainda não pediram autenticação.
  • Credenciais do AI Gateway: credenciais gerenciadas pelo AI Gateway deixam de bloquear a checagem de permissão antes da execução.
  • Parâmetros do NDV: o componente InputTriple corrige comportamento responsivo nos parâmetros do NDV, melhorando leitura e edição em telas menores.

Breaking changes

Nenhum breaking change foi publicado para esta versão. Ainda assim, a precedência entre variáveis globais e variáveis de projeto pode alterar execuções que dependiam de colisão de chaves.

Ponto de Atenção

  • Precedência de variáveis: revise workflows com variáveis globais e variáveis de projeto usando a mesma chave, pois o escopo de projeto passa a prevalecer.
  • Autenticação Digest: valide integrações HTTP que usam Digest auth, confirmando que o servidor envia o desafio antes do envio das credenciais.
  • Teste sugerido: execute um workflow com AI Agent Node usando chamadas paralelas de ferramentas, outro com variável global e variável de projeto homônimas, e uma chamada Digest auth para confirmar memória, escopo e autenticação.

Notas da versão

O release também corrige pontos do editor ligados ao NDV, à busca do Human review node e à compatibilidade visual de parâmetros com credenciais gerenciadas. Esses itens afetam principalmente montagem e revisão de workflows no editor.

Voltar para o changelog do n8n

Área pública disponível

Participe da comunidade no Discord

Entre pelo convite oficial, apresente-se à comunidade e acompanhe os avisos e projetos compartilhados entre os encontros.