Como criar um arquivo llms.txt
Publicado: · Atualizado:
Escrever um arquivo llms.txt leva cerca de dez minutos. Este guia percorre cada parte, em ordem, e termina com um arquivo que você pode copiar e adaptar.
1. Comece pelo título H1
A primeira linha deve ser um único H1 — o nome do seu projeto ou site. É o único elemento estritamente obrigatório do formato.
# Acme Docs
2. Adicione um resumo em blockquote
Logo abaixo do título, adicione um blockquote de uma ou duas frases. Esse é o contexto que um modelo de linguagem lê primeiro, então seja específico: o que é o site e para quem ele se destina.
> Acme is a payments API. This file links to the docs an LLM needs to integrate and debug Acme.
3. (Opcional) Adicione algumas linhas de texto
Antes de qualquer título de seção, você pode adicionar parágrafos simples com orientações extras. Não use títulos aqui — mantenha em uma ou duas frases.
4. Agrupe seus links em seções H2
Cada seção é um título H2 seguido de uma lista em markdown. Cada item é um link com uma descrição opcional após os dois-pontos.
## Docs - [Quickstart](https://acme.com/docs/quickstart): Integrate in five minutes - [API reference](https://acme.com/docs/api): Every endpoint and parameter ## Examples - [Sample app](https://acme.com/examples/app): A working end-to-end example
Use URLs https absolutas e mantenha as descrições focadas no que um desenvolvedor ou modelo precisa — não em texto de marketing.
5. Use a seção "Optional" para itens desejáveis, mas não essenciais
Uma seção chamada ## Optional é a convenção para informações secundárias: links que um agente pode pular quando é preciso um contexto mais curto. Coloque aqui changelogs, posts de blog e referências secundárias.
6. Hospede na raiz — ou no caminho que ele cobre
Sirva o arquivo em https://yourdomain.com/llms.txt com Content-Type: text/plain. Ele também pode ficar em um subcaminho, cobrindo as páginas abaixo dele: /docs/llms.txt descreve tudo que está em /docs/, e os agentes preferem o arquivo aplicável mais específico (veja o que mudou na spec v2). Sites grandes muitas vezes também publicam um llms-full.txt com todo o conteúdo expandido.
7. Faça suas páginas apontarem para ele
Para os agentes não precisarem adivinhar a URL, anuncie o arquivo a partir das suas páginas com <link rel="describedby" href="/llms.txt"> — ou com o cabeçalho de resposta Link: equivalente, que você configura uma única vez na CDN.
8. Valide antes de publicar
Cole seu domínio no validador. Ele verifica a estrutura, confirma que cada link realmente resolve e lista exatamente o que corrigir. Mire em 100/100.