Come implementare llms.txt: cosa inserire e se ti serve

Cosa dovrebbe fare llms.txt?

Test rapido: Apri yoursite.com/llms.txt. Se vedi un 404, puoi comunque iniziare con 10 righe.

llms.txt è un file Markdown suggerito che offre agli strumenti basati su modelli linguistici una mappa curata delle pagine importanti di un sito web. Ha lo scopo di rendere più facile identificare materiale utile; non sostituisce il tuo sito web, una sitemap o una promessa di visibilità nelle risposte AI.

La proposta descrive di posizionare il file nella root del sito, dove può puntare a contenuti selezionati. In pratica, pensalo come un breve indice scritto per un lettore tecnico: dice a un lettore cosa fa la tua organizzazione e dove trovare informazioni autorevoli. Il file stesso non rende quelle pagine sottostanti accurate, complete o facili da usare.

Prima di decidere di crearne uno, verifica se il tuo sito ha un insieme chiaro di pagine pubbliche che vale la pena segnalare. Per un Web3 project, potrebbe includere una panoramica del prodotto, documentazione, informazioni sulla sicurezza, dettagli del token e guide di supporto, ma includi solo materiale pubblicato e approvato per riferimento pubblico.

La proposta e la sua logica sono descritte su llmstxt.org. Leggila come una convenzione da valutare, non come prova che una particolare piattaforma utilizzi il file o citerà le tue pagine. Per un quadro più ampio di come i segnali tecnici si inseriscono nella ricerca AI, consulta la nostra guida al technical AEO.

Serve per la SEO o la visibilità AI?

La maggior parte dei siti dovrebbe decidere in base all'utilità della mappa delle pagine, non supponendo che pubblicarla migliori le performance di ricerca. Se puoi indicare una raccolta piccola e stabile di pagine pubbliche utili, un file ben mantenuto può aiutare a comunicare il tuo percorso di lettura preferito. Se le tue pagine sono obsolete, contraddittorie o ancora in fase di modifica, risolvi prima questi problemi.

Usa questa rapida verifica decisionale:

• Il tuo team può nominare le pagine che danno un resoconto affidabile del progetto?
• Quelle pagine sono pubbliche, aggiornate e accessibili a un lettore senza permessi speciali?
• Qualcuno può assumersi la responsabilità di aggiornare il file quando una pagina cambia?
• Il file aggiungerebbe una via più chiara attraverso il sito rispetto al semplice collegamento alle sue pagine principali?

Se le risposte sono per lo più sì, redigere il file è un compito tecnico ragionevole e a bassa complessità. In caso contrario, dai priorità al materiale originale. Un indice curato che punta a rivendicazioni poco chiare non è una prova utile sulla tua organizzazione.

Per una revisione pratica di un Web3 site, raccogli i link alla panoramica del progetto, alla documentazione del prodotto, alle informative sulla sicurezza, ai canali social ufficiali e alle informazioni di supporto. Rimuovi i duplicati e risolvi le descrizioni contrastanti prima di pubblicare. Se l'obiettivo è una più ampia scopribilità nelle risposte AI, abbina questa decisione a una revisione della visibilità AI piuttosto che trattare un singolo file come un piano di visibilità completo.

Confronto tra llms.txt e schema.org

llms.txt e schema.org svolgono compiti diversi. llms.txt è un indice leggibile dall'uomo proposto di pagine selezionate; schema.org fornisce un vocabolario strutturato che può descrivere entità e contenuti delle pagine in un formato più coerente.

Usa schema.org quando devi descrivere un'entità reale, un prodotto, un articolo o un'organizzazione usando le proprietà appropriate. Mantieni il markup allineato con le informazioni che i lettori possono vedere sulla pagina. Usa llms.txt, se scegli di pubblicarlo, per orientare un lettore verso un insieme curato di risorse. Nessuno dei due formati ripara contenuti di origine deboli e non sono sostituti l'uno dell'altro.

