llms.txt para sites de documentação
Publicado:
Sites de documentação são o caso de uso ideal para llms.txt: as pessoas constantemente perguntam às ferramentas de IA "como faço X no seu produto", e um arquivo curado aponta esses modelos diretamente para as páginas certas.
Por que a documentação se beneficia mais
Sua documentação já é a resposta. O llms.txt permite que você entregue ao modelo um índice limpo dela — primeiros passos, guias, referência da API — em vez de deixá-lo rastrear navegação, interfaces de busca e páginas de marketing.
Gere-o a partir da sua estrutura
A maioria dos sites de documentação já tem um sitemap.xml. Agrupe essas URLs em algumas seções coerentes em vez de despejá-las de forma plana:
# Acme Docs > Documentation for the Acme API: setup, guides, and the full endpoint reference. ## Getting started - [Quickstart](https://acme.com/docs/quickstart): First request in 5 minutes - [Authentication](https://acme.com/docs/auth): API keys and scopes ## Reference - [Endpoints](https://acme.com/docs/api): Every endpoint and parameter ## Optional - [Changelog](https://acme.com/docs/changelog): Release history
Vincule as versões em Markdown
Muitos frameworks de documentação (Docusaurus, MkDocs, Mintlify, GitBook e outros) conseguem servir uma versão em Markdown ou texto puro de cada página. Vincule essas versões — page.md — para que os modelos processem conteúdo limpo em vez de HTML renderizado com navegação e barras laterais.
Adicione llms-full.txt para contexto completo
Para conjuntos de documentação maiores, publique um arquivo complementar llms-full.txt com o texto completo embutido, para que um agente consiga ingerir tudo em uma única requisição. Mantenha o llms.txt como o índice conciso.
Faça a curadoria e depois valide
Quer você escreva o arquivo à mão ou o gere a partir de um plugin, revise o resultado — os geradores automáticos tendem a incluir conteúdo demais. Veja exemplos de llms.txt para conhecer os padrões e depois valide para confirmar a estrutura e que cada link resolve corretamente.