llms.txt (file di contesto per AI)
Il file llms.txt è un documento in formato Markdown posizionato nella radice di un sito web per presentare contenuti e struttura ai modelli linguistici.
Il file llms.txt è una proposta di standard per il web: un documento di testo semplice, formattato in Markdown e salvato nella cartella principale di un sito, ideato per spiegare ai modelli di intelligenza artificiale chi sei, cosa offri e dove trovare i contenuti più autorevoli. Se il classico file robots.txt indica ai motori di ricerca dove non entrare e la sitemap elenca genericamente gli URL, llms.txt fornisce una mappa sintetica e leggibile pensata specificamente per i modelli linguistici (LLM).
Quando un assistente AI naviga sul web per rispondere a una domanda o preparare un riassunto, si trova spesso davanti a pagine piene di menu, annunci pubblicitari, script interattivi e avvisi sui cookie. Tutto questo codice superfluo consuma la finestra di contesto del modello. Il file llms.txt risolve questo ostacolo offrendo una porta di accesso pulita: poche righe essenziali, descrizioni chiare e collegamenti mirati alle risorse che contano davvero.
Come funziona lo standard llms.txt
Il principio è molto intuitivo: il file deve trovarsi all'indirizzo principale del dominio, esattamente come iltuosito.it/llms.txt. All'interno si utilizza il linguaggio Markdown, che i modelli comprendono con estrema facilità e senza spreco di risorse di calcolo.
La struttura tipica include il nome del progetto, una breve panoramica descrittiva, e un elenco organizzato per sezioni con collegamenti diretti a guide, documentazione, schede servizio o articoli di approfondimento. Per ciascun link si aggiunge una frase di chiarimento, così che l'agente AI possa valutare se quella risorsa specifica è utile prima ancora di scaricarne l'intero testo.
Un esempio concreto: l'agriturismo toscano
Immaginiamo una tipica azienda agrituristica nella campagna di San Gimignano, che produce olio extravergine d'oliva, offre camere per le vacanze e organizza corsi di cucina per viaggiatori stranieri. Un utente chiede a una chat AI: "Quali corsi di cucina tradizionale ci sono vicino a San Gimignano con alloggio per famiglie?".
Se il modello visita il sito dell'agriturismo, potrebbe perdersi tra decine di gallerie fotografiche e moduli di prenotazione lenti da caricare. Con un file llms.txt, invece, trova subito un quadro perfetto:
- Nome e identità: Agriturismo Poggio Chiaro, ospitalità rurale e produzione biologica a San Gimignano.
- Corsi di pasta fresca: link diretto alla scheda con orari, ingredienti tipici e disponibilità per nuclei familiari.
- Soggiorno in appartamenti: link alla panoramica dei casali adatti a bambini e animali domestici.
- Vendita diretta: link alla guida sull'olio extravergine certificato e sulle modalità di spedizione.
Grazie a questa sintesi, l'intelligenza artificiale comprende all'istante i punti di forza della struttura e può consigliare l'agriturismo con dettagli corretti e senza allucinazioni.
Come creare e verificare il file sul proprio sito
Implementare questo strumento è alla portata di qualsiasi webmaster o proprietario di attività. Non servono competenze di programmazione avanzata, basta un comune editor di testo o un modulo dedicato integrato nel proprio gestore di contenuti:
- Crea un nuovo file chiamato
llms.txtcon codifica UTF-8. - Inserisci un titolo H1 con il nome della tua attività o del tuo portale, seguito da una sintesi di due o tre frasi sul tuo settore.
- Crea sezioni tematiche con intestazioni H2 (ad esempio guide, servizi, contatti, FAQ).
- Aggiungi i collegamenti più importanti in formato Markdown, accompagnando ogni link con una breve frase esplicativa.
- Carica il file nella cartella principale del server, così che risponda alla radice del dominio.
- Verifica nel browser digitando l'indirizzo completo per accertarti che il testo compaia senza formattazioni grafiche o blocchi di sicurezza.
Errori frequenti da evitare
Il rischio più diffuso è scambiare questo file per una brochure pubblicitaria. Riempire llms.txt di slogan promozionali, aggettivi altisonanti o keyword ripetute non serve a nulla: i modelli scartano il gergo di vendita e cercano fatti precisi, definizioni pulite e gerarchie logiche.
Un secondo errore consiste nel sovraccaricare il file con centinaia di URL marginali. Lo scopo non è duplicare la sitemap XML, ma selezionare solo le fonti di verità più preziose. Infine, ricorda di aggiornare i percorsi quando modifichi la struttura delle pagine: indicare collegamenti non più attivi danneggia l'affidabilità con cui i bot interpretano il tuo sito.
Domande frequenti
Il file llms.txt sostituisce robots.txt?
No, hanno ruoli diversi: robots.txt definisce i permessi di scansione per i bot, mentre llms.txt offre un riassunto dei contenuti per aiutare i modelli a comprendere la struttura informativa.
È obbligatorio pubblicare llms.txt sul proprio sito?
No, non è un obbligo ma una convenzione volontaria. Tuttavia, il costo di realizzazione è minimo e offre vantaggi concreti nella visibilità verso gli assistenti di intelligenza artificiale.
Dove deve essere posizionato il file llms.txt?
Deve trovarsi nella cartella radice del dominio, in modo da essere raggiungibile direttamente digitando l'indirizzo tuosito.it/llms.txt.
Che differenza c'è tra llms.txt e llms-full.txt?
llms.txt è una guida rapida con descrizioni e collegamenti selezionati, mentre llms-full.txt include l'intero contenuto testuale delle pagine chiave aggregato in un unico file per facilitare letture complete.
