InícioGuias › agentes-ia
Guia

n8n e LangChain: como usar IA avançada nos seus fluxos (guia 2026)

Atualizado em 2026-07-12 · por Redação Automação Hoje
Desenvolvedora brasileira montando fluxo de IA com nós LangChain no n8n na tela do notebook
Resposta rápida: O n8n embute a arquitetura da LangChain em nós visuais: você arrasta um AI Agent, pluga um modelo de linguagem e conecta sub-nós de memória, ferramentas e vector store. Para tarefas simples de texto, usa uma chain; para decisões e múltiplos passos, o agente; e quando falta um recurso pronto, escreve LangChain na mão com o nó LangChain Code.
· espaço publicitário ·
Em resumo
  • Desde o n8n 2.0 (janeiro de 2026), a LangChain vem integrada em mais de 70 nós de IA — modelos, memória, chains, agentes, embeddings e vector stores.
  • Basic LLM Chain é o caminho mais simples: prompt entra, texto sai. Sem memória, sem ferramentas.
  • O AI Agent decide sozinho quais ferramentas chamar num loop de raciocínio, e é o único que suporta memória de conversa.
  • Vector store (Pinecone, Qdrant, Supabase, PGVector e outros) dá ao agente acesso aos seus próprios documentos via RAG.
  • O nó LangChain Code libera código bruto quando o canvas visual não cobre o recurso que você precisa.
  1. Escolha entre chain e agente antes de arrastar qualquer nó

    Essa decisão define todo o resto do fluxo. Se a tarefa é uma transformação previsível de texto — traduzir, resumir, classificar, reformatar — use uma Basic LLM Chain. É uma linha reta: prompt na entrada, texto na saída, sem memória e sem acesso a ferramentas. Se o fluxo precisa tomar decisões, encadear vários passos ou lidar com entradas imprevisíveis, o AI Agent é o nó certo. Regra prática: precisa de memória de conversa? Então é agente, não chain.

  2. Monte a base do AI Agent

    Arraste o nó AI Agent para o canvas e conecte um gatilho na frente dele — um Chat Trigger para conversa ou um Webhook para acionar por API. O agente sozinho não faz nada: ele é a camada de orquestração. É nos sub-nós que a inteligência mora. No n8n, as conexões de IA usam um sistema de tipos próprio (AI Language Model, AI Memory, AI Tool, AI Retriever, AI Embedding), separado do fluxo de dados normal — por isso os conectores têm cores e formatos diferentes.

  3. Pendure o modelo de linguagem

    Conecte um sub-nó de Chat Model no conector inferior do agente. Pode ser OpenAI, Anthropic (Claude), Google ou qualquer modelo compatível com tool-calling. O AI Agent do n8n é, na prática, um Tools Agent: ele usa a interface de chamada de ferramentas do modelo para decidir, a cada passo, o que executar. Modelos que não suportam function calling não rodam bem nesse nó.

  4. Dê memória ao agente

    Sem memória, cada mensagem chega como se fosse a primeira. Conecte o sub-nó Simple Memory para começar — ele guarda as mensagens recentes dentro do próprio n8n, sem serviço externo. Quando o fluxo precisar sobreviver a reinícios ou escalar para muitas sessões simultâneas, troque por um backend persistente: Postgres, Redis, MongoDB, Motorhead ou Zep. A memória dá recall da conversa atual; ela não substitui os documentos.

  5. Conecte ferramentas para o agente agir

    Aqui o agente deixa de só conversar e passa a executar. Ligue sub-nós de ferramenta no conector AI Tool — pode ser uma chamada HTTP, uma consulta em planilha, um envio de e-mail ou até outro workflow. Em 2026, o n8n adicionou o MCP Client Tool (para usar ferramentas de qualquer servidor MCP) e o AI Agent Tool (um agente supervisionando outros no mesmo canvas). O modelo escolhe qual ferramenta chamar em tempo de execução.

  6. Ancore o agente nos seus documentos com vector store

    Para o agente responder sobre a sua base de conhecimento, você guarda os embeddings dos documentos num banco vetorial e deixa o agente consultar. O n8n conecta com Pinecone, Qdrant, Chroma, Milvus, PGVector, Redis, Supabase, Weaviate e Zep. Para testar rápido, o nó Simple Vector Store roda na memória e liga direto no conector de ferramenta do agente. Se o objetivo é só perguntar sobre documentos, sem ações, a Question and Answer Chain faz esse RAG básico com menos peças.

  7. Quando faltar nó pronto, use o LangChain Code

    O canvas cobre a maioria dos casos, mas não todos. O nó LangChain Code deixa você importar funcionalidade da biblioteca que o n8n ainda não transformou em nó — uma chain customizada, um parser específico, um encadeamento fora do padrão. Configurando os conectores, ele funciona como nó normal, root ou sub-nó. É a válvula de escape para controle total quando o agente visual não entrega o que você precisa.

