Guia
Como dar ao seu bot de suporte e aos agentes de IA uma única fonte da verdade para a documentação do produto
Escolha um documento canônico para cada fato do produto — especificações, limites, planos, políticas —, publique-o em um link permanente, em um formato de texto que as ferramentas de IA leiam bem, e aponte seu bot de suporte, seus agentes internos e os crawlers de IA públicos para esse link em vez de para cópias. Mantenha-o versionado e atualize-o no mesmo lugar, para que todos os bots respondam a partir do mesmo conteúdo atual e conferido.
Por que os bots dão respostas diferentes
Um bot de suporte responde com base no que recebeu: uma exportação da central de ajuda, uma ficha técnica antiga em PDF, uma página de wiki que alguém copiou no ano passado. Os assistentes públicos respondem com base no que encontraram na web. Quando o mesmo fato está em cinco lugares, cada bot escolhe um diferente.
O resultado é um bot que cita um limite descontinuado, um preço do ano passado ou um recurso que só existe em um plano — e um cliente que confia nele.
Defina qual é a fonte da verdade
Todas as outras cópias — slides, e-mails de onboarding, apresentações de vendas — devem apontar para o documento canônico em vez de repetir o conteúdo.
| Tipo de fato | Documento canônico | Responsável |
|---|---|---|
| Especificações e limites | Ficha técnica por produto | Produto |
| Planos e preços | Documento de planos | Marketing de produto / finanças |
| Políticas (reembolsos, SLA, dados) | Documento de política | Jurídico / suporte |
| Tutoriais e solução de problemas | Artigos da central de ajuda | Suporte / documentação |
| Mudanças de versão | Changelog | Produto |
Escreva documentação a partir da qual os bots respondam corretamente
- Um fato, um lugar, uma redação. Não repita limites em três artigos.
- Escreva limites e números com unidades e escopo: “Até 10 GB por workspace no plano Team”.
- Diga a qual plano, versão ou região uma afirmação se aplica.
- Coloque data nos fatos que mudam e identifique claramente os recursos descontinuados.
- Use títulos e tabelas reais; evite capturas de tela de configurações ou tabelas.
- Dê a cada documento um resumo curto no topo que responda à pergunta mais comum.
Conecte os bots à fonte
- Aponte a fonte de conhecimento do seu bot de suporte para os documentos canônicos, de preferência em Markdown ou JSON em vez de PDFs.
- Publique um índice do data room (llms.txt) que liste seus documentos canônicos, para que as ferramentas de IA externas possam descobri-los.
- Sincronize o bot novamente sempre que um documento canônico mudar, ou faça-o ler o link ao vivo.
- Revise as transcrições do bot em busca de respostas que não remetam a um documento canônico.
Onde The Papers se encaixa
The Papers publica cada documento canônico como uma Versão IA em uma URL permanente: uma página para pessoas, Markdown com front matter (URL canônica, versão, status, Prontidão para IA) e JSON com blocos, métricas e a procedência de cada página. Um índice do Data Room em /{room}/llms.txt e /{room}/index.md lista todos os documentos.
Antes da publicação, cada número, data e período precisa corresponder à fonte, e ressalvas como “até” continuam vinculadas. Atualizar um documento mantém a URL e o histórico de versões, então o bot e os assistentes públicos sempre leem a versão atual. As análises mostram quais agentes, crawlers e ferramentas de IA leem cada documento e em qual formato.
Documentos públicos podem ser listados e indexáveis, e um domínio personalizado como ai.suaempresa.com mantém o data room no seu próprio endereço. A solução é indicada para seus principais documentos de referência; ela não foi feita para a conversão em massa de um arquivo inteiro sem verificação documento por documento.
Perguntas frequentes
- A própria central de ajuda deve ser a fonte da verdade?
- Para conteúdo de tutoriais, muitas vezes sim. Para fatos concretos como limites, planos e políticas, um único documento canônico para o qual os artigos de ajuda apontem é mais fácil de manter correto.
- Qual formato um bot de suporte deve ler?
- Formatos de texto como Markdown ou JSON são mais fáceis para a recuperação e menos sujeitos a erros do que PDFs. The Papers publica os dois para cada documento.
- Como os assistentes de IA públicos encontram nossos documentos?
- Torne os documentos canônicos públicos e indexáveis e liste-os em um índice llms.txt para que as ferramentas e os crawlers de IA possam descobri-los.
- O que acontece com os links quando um documento muda?
- Com The Papers, a URL continua a mesma e o histórico de versões é mantido, então nada que aponte para ela quebra.
Dê a todos os bots e agentes os mesmos fatos atuais do produto, em um link permanente.
Guias relacionados
- Uma única fonte da verdade para agentes de IA: por que um link é melhor que anexos
- O que é llms.txt e como usá-lo para os seus documentos?
- Como tornar tabelas de preços e fichas técnicas legíveis pela IA do comprador
- The Papers: data room legível por IA para founders de startups que compartilham decks com investidores