O que é llms.txt: formato atual e teste de uso

Quando vale a pena manter esse arquivo?

O caso mais claro é uma documentação que um agente precisa consultar para executar uma tarefa. Um índice curto pode apontar para referência, tutorial e limitações vigentes. Antes de criar mais uma versão do conteúdo, identifique quem a usará e como você verificará sua utilidade.

A proposta llms.txt, de Jeremy Howard, foi atualizada em dez de agosto de 2026. Ela permite organizar um caminho para documentos detalhados. Publicar o arquivo não prova que todos os assistentes o consultam automaticamente.

Para a Pesquisa Google, o guia oficial esclarece que llms.txt não melhora nem prejudica visibilidade e ranking. Portanto, o investimento precisa de outra finalidade concreta, como documentação usada por uma integração. O guia completo de llms.txt aprofunda essa decisão.

Como funciona o formato atual?

Um arquivo pode cobrir a raiz ou um caminho, como /docs/llms.txt. Quando mais de um se aplica, a proposta orienta o consumidor a escolher o mais específico. O H1 com o nome do projeto é a única seção obrigatória; resumo em blockquote, detalhes e listas sob H2 são opcionais. A versão dois também admite uma marca de ordem de bytes opcional.

O exemplo fictício abaixo orienta a consulta à documentação de um sistema Aurora. Os endereços demonstrativos precisam ser substituídos por recursos existentes antes da publicação.

# Documentação Aurora

> Referências para consultar o catálogo público.
> Este conjunto não autoriza criação de pedidos.

## Começar
- [Consulta de produtos](https://example.com/docs/catalogo.md): Campos e filtros.
- [Limites da consulta](https://example.com/docs/limites.md): Erros e condições de uso.

## Optional
- [Histórico de versões](https://example.com/docs/versoes.md): Mudanças anteriores.

O arquivo oferece contexto e links. As permissões continuam sendo aplicadas pelos sistemas responsáveis. Instruções escritas no documento não podem conceder acesso a contas, autorizar pagamento ou substituir uma política de segurança.

Como o consumidor encontra o arquivo?

A proposta recomenda rel="describedby" para relacionar a página ao llms.txt que a cobre. Uma versão Markdown da própria página usa rel="alternate" type="text/markdown". São relações diferentes. Só anuncie uma alternativa que exista e preserve a informação necessária.

<link rel="describedby" href="/docs/llms.txt">
<link rel="alternate" type="text/markdown" href="/docs/catalogo.md">

Converter HTML em Markdown pode perder uma tabela ou uma ressalva. Compare as versões antes de publicá-las. O guia de JSON-LD e Markdown explica como escolher o formato pelo trabalho que o consumidor realiza.

Como testar a entrega e o uso?

1. Escolha o caminho e um responsável pela manutenção. Relacione somente documentos úteis para a tarefa definida.
2. Abra o arquivo por HTTP e confira status, redirecionamento, codificação e conteúdo. Uma página HTML de erro no lugar do Markdown reprova a entrega.
3. Abra os links e confira escopo, versão e condições. Não inclua documentos reservados em um índice público.
4. Verifique se as relações do HTML apontam para os recursos corretos e se as alternativas conservam tabelas e exceções.
5. No consumidor autorizado, use o arquivo como ponto de partida e peça uma resposta que dependa de uma limitação documentada.
6. Registre quais documentos foram acessados, quando a ferramenta expuser esse dado, e confira a resposta contra a referência.

No exemplo Aurora, o teste pode perguntar quais campos a consulta aceita e o que acontece quando faltar um campo obrigatório. Encontrar o arquivo é apenas parte do percurso; a resposta precisa preservar o comportamento definido na documentação.

Critério de aceite: o arquivo abre no formato esperado, seus links funcionam e o consumidor consegue concluir a tarefa conservando a condição testada. Se não houver consumidor identificado, registre essa lacuna antes de investir em manutenção adicional. O agente afirmar que leu o arquivo não substitui um registro de acesso.

O que manter depois da publicação?

Atualize o índice quando mudar uma URL, política ou versão relevante. Defina cache e retenção conforme a frequência real de alteração; a proposta não determina um prazo universal de atualização. Arquivos integrais adicionais também trazem custo de geração, transferência e contexto e precisam de justificativa própria.

A FAQ sobre llms.txt e SEO ajuda a esclarecer limites. Para entender como um consumidor se conecta a fontes e ferramentas, siga o curso MCP para quem decide, de Alexandre Caramaschi.