O que mudou com o n8n 2.0

Até pouco tempo atrás, integrar LangChain num fluxo do n8n era mais improviso do que método. Isso virou de vez com o n8n 2.0, lançado em janeiro de 2026, que trouxe a arquitetura completa de agentes e chains da LangChain para dentro do canvas visual — mais de 70 nós de IA cobrindo modelos, memória, chains, agentes, embeddings, vector stores e output parsers.

O ponto forte não é a quantidade de nós, é o modelo mental. Você monta um pipeline agêntico de produção sem escrever código de aplicação, arrastando peças e conectando conectores tipados. Para quem vem do zero em automação, vale entender antes o básico da ferramenta — o guia de fundamentos ajuda a não se perder nos conceitos.

Chain, agente ou código: o mapa de decisão

A confusão mais comum de quem começa é jogar tudo no AI Agent, inclusive tarefas que uma chain simples resolveria com metade do custo e o dobro da previsibilidade. Um agente carrega loop de raciocínio, memória e ferramentas — poder que você paga em tokens e em imprevisibilidade. Nem toda tarefa merece isso.

Use a tabela abaixo como filtro antes de montar qualquer fluxo. A pergunta central é sempre a mesma: o resultado precisa ser decidido em tempo real pelo modelo, ou é um caminho fixo que você já conhece?

ComponentePara que serveQuando escolher
Basic LLM ChainPrompt entra, texto sai — sem memória nem ferramentasTraduzir, resumir, classificar, reformatar texto
Question and Answer ChainRAG básico: busca no vector store e responde só com o que achouPerguntas sobre documentos específicos, sem ações
AI Agent (Tools Agent)Loop de raciocínio, memória e escolha de ferramentasDecisões, múltiplos passos, conversa contínua, entradas imprevisíveis
LangChain CodeCódigo bruto da LangChain dentro do nóRecurso que o canvas visual não oferece

Erros que aparecem no primeiro fluxo

Três tropeços se repetem. O primeiro: esquecer a memória e não entender por que o agente 'não lembra' do que foi dito duas mensagens atrás — sem o sub-nó de memória, não existe histórico. O segundo: confundir memória com base de conhecimento. Memória é a conversa atual; vector store são os seus documentos. São conectores diferentes por um motivo.

O terceiro é escolher um modelo sem tool-calling e não entender por que as ferramentas nunca disparam. O AI Agent depende da interface de chamada de ferramentas do modelo — se o modelo não suporta, o agente vira um chat caro. Antes de investir em fluxos multi-agente mais sofisticados, vale dominar o agente único e, se o volume crescer, avaliar quando trocar de plataforma faz sentido.

Perguntas frequentes

Preciso saber programar para usar LangChain no n8n?
Não para a maioria dos casos. Desde o n8n 2.0, os nós visuais cobrem agentes, chains, memória e vector stores sem código. Programação só entra no nó LangChain Code, reservado para recursos que o canvas ainda não oferece.
Qual a diferença entre AI Agent e Basic LLM Chain?
A chain é uma linha reta: prompt na entrada, texto na saída, sem memória nem ferramentas. O agente raciocina em loop, decide quais ferramentas chamar e mantém memória da conversa. Use a chain para transformar texto e o agente para tomar decisões.
O nó de LangChain foi removido em alguma atualização do n8n?
Não foi removido — foi reorganizado. Com o n8n 2.0, a funcionalidade virou um conjunto de nós dedicados (AI Agent, chains, LangChain Code e outros). Se você não acha o nó antigo, procure pelos novos nós de IA na categoria correspondente.
Como o agente acessa meus próprios documentos?
Via vector store. Você gera embeddings dos documentos, guarda num banco vetorial (Pinecone, Qdrant, Supabase, PGVector, entre outros) e conecta ao agente pelo conector de ferramenta. Ele consulta essa base quando a resposta exige o seu conteúdo.

Leia também