Resumo
O n8n 2.49.0 é a publicação da linha beta com foco em agentes e na API pública. Os agentes ganham canal de webhook com solicitações de aprovação, estado de arquivamento, etiquetas na API interna e endpoints de criação, leitura e remoção na API pública. A configuração de agente aceita agora guardrails de ferramenta, com execução por padrão de chamadas.
A publicação também altera o assistente e a instalação. O construtor de IA recebe catálogo de ferramentas, dicas por etapa e políticas de memória observacional opcionais, enquanto a API pública padroniza a prévia de mudança entre interface, API e CLI, mostra os escopos exigidos em cada operação e registra a versão do n8n na especificação OpenAPI.
Novidades
- n8n 2.49.0 — Canal de webhook para agentes: o agente ganha um canal de webhook, com descrições por canal e solicitações de aprovação dentro do canal.
- n8n 2.49.0 — Arquivamento de agentes: o agente ganha estado de arquivamento, com ação de arquivar e restaurar no editor e substituição da ferramenta de remoção por uma de arquivamento no MCP.
- n8n 2.49.0 — Endpoints de agentes na API pública: a API pública aceita criação, leitura e remoção de agentes e a API interna REST aceita etiquetas em agentes.
- n8n 2.49.0 — Guardrails de ferramenta: o esquema de configuração do agente aceita guardrails e as chamadas de ferramenta passam por verificação por padrão.
- n8n 2.49.0 — Lista de agentes com paginação: as listas de agentes aceitam
offsetelimite filtros equivalentes aos da lista de workflows. - n8n 2.49.0 — OAuth automático: um modo de OAuth registra o cliente automaticamente para os serviços selecionados.
- n8n 2.49.0 — Ferramenta de dependências no MCP: o servidor MCP ganha ferramenta para consultar dependências e o servidor de instância recebe ferramentas de relatório de migração.
- n8n 2.49.0 — Skills no assistente: o campo do assistente ganha submenu de skills e as skills podem ser editadas e gravadas no painel de artefatos.
- n8n 2.49.0 — CSP em Apps: as respostas de Apps incluem agora política de segurança de conteúdo.
- n8n 2.49.0 — Recurso Secret no Node do GitHub: o Node do GitHub opera agora o recurso Secret.
- n8n 2.49.0 — Exportação com
includeArchived: a API pública renomeia a opção de exportação de arquivados paraincludeArchived. - n8n 2.49.0 — Versão na especificação OpenAPI: a especificação traz agora a versão do n8n como metadado e os escopos de chave de API exigidos na descrição de cada operação.
- n8n 2.49.0 — Prévia de mudança unificada: interface, API pública e CLI usam a mesma prévia de alteração.
Melhorias
- n8n 2.49.0 — OAuth de MCP de saída: o fluxo de autorização de MCP de saída acompanha a especificação de autorização de 28/07/2026.
- n8n 2.49.0 — Auditoria de credencial: a leitura de conteúdo de credencial emite agora evento de auditoria e provedores e ambientes de promoção também emitem eventos próprios.
- n8n 2.49.0 — OpenTelemetry: o hook
otel.configurerecebe funções de substituição e os spans de Nodes de ferramenta recebem atributos de ferramenta GenAI. - n8n 2.49.0 — Promoções: revisões de promoção podem ser fechadas pela caixa de entrada e falhas comuns de Git ganham explicação.
- n8n 2.49.0 — Promoção sem workflow: projetos e pastas podem ser promovidos e aplicados sem selecionar um workflow.
- n8n 2.49.0 — Construtor de IA: o assistente usa catálogo de ferramentas, executa chamadas auxiliares num modelo utilitário e recebe dicas por etapa com pistas de referência.
- n8n 2.49.0 — Memória observacional: políticas de memória observacional entram como opção para o Instance AI.
- n8n 2.49.0 — Desempenho de expressões: o tempo de preparação por item no tempo de execução de expressões cai e a tabela de caracteres especiais sai do pacote de execução.
- n8n 2.49.0 — Cache do QuickJS: o arquivo WASM do QuickJS é servido com cache longo e só a variante de sincronização de release é distribuída.
- n8n 2.49.0 — Editor mais leve: componentes modais carregam sob demanda e o build do editor descarta módulos não usados de
n8n-workfloweapi-types. - n8n 2.49.0 — Animação do canvas: o consumo de CPU das animações de status do canvas diminui.
- n8n 2.49.0 — Links do usuário: os links pessoais ficam num menu de perfil no rodapé da barra lateral.
Correções
- n8n 2.49.0 — Histórico do agente: cada ciclo de chamada de ferramenta de um turno é gravado na memória da conversa e o histórico de chamadas fica separado por item de entrada.
- n8n 2.49.0 — Texto junto da ferramenta: o texto que o modelo escreve ao chamar uma ferramenta não é mais descartado do histórico do agente.
- n8n 2.49.0 — Streaming de texto: o Node de agente de IA deixa de inserir quebras de linha entre trechos transmitidos.
- n8n 2.49.0 — PDF no AWS Bedrock: o envio usa bloco de texto com nome de documento válido.
- n8n 2.49.0 — IDs de chamada de ferramenta: os identificadores vindos de servidores compatíveis com OpenAI são preservados no histórico do agente.
- n8n 2.49.0 — Endpoints compatíveis com OpenAI: modelos personalizados são aceitos na versão 2 e o esforço de raciocínio pode ser definido nesses endpoints.
- n8n 2.49.0 — Cache de prompt: agentes podem desligar o cache de prompt em endpoints que recusam os campos de cache e
promptCacheRetentionnão é mais enviado a modelos GPT-6 e posteriores. - n8n 2.49.0 — Credencial no Node: o nome exibido da credencial acompanha a marca do Node.
- n8n 2.49.0 — API pública de credenciais: a API recusa edição de Nodes de credencial somente leitura e exige apenas os escopos que uma importação usa.
- n8n 2.49.0 — Pastas na API pública: rotas públicas de pasta aceitam alias pessoal.
- n8n 2.49.0 — Disparo durável: os trabalhos de gatilho durável sobrevivem a uma publicação seguida de despublicação.
- n8n 2.49.0 — Histórico de workflow no SQLite: a limpeza do histórico roda em lotes fora da trava de escrita do SQLite.
- n8n 2.49.0 — Execução com credencial global: a instância deixa de ocultar execuções que usam credenciais globais.
- n8n 2.49.0 — Espera de trabalho filho: a conclusão de trabalhos filhos em workers é resolvida agora por eventos de conclusão.
- n8n 2.49.0 — Retomada com falha: o limite de tentativas de retomada vale agora também para retomadas que falharam.
- n8n 2.49.0 — Node de Postgres: o processamento de itens devolve o controle ao laço de eventos, o que evita travar a instância em lotes grandes.
- n8n 2.49.0 — Node Remove Duplicates: o Node deixa de ficar preso ao atingir o tamanho máximo do histórico.
- n8n 2.49.0 — Nodes de vetor: o Weaviate limpa a coleção uma vez por inserção, passa filtros na busca híbrida e o Pinecone consulta índices com esquema de documento pela API de documentos.
- n8n 2.49.0 — Node Qdrant: o subcaminho do proxy reverso é preservado como prefixo do cliente.
- n8n 2.49.0 — Gatilho do Jira Cloud: o token assinado é verificado nos webhooks OAuth2 de entrada.
- n8n 2.49.0 — Gatilho do Microsoft Teams: todas as notificações de alteração de uma requisição em lote são emitidas.
- n8n 2.49.0 — Gemini: o motivo da recusa aparece quando o modelo não devolve resposta e erros de rede informam a causa.
- n8n 2.49.0 — Decriptação assimétrica: bytes que não são UTF-8 são preservados.
- n8n 2.49.0 — Credencial em Node de IA: Nodes que usam credencial de chave de API exigem agora a chave.
- n8n 2.49.0 — Editor de avaliação: cartões de métrica deixam de transbordar sobre os vizinhos e colunas e menus de avaliação recebem tradução.
- n8n 2.49.0 — Assistente: rascunhos são preservados durante aprovações, mensagens antigas carregam ao rolar para cima e o painel de registros abre só quando a execução de prévia falha.
- n8n 2.49.0 — Agente recém-criado: o agente continua como rascunho depois de voltar das configurações e as abas seguem disponíveis para rascunhos novos.
- n8n 2.49.0 — Erro antigo no canvas: Nodes deixam de mostrar erro de execução já substituído.
Breaking changes
- n8n 2.49.0 — Exportação de arquivados na API pública: a opção que exporta itens arquivados recebe o nome
includeArchived. Uma integração que envia o nome anterior precisa ser ajustada antes de atualizar.
Ponto de Atenção
A publicação é beta e concentra mudanças em agentes e na API pública. Uma instalação que usa a API pública para exportar workflows precisa conferir o nome da opção de arquivados e uma instalação com agentes e guardrails deve revisar a configuração antes de promover a versão.
Teste sugerido: chame a API pública de exportação com includeArchived e confirme o retorno. Crie um agente pela API pública, leia e remova o mesmo agente. Num agente com guardrail de ferramenta, execute uma chamada barrada e confira a recusa. Rode um workflow com Node de Postgres em lote grande e verifique se a instância responde durante o processamento.
Notas da versão
O release oficial do n8n 2.49.0 foi publicado em 17/11/2026 às 9h40 UTC como pré-lançamento da linha beta. As notas vêm da lista de mudanças do repositório, com blocos de novidades, desempenho e correções.