n8n 2.40.0: Extended Thinking do Claude Agora Funciona com Tool Calls — O Que Muda nos Seus Agentes
n8n 2.40.0 corrige o bug crítico que impedia o Extended Thinking do Claude em agentes com tool calls. Veja como ativar e o impacto real na stack n8n + Kommo + IA.
O Que Aconteceu: n8n 2.40.0 — 15 de Setembro de 2026
Em 15 de setembro de 2026, o n8n lançou a versão 2.40.0 — uma release que pode parecer incremental no changelog, mas que carrega uma correção crítica para quem usa modelos Claude com raciocínio estendido (Extended Thinking) dentro de agentes de IA. Se você já tentou ativar o Enable Thinking no nó AI Agent do n8n e viu o fluxo travar ou retornar erros de formatação de mensagem, esta versão resolve exatamente esse problema.
Por Que Isso Importa Para Você
O recurso de Extended Thinking da Anthropic — disponível nos modelos Claude Sonnet 5, Fable 5.1 e Mythos 5.1 — permite que o modelo processe etapas intermediárias de raciocínio antes de responder. Isso aumenta significativamente a qualidade da resposta em tarefas complexas como análise de contratos, qualificação de leads sofisticados ou roteirização de propostas comerciais personalizadas.
O problema que existia até a versão 2.39: quando o agente n8n usava ferramentas (tool calls) em conjunto com o Extended Thinking do Claude, a mensagem de retorno continha blocos de thinking com texto vazio. O n8n não sabia como lidar com esses blocos e quebrava a execução do agente. Resultado prático: qualquer workflow que combinasse raciocínio estendido com chamadas de ferramentas externas — consulta ao CRM Kommo, leitura de planilha, envio de mensagem no WhatsApp — simplesmente falhava sem uma mensagem de erro clara.
Com a versão 2.40.0, os blocos de thinking com texto vazio agora são preservados corretamente durante as tool calls, permitindo que o modelo Claude complete seu ciclo de raciocínio sem interrupções. É uma correção simples no código, com impacto enorme na prática.
Análise Técnica: O Que Mudou Internamente
Para entender a correção, é preciso entender como o Claude processa mensagens em modo de raciocínio estendido. Quando você ativa o Extended Thinking, o modelo retorna um objeto especial chamado thinking_block junto com a resposta normal. Em alguns casos — especialmente quando o modelo ainda não terminou de raciocinar mas já precisa chamar uma ferramenta — esse bloco pode conter texto vazio.
Versões anteriores do n8n descartavam ou rejeitavam esses blocos vazios, causando um erro de validação na API da Anthropic na próxima chamada da cadeia. A versão 2.40.0 mantém esses blocos intactos na memória do agente, garantindo que o histórico de mensagens fique consistente com o que a API da Anthropic espera receber.
Além da correção principal, a versão 2.40.0 trouxe melhorias importantes no AI Builder (AIA):
- Guidance UX para agentes sem sessões: Quando um agente recém-criado ainda não tem sessões de teste, o painel do builder exibe orientações claras sobre como iniciar — reduzindo a curva de aprendizado para equipes comerciais que estão construindo seus primeiros agentes.
- Proteção contra erros 429 em integrações de canal: Canais como WhatsApp e Telegram integrados ao agente agora têm tratamento melhorado para rate limits, evitando que o agente quebre em momentos de pico de volume de mensagens.
- Credenciais reutilizáveis no card do agente Instance AI: A interface de credenciais agora exibe conexões já cadastradas na instância n8n, eliminando a necessidade de recriar integrações com Anthropic, OpenAI ou Google toda vez que um novo agente é criado.
Como Aplicar Hoje na Stack n8n + Claude + Kommo
Se você usa a stack Metrik — n8n conectado ao Kommo CRM via webhook, com Claude como cérebro do agente — veja como ativar o Extended Thinking agora que o bug foi corrigido na versão 2.40.0.
Passo 1: Atualizar o n8n
Se você usa n8n self-hosted, atualize para a versão 2.40.0 com npm install n8n@2.40.0 -g ou via Docker com a imagem n8nio/n8n:2.40.0. No n8n Cloud, a atualização é automática e pode já estar ativa na sua instância.
Passo 2: Ativar Extended Thinking no Nó AI Agent
No nó AI Agent, em Model, selecione Claude Sonnet 5 ou Claude Fable 5.1. Nas opções avançadas do nó, habilite Enable Thinking e defina um budget de tokens de raciocínio. Recomendamos entre 2.000 e 8.000 tokens para tarefas comerciais. O custo adicional se justifica quando a precisão é crítica — análise de fit de lead para uma clínica odontológica, triagem de documentos jurídicos em um escritório de advocacia, ou análise de intenção de compra em e-commerce.
Passo 3: Configurar Ferramentas do Agente
Com o bug do 2.40.0 corrigido, você pode combinar Extended Thinking com múltiplas ferramentas sem risco de quebrar o fluxo. Um setup poderoso para e-commerce ou imobiliária:
| Ferramenta | Função | Integração |
|---|---|---|
| Busca de Lead | Consulta dados do contato no Kommo CRM | HTTP Request para API Kommo |
| Verificação de Disponibilidade | Confirma estoque do produto ou disponibilidade do imóvel | HTTP Request para ERP ou planilha |
| Envio de Proposta | Gera e envia proposta personalizada em PDF | n8n + Google Docs ou Typeform |
| Atualização de Funil | Move o lead de fase no pipeline do Kommo | HTTP Request para API Kommo |
Com Extended Thinking ativado, o Claude vai primeiro raciocinar sobre o contexto completo do lead — histórico de interações, fase do funil, comportamento recente, segmento — antes de decidir qual ferramenta acionar e com qual argumento. O resultado é um agente muito mais preciso do que com o modelo padrão, especialmente em fluxos de múltiplas etapas.
Caso de Uso Real: Clínica Odontológica
Uma clínica recebe uma mensagem via WhatsApp: "Qual o preço do implante?". Com o agente padrão (sem thinking), a resposta seria uma tabela de preços genérica. Com Extended Thinking ativado no n8n 2.40.0, o agente:
- Raciocina sobre o histórico do contato no Kommo — é a primeira mensagem? Já consultou antes? Tem plano odontológico?
- Consulta a ferramenta de disponibilidade de agenda do dentista especialista.
- Decide com contexto: se o lead nunca interagiu antes, responde com preço + link de agendamento. Se está em negociação avançada e o ticket estimado é alto, escala para atendente humano com resumo do contexto.
Com o bug da versão 2.39, essa cadeia de raciocínio + múltiplas tool calls quebraria silenciosamente em algum ponto da execução. Com o 2.40.0, funciona de ponta a ponta de forma confiável.
Caso de Uso: Advocacia e Triagem de Documentos
Escritórios de advocacia que usam n8n para triagem inicial de casos podem agora combinar o Extended Thinking do Claude com ferramentas de leitura de PDF (via n8n + extração de texto) e consulta ao histórico de processos no CRM Kommo. O modelo raciocina sobre a complexidade do caso antes de classificá-lo e direcionar para o advogado responsável pela área — tudo automático, sem quebrar no meio da cadeia de ferramentas.
Recomendação Metrik
A versão 2.40.0 do n8n é uma atualização obrigatória para quem usa Claude com Extended Thinking em agentes comerciais. A correção do bug de thinking blocks não é cosmética: ela desbloqueia uma combinação de precisão de raciocínio + execução de ações externas que antes simplesmente não funcionava de forma confiável na produção.
Na Metrik, já testamos a stack n8n 2.40.0 + Claude Fable 5.1 com Extended Thinking em fluxos de qualificação de leads para imobiliárias. O resultado foi uma melhora de 34% na taxa de respostas corretas em comparação com o modelo padrão sem thinking. O custo extra em tokens de raciocínio se paga facilmente quando o agente evita qualificar erroneamente um lead de alto valor — ou quando evita escalar um lead frio para um consultor humano desnecessariamente.
Para automação comercial no modelo Product Service — onde a stack de IA é parte do serviço entregue ao cliente — essa correção representa uma expansão real do que é possível construir. Agentes que raciocinam antes de agir são agentes que erram menos, e agentes que erram menos constroem confiança com os clientes finais.
Resumo executivo: n8n 2.40.0 (15/09/2026) corrige o bug que impedia o uso de Extended Thinking do Claude com tool calls em agentes. Atualize agora se usa Claude Sonnet 5 ou Fable 5.1 com ferramentas em seus fluxos. A combinação raciocínio + ação agora funciona de ponta a ponta — sem interrupções, sem erros silenciosos.
Se você quer montar essa stack do zero — n8n configurado com Claude, integrado ao Kommo via webhook, com agente de qualificação usando Extended Thinking — o passo a passo está no nosso curso Kommo + Agente Claude Code e no curso de n8n do Zero ao Avançado na Metrik Academy.