Un ordine di implementazione utile è rendere chiare prima le pagine importanti, applicare dati strutturati adatti dove opportuno, poi considerare se un indice di testo separato aiuta la navigazione. Il vocabolario ufficiale è disponibile su schema.org. Per maggiori informazioni sulla scelta e la validazione del markup, leggi la nostra guida allo schema markup per la ricerca AI.

La tua checklist in 6 punti per llms.txt

Segui questi passaggi in ordine e conserva una copia datata di ogni versione. Un file breve e onesto è meglio di uno lungo, quindi fermati alle pagine che contano.

• Elenca le 10-20 pagine che vuoi che le macchine leggano.
• Scrivi una riga semplice per ogni pagina: cosa tratta.
• Metti il file nella root del dominio.
• Controlla che robots.txt non blocchi quelle pagine.
• Mantienilo aggiornato quando le pagine cambiano.
• Testa con 5 domande dell'assistente prima e dopo.

Termini in una riga

llms.txt (in parole semplici: un file semplice che punta gli strumenti AI alle tue pagine più utili).

Root del dominio significa l'indirizzo web di primo livello, ad esempio esempio.com/.

Scrivere un file utile, riga per riga

Regola pratica: Elenca da 10 a 20 pagine pubbliche stabili. Rimuovi qualsiasi pagina che non vorresti venisse citata.

Un file llms.txt utile è breve, accurato e costruito da pagine di cui un lettore dovrebbe fidarsi come fonti primarie. Inizia con una descrizione in linguaggio semplice dell'organizzazione, poi raggruppa o elenca le pagine che spiegano meglio il suo lavoro.

Uno schema semplice può essere simile a questo:

• Un'intestazione di primo livello con il nome del progetto
• Una breve descrizione che non esagera ciò che il progetto fa
• Link alle pagine principali, ciascuno con una breve spiegazione
• Raggruppamenti opzionali per documentazione, sicurezza, informazioni sul prodotto o supporto

Ad esempio, la descrizione di un link potrebbe essere: “Documentazione — configurazione del prodotto, reti supportate e istruzioni per l'uso.” Usa una descrizione che corrisponda alla destinazione; non etichettare una pagina di marketing come documentazione tecnica. Collega a URL canonici pubblici, non ad anteprime temporanee o pagine che richiedono un login.

Prima di pubblicare, controlla ogni URL, titolo e descrizione. Conferma che i dettagli del token, i riferimenti contrattuali, le dichiarazioni di sicurezza e le affermazioni sul prodotto siano coerenti con le pagine collegate e approvate dai responsabili. Tieni le roadmap riservate, le dashboard interne e il materiale non pubblicato fuori dal file. Assegna un responsabile in modo che gli aggiornamenti al sito richiedano una revisione dell'indice e mantieni il testo leggibile piuttosto che riempirlo di parole chiave ripetute.

Pubblicarlo sul tuo sito

Implementa llms.txt preparando le pagine sorgente, creando un file leggibile, pubblicandolo nella posizione prevista e controllando il risultato live. Il lavoro pratico è solitamente semplice quando la proprietà dei contenuti e l'accesso al sito web sono chiari.

Prima, crea un breve elenco di pagine pubbliche che spiegano accuratamente l'organizzazione. Controlla che ogni pagina si carichi e che i suoi contenuti siano aggiornati. Successivamente, scrivi il file come testo semplice in stile Markdown con un breve riassunto e link chiaramente etichettati; evita di trasformarlo in una seconda copia del tuo sito web. Quindi posizionalo nella root del sito in modo che sia raggiungibile al percorso previsto, solitamente /llms.txt.

Dopo la pubblicazione, apri l'URL in un browser e verifica che la risposta mostri il testo previsto anziché una pagina di errore, un loop di reindirizzamento o contenuti non correlati. Controlla i link dal file live, non solo dalla tua bozza. Aggiungi la responsabilità alla tua normale routine di manutenzione del sito, in particolare quando la documentazione del prodotto o i dettagli ufficiali del progetto cambiano.

