Erreurs courantes dans llms.txt
Publié:
La plupart des problèmes de llms.txt se résument à quelques schémas récurrents. Voici ceux que notre validateur signale le plus souvent — et la solution rapide pour chacun.
1. Plus d'un H1
La spécification exige exactement un seul titre de premier niveau # Title. Les titres # supplémentaires brouillent la structure. Rétrogradez les autres en titres de section ##.
2. Aucun résumé en bloc de citation
Un bloc de citation d'une ou deux phrases placé juste sous le titre constitue le premier contexte que lit un modèle. L'omettre est l'oubli le plus fréquent. Ajoutez-en un :
# Acme > Acme turns CSV files into charts. These links cover setup, the API, and pricing.
3. Des sections sans liens (ou aucune section)
Les sections ## vides n'apportent rien. Chaque section doit contenir une liste à puces Markdown de liens vers de vraies pages. Si vous n'avez aucune section, regroupez vos pages clés sous des titres comme ## Docs et ## Guides.
4. Des liens cassés
Un fichier peut être parfaitement formaté tout en pointant vers des pages mortes — ce qui gaspille le budget d'exploration d'un robot et nuit à la confiance. Chaque URL doit aboutir. C'est la vérification que la plupart des outils ignorent ; nous récupérons chacune d'elles.
5. Des liens relatifs ou en http://
Utilisez partout des URL absolues en https://. Les modèles risquent de ne pas résoudre les chemins relatifs comme /docs/start, et les liens en simple http:// paraissent peu fiables et peuvent échouer lors d'une exploration imposant le HTTPS.
6. Le mauvais type de contenu
Servez le fichier avec le type text/plain; charset=utf-8. Si votre serveur renvoie text/html (une mauvaise configuration courante), certains consommateurs ne le traiteront pas comme un fichier llms.txt.
7. Un fichier surchargé et non trié
llms.txt est un index trié, pas un déversement de sitemap. Des centaines de liens sans description noient le signal. Conservez les meilleures pages, ajoutez une courte : description après chacune, et déplacez les liens secondaires vers une section ## Optional.
Repérez-les toutes d'un coup
Passez votre fichier dans le validateur — il évalue la structure, l'accessibilité des liens et les bonnes pratiques, et vous indique précisément lesquels des points ci-dessus corriger. Vous débutez avec ce format ? Commencez par comment créer un fichier llms.txt.