RAG é a técnica que faz o agente responder com base nos seus documentos, e não só no que o modelo aprendeu no treinamento. O nome vem de geração aumentada por recuperação, e o mecanismo é simples de entender: antes de responder, o sistema busca os trechos relevantes na sua base e entrega esses trechos ao modelo junto com a pergunta. Sem isso, o agente inventa — não por má-fé, mas porque foi treinado para sempre produzir uma resposta.
Adicione ao Google NotíciasNeste artigo
O problema que ele resolve
Pergunte a qualquer modelo qual é a política de troca da sua loja. Ele vai responder. E a resposta vai estar errada, porque ele nunca viu essa política — vai produzir algo plausível, que é o comportamento esperado dele.
Duas formas de resolver isso:
Colocar tudo na instrução. Funciona quando a informação é pequena e estável. Para um manual de duzentas páginas, não funciona: estoura o limite de contexto, encarece cada chamada e piora a qualidade, porque o modelo se perde em texto irrelevante.
Buscar só o pedaço relevante. É o RAG. Em vez de mandar o manual inteiro, manda-se os três parágrafos que respondem àquela pergunta.
Como funciona, em duas fases
Fase 1 — Preparar a base (uma vez)
Carregar os documentos: PDF, páginas, planilhas, artigos.
Dividir em pedaços menores, porque documento inteiro é grande demais para ser útil como contexto.
Converter cada pedaço em vetor — uma representação numérica do significado.
Guardar esses vetores num banco vetorial.
Fase 2 — Responder (a cada pergunta)
A pergunta do usuário também vira vetor.
O sistema busca no banco os trechos com significado mais próximo.
Esses trechos são entregues ao modelo junto com a pergunta.
O modelo responde usando esse material.

Por que vetor e não busca por palavra
Aqui está o motivo de toda essa maquinaria existir.
Busca tradicional procura as palavras exatas. Se o cliente pergunta "posso devolver?" e o seu manual usa "política de restituição", a busca por palavra não encontra nada.
A busca vetorial trabalha por significado. Como a documentação explica, o banco vetorial armazena a informação como conjuntos de números que representam características do texto, o que permite buscar por proximidade semântica em vez de correspondência literal. "Devolver" e "restituição" ficam próximos nesse espaço, mesmo sem compartilhar uma letra.
É o mesmo princípio de recomendação por semelhança: sistemas que sugerem pratos parecidos a partir de uma foto usam a mesma ideia — comparar representações numéricas, não rótulos.
Onde o RAG falha
Vale conhecer antes de culpar o modelo:
Pedaços mal dimensionados. Se o corte separou a pergunta da resposta, o trecho recuperado não serve. É a causa número um de resposta ruim com base própria — e assunto da aula sobre divisão de texto.
A informação não está na base. O sistema recupera o mais próximo que existe, mesmo quando nada responde de verdade. O modelo então usa material irrelevante e responde errado com convicção.
Base desatualizada. Documento mudou e ninguém reprocessou. O agente responde com a versão antiga, com toda a segurança do mundo.
Pergunta ambígua. "Quanto custa?" sem dizer o quê recupera qualquer coisa que fale de preço.
A proteção que muda tudo
Uma instrução simples reduz drasticamente a invenção:
Sem isso, o modelo mistura o que recuperou com o que "acha" — e o resultado fica pior que não ter RAG, porque parece fundamentado.
Teste sempre com perguntas cuja resposta não está na base. Um sistema saudável responde "não tenho essa informação". Um sistema mal configurado inventa — e você só descobre quando um cliente cobra o que o robô prometeu.
RAG busca os trechos relevantes da sua base e entrega ao modelo junto com a pergunta. Funciona por significado, não por palavra. E precisa de instrução explícita para admitir quando não sabe.
Perguntas frequentes
O que é RAG no n8n?
É a técnica de buscar trechos relevantes de uma base própria e entregá-los ao modelo junto com a pergunta, para que a resposta se apoie nos seus documentos em vez do conhecimento genérico do treinamento.
Por que não colocar tudo na instrução do agente?
Funciona apenas para volumes pequenos. Conteúdos grandes estouram o limite de contexto, encarecem cada chamada e pioram a qualidade, porque o modelo se perde em material irrelevante à pergunta.
Por que usar banco vetorial em vez de busca por palavra?
Porque a busca vetorial encontra por significado. Se o usuário pergunta com palavras diferentes das que estão no documento, a busca literal não acha nada, enquanto a busca por proximidade semântica encontra o trecho correto.
Por que o agente responde errado mesmo com RAG?
As causas mais comuns são divisão inadequada dos documentos, que separa pergunta e resposta em pedaços distintos; ausência da informação na base, o que faz o sistema recuperar o trecho mais próximo ainda que irrelevante; e base desatualizada.
Como impedir o agente de inventar?
Com instrução explícita para responder apenas com base nos trechos recuperados e admitir quando a informação não estiver disponível. E testando com perguntas cuja resposta não existe na base, para confirmar que ele realmente admite não saber.
Este tutorial faz parte do guia Curso de n8n do zero ao avançado: o guia completo em português. Veja também: Node, trigger e workflow: o vocabulário do n8n em 10 minutos · A estrutura de dados do n8n: por que tudo é um array com json · Item linking no n8n: como ele decide qual item vai pra saída · Execuções passo a passo: como achar onde o fluxo do n8n quebrou · A Canvas UI do n8n 2.0: o que mudou e como se orientar · n8n Cloud ou self-hosted: a decisão que define seu custo e sua liberdade




