RAG com n8n: carregar documentos e consultar uma base de conhecimento em um fluxo

Publicado em 2026-11-16 por ArduBot

Design prático de automações n8n para alimentar um RAG a partir de arquivos e consultá-lo via webhooks, com retentativas e controle de duplicados.

Um chatbot recebe a mesma pergunta todos os dias e alguém tem que colar informações atualizadas nele novamente. Com o n8n, você pode orquestrar o carregamento de documentos e a consulta de um índice RAG, sem transformar cada alteração de conteúdo em uma tarefa manual de programação.

Dois fluxos, não um só

Convém separar ingestão e consulta. A ingestão é acionada quando uma fonte muda: um PDF enviado para uma pasta, uma página modificada ou uma notificação de um CMS. A consulta é executada quando chega a pergunta de um usuário. Se você misturar ambos, poderá reprocessar toda a biblioteca em cada mensagem.

Fluxo de ingestão conceitual:

Trigger de cambio -> validar fuente -> extraer texto
-> normalizar y dividir -> servicio de indexación RAG
-> registrar versión, resultado y errores
Fluxo de consulta:
Webhook -> autenticar usuario -> buscar evidencia en RAG
-> comprobar si es suficiente -> opcional: generar respuesta
-> devolver resultado y fuente
Os nós exatos e as credenciais dependem da instância do n8n e do serviço de busca escolhido. Não pressupõe que exista hoje um nó RAG próprio do ArduMaker.

Quais dados salvar por documento

Conserve um identificador estável da fonte, sua versão ou hash, última data de alteração, idioma, permissão e status do processamento. Se o sistema receber o mesmo evento três vezes, uma chave de idempotência evita multiplicar fragmentos. Se o arquivo for excluído, o fluxo deve remover seus fragmentos, não apenas parar de atualizá-lo.

Em documentos de trabalho, um fluxo que sempre adiciona conteúdo sem excluir versões anteriores acaba respondendo políticas obsoletas.

Erros que você precisa considerar

Um OCR pode falhar, um link pode retornar 403, um provedor de embeddings pode responder 429 ou o servidor pode encerrar a conexão. Não convém tentar indefinidamente: use limites, espera progressiva e uma fila de revisão. Salve a falha e permita a reexecução controlada.

Para consultas, decida o que acontece quando a busca estiver indisponível. A resposta correta pode ser “não consigo consultar a documentação agora” em vez de usar um texto antigo ou inventar uma política.

Caso realista: suporte de uma loja

A loja administra guias de tamanhos, perguntas frequentes e condições de envio. Um fluxo é executado ao editar esses documentos. Quando uma pergunta entra no formulário, outro fluxo recupera os fragmentos pertinentes. Se o resultado contiver a regra de tamanhos, o bot a explica e oferece a referência; se alguém consultar o status de seu pedido, o correto é chamar a API de pedidos autenticada, não adivinhar pelo RAG.

Esta distinção entre conhecimento documental e dados transacionais evita erros de design.

Como saberia se funcionou

Durante duas semanas, registre quantas atualizações foram sincronizadas corretamente, quanto tempo levaram para ficar consultáveis e qual porcentagem de perguntas encontrou uma fonte apropriada. Adicione testes de mudança: modifique uma política e verifique se a versão anterior deixa de aparecer.

Experimento ArduMaker: estamos estudando um nó que receba fontes e forneça busca por API para integrações como n8n. Se o seu fluxo requer PDF, web ou bancos internos, conte-nos qual gatilho e qual volume ele manejaria através do ArduMaker.

Leituras úteis: Documentação do n8n · Arquitetura RAG da Microsoft · RAG híbrido no ArduMaker.

  • RAG
  • n8n
  • automatización
  • webhooks
  • IA

No ArduMaker

  • VPS com n8n: Automações com workers em modo fila, Postgres e Redis incluídos, domínio com HTTPS e atualizações com rollback.

Continuar lendo

Todos os artigos · Planos VPS