Seu RAG de suporte responde com informação desatualizada?
Documentação que ninguém mantém envelhece em dias. E um RAG alimentado por doc velha responde errado. O reparo é manter a doc no ritmo do código.
O problema
Uma empresa pequena atende uma base de clientes maior do que a equipe dá conta na mão. Uma saída comum é automatizar o suporte com um RAG — um assistente que responde a partir de uma documentação interna sobre como o sistema funciona.
O problema aparece rápido: ninguém é dono da documentação. Em um time que lança ou muda features quase todo dia, a doc envelhece em questão de dias. E um RAG alimentado por doc velha não fica em silêncio — ele responde com confiança a informação errada.
Tem ainda um segundo fio solto: parte dos "erros" que o cliente relata vêm de serviços externos, não do produto. Sem isso documentado, cada caso volta para o suporte humano diagnosticar do zero.
A doc é a primeira coisa que a gente esquece de atualizar. Aí o robô começa a mentir.
Por que isso acontece
A causa raiz não é preguiça — é que manter a doc é um trabalho invisível, sem dono, competindo com o roadmap. Todo mundo prioriza a feature; ninguém prioriza descrever a feature.
Enquanto a documentação depende de um gesto manual separado do código, ela sempre vai correr atrás. O reparo é fazer a doc andar no mesmo ritmo em que o código muda.
Como resolvemos
- 01
Cada mudança no código dispara o fluxo
Ao abrir um PR, um processo começa sozinho. A mudança no código é o gatilho — não uma tarefa extra que alguém precisa lembrar.
- 02
Um agente lê o que mudou e escreve a doc
O agente entende o que o PR alterou e gera ou atualiza o trecho de documentação correspondente. Ele tem acesso ao código, mas não a segredos da operação.
- 03
Um validador barra informação sensível
Antes de qualquer publicação, uma verificação garante que nada de confidencial — credenciais, dados sensíveis — vá parar na doc.
- 04
Uma pessoa aprova antes de publicar
O texto gerado vira rascunho e vai para alguém do time revisar. Só depois do aval humano entra no RAG. O agente nunca publica sozinho.
A aprovação humana não é burocracia: o custo de uma doc errada no RAG é alto, o de uma revisão de alguns minutos é baixo. Por baixo, é uma integração com o fluxo de código, um agente de escrita, uma checagem de segurança e um passo de aprovação. Automático onde é seguro, humano onde importa.
- A doc envelhecia em dias após cada release
- O RAG respondia com informação velha, com confiança
- O suporte humano gastava tempo reexplicando o que mudou
- A doc é atualizada no ritmo do código, a cada PR
- O RAG responde com a informação corrente do produto
- O suporte foca em problemas novos, não em corrigir o passado
A documentação passou a acompanhar o código no mesmo dia — com uma pessoa aprovando no caminho. O RAG deixou de responder com informação velha.
Você reconhece isso na sua operação?
- Sua base de conhecimento (ou FAQ, ou RAG) vive atrás do que o produto virou
- Ninguém é, de fato, dono de manter a documentação
- O suporte reexplica as mesmas mudanças recentes toda semana
- Você quer automatizar respostas, mas tem medo de automatizar respostas erradas