Errori comuni nei file llms.txt
Pubblicato:
La maggior parte dei problemi di llms.txt rientra in pochi schemi ricorrenti. Ecco quelli che il nostro validatore segnala più spesso — e la soluzione rapida per ciascuno.
1. Più di un H1
La specifica richiede esattamente un titolo di primo livello # Title. Intestazioni # aggiuntive confondono la struttura. Declassa le altre a intestazioni di sezione ##.
2. Nessun riepilogo nel blockquote
Un blockquote di una o due frasi subito sotto il titolo è il contesto che un modello legge per primo. Ometterlo è l'errore più comune in assoluto. Aggiungine uno:
# Acme > Acme turns CSV files into charts. These links cover setup, the API, and pricing.
3. Sezioni senza link (o nessuna sezione)
Le sezioni ## vuote non aggiungono nulla. Ogni sezione dovrebbe contenere un elenco puntato Markdown di link a pagine reali. Se non hai alcuna sezione, raggruppa le tue pagine principali sotto intestazioni come ## Docs e ## Guides.
4. Link rotti
Un file può essere formattato perfettamente eppure puntare a pagine inesistenti — il che spreca il budget di un crawler e mina la fiducia. Ogni URL deve risolversi. Questo è il controllo che la maggior parte degli strumenti salta; noi recuperiamo ciascuno.
5. Link relativi o http://
Usa URL assoluti https:// ovunque. I modelli potrebbero non risolvere percorsi relativi come /docs/start, e i link http:// semplici sembrano inaffidabili e possono interrompersi con un crawling solo-HTTPS.
6. Il content type errato
Servi il file come text/plain; charset=utf-8. Se il tuo server restituisce text/html (una configurazione errata comune), alcuni consumatori non lo tratteranno come llms.txt.
7. Un file sovraccarico e non curato
llms.txt è un indice curato, non uno scarico della sitemap. Centinaia di link senza descrizioni seppelliscono il segnale. Mantieni le pagine migliori, aggiungi una breve : description dopo ciascuna e sposta i link secondari in una sezione ## Optional.
Individuali tutti in una volta
Esegui il tuo file attraverso il validatore — valuta la struttura, la raggiungibilità dei link e le best practice, e ti dice esattamente quali dei problemi sopra correggere. Sei nuovo al formato? Inizia con come creare un file llms.txt.