llms.txt em 2026: versão 2, exemplo e teste de uso
llms.txt é uma proposta opcional de índice em Markdown para consumidores que usam esse formato. A versão 2 admite raiz e subcaminhos. Sua utilidade deve ser testada em uma tarefa real de documentação; publicação, acesso e citação são eventos distintos.
Quando vale manter um llms.txt?
Uma equipe de documentação pode oferecer um índice enxuto para um agente que precisa localizar referências de uma biblioteca. Esse uso tem um consumidor, uma tarefa e um resultado verificável. Publicar o arquivo apenas porque alguém prometeu mais citações não oferece o mesmo critério de decisão.
A proposta llms.txt, versão 2, atualizada em 10 de agosto de 2026, descreve um índice em Markdown. Continua sendo uma proposta de comunidade. No trabalho de GEO (Generative Engine Optimization), ela pode servir à organização de documentação quando houver uso conhecido, mas não constitui requisito universal dos motores.
O Google informa que não usa llms.txt para melhorar visibilidade ou ranking em Search. Antes de acrescentar arquivos, resolva informações erradas, links quebrados e dificuldades de navegação da documentação principal.
O que mudou na proposta e como escolher o caminho?
A versão 2 admite o arquivo na raiz ou em um subcaminho, como /docs/llms.txt. O escopo acompanha esse caminho; quando mais de um índice se aplica, a proposta orienta usar o mais específico. Isso permite manter o índice perto da documentação que uma equipe controla.
A única seção obrigatória é um título H1 com o nome do projeto. Resumo em bloco de citação, detalhes e listas de links organizadas por H2 são opcionais. A proposta também admite BOM opcional. Não há campos obrigatórios chamados Topics, Organization ou Update-Frequency.
Como construir um índice pequeno e conferível?
- Defina uma tarefa, como encontrar a regra de autenticação de uma API. Escolha o agente ou cliente que efetivamente usará o índice.
- Selecione referências suficientes para essa tarefa. Prefira documentos mantidos por uma equipe identificada e evite copiar uma lista indiscriminada de URLs.
- Descreva cada link com o assunto e uma condição importante. Não transforme o resumo em uma lista de promessas comerciais.
- Publique no caminho escolhido e confira a resposta HTTP, o conteúdo entregue e cada destino. Um status de sucesso que devolve uma tela de login não atende a uma consulta pública.
- Execute a tarefa de teste com o consumidor e guarde o registro de acesso e a resposta. Repita após alterações nos documentos vinculados.
Exemplo de índice para uma documentação fictícia
O modelo abaixo usa example.com, reservado para exemplos. Os destinos são ilustrativos: substitua-os por documentos existentes e confirmados antes de publicar. Versões Markdown só devem ser listadas quando realmente disponíveis.
# Documentação do Catálogo Exemplo
> Referência de consulta de produtos para integrações autorizadas.
Preços do exemplo não representam uma oferta comercial.
A escrita de pedidos exige autorização fora deste índice.
## Integração
- [Autenticação](https://example.com/docs/autenticacao.md): obtenção e limites de acesso.
- [Consulta de produtos](https://example.com/docs/produtos.md): campos e tratamento de indisponibilidade.
- [Erros](https://example.com/docs/erros.md): respostas de erro e quando tentar novamente.
## Optional
- [Histórico de versões](https://example.com/docs/versoes.md): alterações da documentação.O exemplo usa poucas entradas para tornar a manutenção examinável, não como limite universal de tamanho. Se a tarefa exige outros documentos, acrescente-os com uma justificativa de uso. Um catálogo extenso pode precisar de índices por área.
Como oferecer descoberta sem confundir controles?
A versão 2 recomenda rel="describedby" para indicar o llms.txt correspondente e rel="alternate" type="text/markdown" para uma versão Markdown. Esses vínculos descrevem recursos; não dão permissão de acesso nem substituem autenticação.
<link rel="describedby" href="/docs/llms.txt">
<link rel="alternate" type="text/markdown" href="/docs/produtos.md">| Recurso | Função | Limite |
|---|---|---|
| llms.txt | Organizar referências para consumidores que o utilizem. | Não prova leitura ou citação. |
| robots.txt | Declarar regras de rastreamento para robôs. | Não protege conteúdo privado por autenticação. |
| sitemap.xml | Apresentar URLs para descoberta. | Não garante indexação. |
| Dados estruturados | Descrever informações e relações presentes na página. | Não garantem resposta correta de IA. |
Como testar utilidade sem alegar causalidade?
Defina a pergunta antes do teste: “Onde encontro o campo de disponibilidade e o tratamento de erro da consulta de produtos?”. O consumidor deve localizar os documentos corretos, conservar restrições e indicar as fontes usadas. Registre se consultou o índice e quais links abriu, quando essa informação estiver disponível.
Critério de aceite: todos os links selecionados resolvem para o conteúdo esperado e o consumidor completa a tarefa sem inventar campos ou omitir condições. Se o índice não for usado, registre essa observação. Um acesso ao arquivo não demonstra que ele determinou a resposta; uma resposta melhor após várias mudanças também não isola seu efeito.
A manutenção acompanha mudanças da documentação, com responsável e revisão de links. Para decidir quando esse esforço faz sentido dentro de um programa maior, consulte o curso GEO Universal Framework, de Alexandre Caramaschi.
Perguntas frequentes
O llms.txt precisa ficar na raiz do domínio?
A versão 2 da proposta permite a raiz e subcaminhos, como /docs/llms.txt. Escolha o escopo que corresponde aos documentos mantidos e confira como o consumidor descobre esse arquivo.
É seguro listar documentos internos?
Publique apenas referências que possam ser públicas. O índice não substitui autenticação e não deve expor segredos, dados pessoais ou caminhos restritos. Uma URL difícil de adivinhar não é controle de acesso.
Qual é o prazo para o arquivo gerar citações?
Não há prazo nem ganho de citação garantido. Teste a tarefa de um consumidor identificado e registre o resultado observado. O Google informa que llms.txt não altera visibilidade ou ranking em Search.