llms.txt
Ogni sito Jamdesk genera automaticamente llms.txt e llms-full.txt. Gli strumenti di IA usano questi file per comprendere la documentazione.
Se vuoi che strumenti di IA come ChatGPT, Claude o Copilot forniscano risposte accurate sul tuo prodotto, hanno bisogno di un accesso strutturato alla documentazione, non solo dei contenuti inclusi nei dati di addestramento.
Ogni sito Jamdesk genera llms.txt e llms-full.txt seguendo la specifica llmstxt.org. Gli strumenti di IA leggono questi file invece di eseguire il crawling delle singole pagine.
Google ora verifica llms.txt come parte dei controlli di navigazione agentica di Lighthouse. I siti che pubblicano un llms.txt valido sono più facilmente individuabili dagli agenti di IA e, sempre più spesso, da Google stesso quando classifica i contenuti destinati alle risposte basate sull'IA. Jamdesk ti offre questa funzionalità gratuitamente.
Controlla il tuo punteggio. Scopri quanto è pronta per gli agenti una qualsiasi documentazione con lo strumento gratuito AI Score. La pubblicazione di un llms.txt valido è una delle prime verifiche eseguite. È disponibile anche un'estensione Chrome AI Score per valutare i siti mentre navighi.
Cosa genera Jamdesk
| File | Contenuto |
|---|---|
llms.txt | Titoli delle pagine, descrizioni e URL (un indice strutturato) |
llms-full.txt | Contenuto completo della documentazione in un unico file |
Jamdesk genera entrambi i file durante la build e li distribuisce dalla stessa CDN della documentazione.
Verifica dei file
Verifica che i file esistano dopo la prima build:
Se la documentazione si trova nella radice del dominio (ad esempio docs.acme.com o acme.jamdesk.app):
curl https://docs.acme.com/llms.txt
curl https://docs.acme.com/llms-full.txtFormato dei file
Il file llms.txt elenca ogni pagina con titolo, descrizione e URL, raggruppati in sezioni che rispecchiano la navigazione:
# Your Project Documentation
> Documentation for Your Project
## Get Started
- [Getting Started](https://your-project.jamdesk.app/getting-started): Set up your first project in 5 minutes
- [Configuration](https://your-project.jamdesk.app/configuration): Configure your project settings
## API Reference
- [Authentication](https://your-project.jamdesk.app/authentication): How to authenticate API requestsIl file llms-full.txt contiene il contenuto Markdown completo di ogni pagina, concatenato con i limiti tra le pagine contrassegnati dai titoli.
Struttura
llms.txt segue la proposta llmstxt.org: un titolo H1,
un riepilogo in blockquote e le schede e i gruppi di navigazione come sezioni
## con link Markdown.
I siti multilingue hanno un indice per ogni lingua. Il file llms.txt nella radice elenca
la lingua predefinita e include alla fine un link a ogni indice tradotto, ad esempio
/fr/llms.txt per il francese. Ogni file di lingua rimanda ai file delle altre lingue.
Direttiva per gli agenti in ogni pagina
Ogni pagina contiene anche una nota invisibile e non rilevabile dagli screen reader per gli agenti di IA, con un riferimento a llms.txt, e ogni esportazione Markdown inizia con un blockquote che rimanda all'indice. Gli agenti che raggiungono il tuo HTML trovano il percorso Markdown senza eseguire il crawling.
Come viene creato
- Generato durante la build insieme all'HTML
- Distribuito dalla CDN con la stessa politica di caching della documentazione
- Aggiornato automaticamente a ogni build
- Non richiede configurazione; tutte le pagine sono incluse per impostazione predefinita
Disattivazione di llms.txt
llms.txt e llms-full.txt vengono pubblicati per impostazione predefinita. Per interromperne la generazione (ad esempio, se non vuoi che gli strumenti di IA acquisiscano i tuoi contenuti), imposta seo.ai.llmsTxt su false nel file docs.json:
{
"seo": {
"ai": {
"llmsTxt": false
}
}
}Alla build successiva, Jamdesk non genera i due file e gli URL attivi /llms.txt e /llms-full.txt restituiscono 404.
L'acquisizione da parte dell'IA e l'indicizzazione nella ricerca sono controlli separati. seo.ai.llmsTxt gestisce solo i file llms.txt/llms-full.txt letti dagli strumenti di IA. Non modifica il modo in cui i motori di ricerca indicizzano il sito; questo è controllato dai metadati robots e dal valore noindex per pagina. Una pagina può essere indicizzata da Google ed esclusa dall'acquisizione da parte dell'IA, o viceversa.
Crawler IA
Il file robots.txt predefinito di Jamdesk consente l'accesso a tutti i principali crawler IA (Claude, ChatGPT, Copilot, Gemini). La documentazione è accessibile agli strumenti di IA fin da subito.
sitemap.xml elenca gli URL che i motori di ricerca devono sottoporre a crawling e indicizzare. Non include contenuti, ma solo link e metadati come le date dell'ultima modifica.
llms.txt è progettato per i modelli di IA. Include i titoli e le descrizioni delle pagine e, in llms-full.txt, il contenuto effettivo. Gli strumenti di IA possono leggere il file completo per comprendere la documentazione senza effettuare più richieste HTTP.