Um agente de suporte com IA baseado em RAG (geração aumentada por recuperação) não inventa respostas — encontra a passagem mais relevante da sua documentação e responde a partir dela. O que significa que o teto de qualidade do seu suporte com IA é exatamente a qualidade da sua documentação.
A boa notícia: a documentação que funciona bem para a recuperação por IA é a mesma que funciona bem para pessoas impacientes. Eis o que faz realmente a diferença.
1. Escreva títulos em forma de resposta
A recuperação funciona pelo significado, mas começa pela estrutura. Uma secção intitulada «Faturação» não corresponde a nada de específico. Uma secção intitulada «Como cancelo a minha subscrição?» corresponde exatamente às palavras que um utilizador frustrado escreve à meia-noite.
Reveja os seus títulos: se não consegue imaginar um utilizador a escrevê-lo como pergunta, reescreva-o como uma.
2. Um tema por secção
Os documentos são divididos em fragmentos antes de serem indexados. Uma secção que aborda de uma só vez reembolsos, mudanças de plano e faturas torna-se um fragmento confuso que corresponde a meias a tudo e não responde completamente a nada.
Mantenha as secções curtas e com um único objetivo. Se um parágrafo começa com «Além disso,», provavelmente quer ser uma secção própria.
3. Use as palavras que os seus utilizadores usam
Você diz «espaço de trabalho», os seus utilizadores dizem «conta». Você diz «credenciais de autenticação», eles dizem «palavra-passe». A pesquisa semântica cobre parte dessa distância, mas cada passo de tradução custa precisão.
Vá buscar o vocabulário diretamente a e-mails de suporte reais — são um corpus gratuito da forma como os seus utilizadores dizem realmente as coisas.
4. Indique limites e preços como factos, num só sítio
As perguntas mais perigosas para um agente de IA são as que envolvem números: preços, quotas, prazos. Se os seus preços aparecem em quatro sítios com três valores diferentes, a IA acabará por citar o desatualizado.
Mantenha uma única secção de referência para preços e limites e atualize-a assim que algo mudar. Em todos os outros sítios, coloque uma ligação para ela em vez de a repetir.
5. Não esconda respostas em capturas de ecrã
O texto dentro de imagens é invisível para a recuperação. Uma captura de ecrã da sua página de definições com uma seta a apontar para o botão de exportação não responde a nada — a frase «Vá a Definições → Dados → Exportar para transferir os seus dados em CSV» responde para sempre.
As capturas de ecrã são ótimas como ilustração. Garanta apenas que as palavras também existem como palavras.
6. Deixe que as lacunas lhe digam o que escrever a seguir
Nunca vai prever todas as perguntas com antecedência — e não precisa. O relatório de lacunas de conhecimento do Resply lista as perguntas a que a IA não conseguiu responder com confiança, ordenadas pela frequência com que surgem.
Isso transforma a documentação de um jogo de adivinhas num ciclo de feedback: verifique as lacunas todas as semanas, escreva uma vez a resposta em falta e veja essa pergunta desaparecer da sua caixa de entrada. Vinte minutos por semana chegam para manter a taxa de resolução da IA a subir.
Nada disto exige um redator técnico. Secções curtas, perguntas reais como títulos, o vocabulário dos seus utilizadores e uma vista de olhos semanal às lacunas — é todo o manual.