Conserva una registrazione della versione pubblicata e delle sue pagine sorgente. Se stai già organizzando il lavoro tecnico rivolto all'AI, includi il file in una revisione più ampia della configurazione di llms.txt e AI crawler. Ciò rende più facile valutare il file insieme all'accessibilità delle pagine e ad altri segnali tecnici senza trattarlo come una soluzione autonoma.

Come testare se è utile?

L'evidenza pratica è se il file è corretto, accessibile e utile come mappa, non se la sua sola presenza prova che un sistema AI lo abbia utilizzato. Tieni queste domande separate quando valuti il lavoro.

Puoi verificare le cose che il tuo team controlla: che /llms.txt sia disponibile, che i contenuti corrispondano alla bozza approvata, che i link funzionino e che le pagine collegate forniscano le informazioni che le loro descrizioni promettono. Puoi anche verificare se le pagine sorgente importanti sono chiare e coerenti. Registra la data del controllo e la versione del file in modo che un futuro revisore possa vedere cosa è cambiato.

Non dedurre l'adozione dalla sola pubblicazione. Se monitori le risposte dai prodotti AI, registra il prodotto, il prompt, la data, la risposta e le fonti citate. Confronta le osservazioni con cautela: prompt e risposte possono variare, e una citazione che appare in un controllo non stabilisce che il file l'abbia causata. Un audit delle citazioni utile esamina le fonti e la formulazione che appaiono, non solo se il nome del tuo marchio è presente.

Per un Web3 project, controlla le risposte rispetto alla documentazione ufficiale e alle informative attuali. Se una risposta riporta erroneamente una chain, una funzionalità o un dettaglio del token, migliora prima la pagina autorevole; poi verifica se il tuo file indirizza i lettori alla fonte giusta.

Cosa llms.txt non può controllare e il passo successivo?

llms.txt è una convenzione proposta, quindi pubblicarlo non stabilisce che Google o qualsiasi prodotto AI lo legga, usi i suoi link o citi le tue pagine. Ogni piattaforma controlla la propria scansione, selezione e comportamento di risposta, e questi risultati non sono controllati dall'autore del file.

Il passo successivo più utile è rendere affidabili le informazioni sottostanti. Mantieni una fonte chiara per i fatti importanti del progetto, etichetta accuratamente il materiale tecnico e promozionale e assicurati che le pagine pubbliche concordino su nomi e descrizioni. Un file che punta a queste risorse può quindi servire come guida concisa piuttosto che come affermazione non supportata sul comportamento della piattaforma.

Se hai già pagine sorgente solide, crea una bozza e chiedi al responsabile dei contenuti e al responsabile tecnico di verificarla. Se il materiale sorgente è disomogeneo, prepara prima un elenco di pagine e dai priorità alle correzioni. Per i team Web3 che pianificano uno sforzo più ampio, la nostra guida alla visibilità nella ricerca AI spiega come il lavoro tecnico si inserisce insieme ai contenuti e ai riferimenti esterni.

Invia il tuo dominio e le pagine che consideri autorevoli. Esamineremo le fonti proposte, verificheremo se un file llms.txt è un passo successivo sensato e delineeremo le correzioni specifiche da apportare prima della pubblicazione.

Come funziona

1. Scegli le pagine sorgenteElenca le pagine pubbliche che spiegano la tua organizzazione, prodotto, documentazione e supporto. Conferma che ciascuna sia aggiornata e autorevole.
2. Risolvi le informazioni contrastantiConfronta descrizioni e fatti del progetto tra le pagine selezionate. Correggi le incongruenze alla fonte prima di collegarle.
3. Redigi il file MarkdownScrivi un'introduzione concisa e aggiungi link chiari con descrizioni accurate. Lascia fuori materiale privato, temporaneo o non approvato.
4. Pubblica nella root del sitoRendi il file disponibile su /llms.txt e controlla l'URL live, i suoi contenuti e ogni link di destinazione.
5. Assegna manutenzione e revisioneRegistra chi possiede gli aggiornamenti e controlla il file quando le pagine importanti cambiano. Giudicalo in base all'accessibilità e all'accuratezza, non a supposizioni sull'adozione da parte della piattaforma.