Erros comuns em llms.txt
Publicado:
A maioria dos problemas com llms.txt se enquadra em alguns poucos padrões. Aqui estão os que o nosso validador sinaliza com mais frequência — e a correção rápida para cada um.
1. Mais de um H1
A especificação exige exatamente um # Title de nível superior. Títulos # adicionais confundem a estrutura. Rebaixe os demais para títulos de seção ##.
2. Sem resumo em blockquote
Um blockquote de uma ou duas frases logo abaixo do título é o contexto que um modelo lê primeiro. Omiti-lo é a falha mais comum de todas. Adicione um:
# Acme > Acme turns CSV files into charts. These links cover setup, the API, and pricing.
3. Seções sem links (ou sem seções)
Seções ## vazias não acrescentam nada. Cada seção deve conter uma lista de marcadores em Markdown com links para páginas reais. Se você não tiver nenhuma seção, agrupe suas páginas principais sob títulos como ## Docs e ## Guides.
4. Links quebrados
Um arquivo pode estar perfeitamente formatado e ainda assim apontar para páginas inexistentes — o que desperdiça o orçamento de rastreamento de um crawler e mina a confiança. Toda URL precisa resolver. Essa é a verificação que a maioria das ferramentas pula; nós buscamos cada uma.
5. Links relativos ou http://
Use URLs absolutas https:// em todos os lugares. Os modelos podem não resolver caminhos relativos como /docs/start, e links simples http:// parecem pouco confiáveis e podem falhar em rastreamentos somente via HTTPS.
6. O content type errado
Sirva o arquivo como text/plain; charset=utf-8. Se o seu servidor retornar text/html (uma má configuração comum), alguns consumidores não vão tratá-lo como llms.txt.
7. Um arquivo inchado e sem curadoria
O llms.txt é um índice curado, não um despejo de sitemap. Centenas de links sem descrições enterram o sinal. Mantenha as melhores páginas, adicione uma breve : description após cada uma e mova os links secundários para uma seção ## Optional.
Detecte todos de uma vez
Passe seu arquivo pelo validador — ele pontua a estrutura, a acessibilidade dos links e as melhores práticas, e diz exatamente quais dos itens acima corrigir. Novo no formato? Comece com como criar um arquivo llms.txt.