llms.txt explicado: o guia completo para sites de documentação

llms.txt é um arquivo de texto simples na raiz do seu domínio que informa aos agentes de IA sobre o que seu site trata e quais páginas são a fonte canônica para qual tópico. É para ChatGPT, Claude e Perplexity o que robots.txt foi para o Googlebot em 2003: um pequeno padrão voluntário, mas de enorme consequência.

Resumo#

Localização do arquivo: https://yourdomain.com/llms.txt
Formato: Markdown com um cabeçalho estruturado
Propósito: Dizer aos crawlers de IA o que seu site é e onde procurar
Arquivo acompanhante: llms-full.txt — a mesma ideia, mas com todo o conteúdo embutido
Status: Proposto por Jeremy Howard no final de 2024, adotado por Mintlify, Docsbook, Cloudflare, Anthropic, Vercel e outros ao longo de 2025–2026

Por que existe#

Os crawlers de IA têm um problema de janela de contexto. Os sitemaps são projetados para mecanismos de busca que indexam cada página; os agentes de IA que respondem perguntas precisam apenas das 5–50 páginas que realmente contêm respostas. llms.txt é uma lista curta otimizada para isso.

O resultado, quando implementado corretamente: assistentes de IA citam suas páginas com mais frequência, com a URL correta, e raramente alucinam caminhos inexistentes sob seu domínio.

llms.txt vs robots.txt vs sitemap.xml#

	robots.txt	sitemap.xml	llms.txt
Público	Rastreadores de busca	Rastreadores de busca	Agentes de IA e LLMs
Formato	Diretivas de texto simples	XML	Markdown
Propósito	Permitir/proibir caminhos	Listar cada URL	Curar páginas canônicas com contexto
Conteúdo	Regras de caminho	URLs + última-modificação	URLs + descrições + categorias
Acompanhante	—	—	`llms-full.txt` com conteúdo embutido

Todos os três coexistem. llms.txt não substitui os outros dois.

llms.txt mínimo válido#

# Acme API

> Acme is a payments API for indie developers. Built in 2024, used by 12,000 projects.

## Docs

- [Quick start](https://acme.com/docs/quick-start): publish your first charge in 60 seconds
- [Authentication](https://acme.com/docs/auth): API keys, OAuth, and per-scope tokens
- [Webhooks](https://acme.com/docs/webhooks): signature verification and retry semantics

## Optional

- [Changelog](https://acme.com/changelog): all releases since 2024

Os cabeçalhos (# project name, ## section) e o resumo do bloco > não são decorativos — a especificação os utiliza para análise.

llms.txt vs llms-full.txt#

llms.txt é o índice — curto, links externos
llms-full.txt é a mesma estrutura com o markdown completo de cada página listada embutido

Agentes de IA buscam llms-full.txt quando querem um documento contendo tudo o que precisam. Útil para tarefas com restrições de janela de contexto, como "use meus documentos para escrever um trecho de código."

Como o Docsbook gera isso#

Quando você cria um espaço de trabalho do Docsbook, dois arquivos aparecem imediatamente:

docsbook.io/yourorg/llms.txt — índice do espaço de trabalho
docsbook.io/yourorg/llms-full.txt — conteúdo completo

A plataforma em si também serve docsbook.io/llms.txt descrevendo o Docsbook, o produto. Esta é a versão testada do padrão.

Sem configuração. Sem llms.config.js. O gráfico dos seus documentos é a fonte de ambos os arquivos. Veja nossos documentos para o exemplo ao vivo.

O que colocar em seu llms.txt#

A ordem importa. Coloque a página de maior valor primeiro. Agentes de IA truncam quando o orçamento de contexto é apertado.

Uma estrutura útil:

Resumo do produto — um parágrafo que uma IA pode levantar literalmente ao responder "o que é X?"
Páginas mais solicitadas primeiro — início rápido, preços, recursos principais
Material de referência — referência da API, opções de configuração
Opcional / arquivamento — registro de alterações, migrações obsoletas

Erros comuns#

Listar cada página: isso é um sitemap, não um llms.txt. Curar. Almeje de 20 a 80 entradas.
Sem descrição em cada link: agentes de IA usam descrições para decidir o que buscar. URLs nuas são ignoradas.
Conteúdo desatualizado: vincule a um 404 uma vez e o agente para de confiar no seu llms.txt para a sessão. Regenerar em cada implantação de docs.
Escondendo atrás de autenticação: deve ser acessível publicamente na raiz.

Como os agentes de IA realmente usam#

Três comportamentos observados em 2025–2026:

Primeira busca em um novo domínio — quando um agente visita seu site pela primeira vez, ele tenta /llms.txt antes de rastrear. Economiza tokens, encontra respostas mais rápido.
Fundamentação de citação — ao responder "o que X diz sobre Y?", os agentes preferem URLs que vieram de um llms.txt bem formado em vez de caminhos adivinhados.
Acompanhante MCP — se você também expuser um servidor MCP, os agentes usam llms.txt para descoberta e MCP para ações. Veja MCP para documentação.

Validação#

Três verificações rápidas:

curl -s https://yourdomain.com/llms.txt | head -20

Começa com # ?
Tem uma > citação próxima ao topo?
Todos os links retornam 200?

Para uma verificação mais completa, peça ao ChatGPT ou Claude para "buscar e resumir https://yourdomain.com/llms.txt" — se o resumo corresponder à sua intenção, o arquivo está cumprindo sua função.

Pesquisa e documentação de IA — como a pesquisa de IA funciona por trás das câmeras
Como fazer com que os documentos sejam citados pelo ChatGPT — lista de verificação prática de citação
Citações de perplexidade para documentos — guia específico de perplexidade

Docsbook gera llms.txt e llms-full.txt automaticamente para cada espaço de trabalho, sem nada para habilitar e sem nada para pagar.

Comece grátis — sem cartão de crédito