Cosa contiene un file llms.txt

Il formato

Il file inizia con un titolo di primo livello con il nome del sito - l’unico elemento obbligatorio - seguito da una citazione (blockquote) che lo riassume. Testo libero o elenchi possono aggiungere dettagli. Seguono sezioni di secondo livello, ciascuna con un elenco di link scritti nella forma [titolo](url), eventualmente seguiti da due punti e una nota. Una sezione intitolata Optional contiene link che un lettore può saltare quando ha poco spazio.

Esempio (nomi segnaposto):

# Example Rail

> Timetables, live departures and fares for Example Rail's network, for people and for AI assistants.

Fares are in EUR and include all taxes. Tickets are sold on example-rail.test only.

## Docs

- [Journey planner API](https://example-rail.test/docs/api): search journeys by station, date and time
- [MCP server](https://example-rail.test/docs/mcp): remote endpoint and the tools it offers

## Optional

- [Company history](https://example-rail.test/about/history)

Cosa non è

Non è un robots.txt: non concede né nega nulla. Non è nemmeno una sitemap: una sitemap elenca tutte le pagine, llms.txt sceglie le poche che contano e spiega a cosa serve ciascuna. La proposta suggerisce anche di offrire versioni Markdown delle pagine, e alcuni siti pubblicano un llms-full.txt con il testo completo in un unico file.

Scriverne uno utile

Indicare prima che cos’è il sito o il servizio e a chi si rivolge. Inserire i link alle pagine che rispondono alle domande che le persone pongono davvero. Per un servizio che un assistente può chiamare, inserire i link al riferimento dell’API, all’endpoint MCP e alla documentazione sull’accesso. Servirlo come testo semplice o Markdown: un sito che risponde a /llms.txt con una pagina HTML o una pagina di errore non ha un llms.txt, e le verifiche di questa directory lo contano così.