Guide complet du fichier llms.txt : objectif, vérifications et mise en place

Une petite carte pour les pages que vous voulez que l'on trouve

Imaginez une équipe de validation lorsque les questions se répètent dans le chat. Les nouveaux arrivants demandent où se trouvent la documentation du projet, les détails du token et les conseils d'assistance. Une courte liste de pages soigneusement choisies pourrait leur donner un point de départ unique.

llms.txt est une convention Markdown proposée pour lister les pages importantes d'un site Web. Elle offre au lecteur une orientation compacte et des liens vers du matériel que votre équipe juge utile. Considérez-la comme un panneau indicateur, pas comme un deuxième site Web ou un résumé de chaque page.

Pour un projet Web3, la liste peut pointer vers une présentation du projet, une documentation technique, des divulgations publiques ou des informations d'assistance. N'incluez une page que si elle répond à une question réelle et a du sens par elle-même. Un lien nu vers une page confuse ou obsolète ne rend pas cette page plus claire.

Le format mérite d'être envisagé lorsque vos meilleures explications sont difficiles à localiser. Il est moins utile en tant que tâche effectuée simplement parce que le nom du fichier est discuté. Notre guide sur le AEO technique, le balisage schema et les crawlers couvre les choix techniques connexes. Mais la première question ici est plus simple : une courte carte aiderait-elle quelqu'un à trouver la bonne explication ?

llms.txt résoudrait-il un problème que vos lecteurs rencontrent ?

llms.txt peut convenir lorsque des informations utiles existent mais que les gens ont du mal à les trouver. Il est facultatif lorsque vos pages sont déjà claires, à jour et faciles à naviguer. Commencez par vérifier l'expérience d'un nouveau lecteur, plutôt que de supposer que le fichier modifiera la visibilité dans les recherches.

Supposons que quelqu'un rejoigne votre communauté et demande où sont expliquées les exigences du validateur. Si la réponse nécessite plusieurs messages dans le chat, notez d'abord la meilleure page existante. Si cette page est incomplète, améliorez-la avant d'y faire un lien à partir d'un nouveau fichier.

Commencez par le parcours du lecteur

Listez les questions que les gens posent de manière répétée. Associez chacune à une page publique qui y répond clairement. Si plusieurs pages répètent les mêmes faits différemment, résolvez ce décalage avant de créer un autre index.

Gardez la tâche modeste

Un fichier utile peut également vous aider à organiser votre propre matériel de référence. Il donne à votre équipe une liste rapide à examiner lorsqu'une page clé bouge ou change. Notre guide sur la configuration de llms.txt et des crawlers IA examine les questions de configuration connexes. Aucune de ces pages ne remplace le test de base : un lecteur peut-il suivre les liens et comprendre le sujet ?

Si vous ne pouvez pas nommer un problème de lecteur que le fichier résoudrait, vous pouvez le laisser pour plus tard. Une navigation claire et des pages de destination solides restent utiles sans lui.

Construisez le brouillon à partir de questions, pas d'un export d'URL

Un fichier llms.txt utile commence par une brève orientation et un petit groupe de pages pertinentes. Rédigez-le à partir des questions auxquelles un nouveau venu doit répondre, puis vérifiez chaque lien par rapport au site public.

1. Nommez le sujet. Écrivez une courte introduction qui indique aux lecteurs quel projet ou site le fichier décrit.
2. Choisissez les pages de référence. Incluez les pages pour la présentation du projet, la documentation, les divulgations importantes et l'assistance lorsqu'elles existent et sont à jour.
3. Regroupez les liens connexes. Utilisez des titres simples afin qu'un lecteur puisse parcourir le fichier sans connaître vos termes internes.
4. Vérifiez chaque description. Assurez-vous que chaque étiquette indique ce que sa destination contient réellement.

Par exemple, un projet peut avoir des pages séparées pour la documentation du protocole et les divulgations de sécurité. Donnez à chacune une étiquette claire au lieu de compter sur le lecteur pour déduire son objectif à partir d'une URL. Si une page manque, créez ou améliorez cette destination avant de l'ajouter à la liste.

Avant la publication, demandez à un membre de l'équipe qui ne connaît pas le brouillon de suivre les liens. Peut-il trouver les informations pertinentes sans vous demander ce qu'un titre signifie ? Notre guide sur le contenu citable pour les assistants IA propose d'autres moyens de rendre ces pages de destination plus faciles à comprendre.

Placez le fichier là où le site prévu peut le servir

Pour publier llms.txt, placez le fichier Markdown révisé à la racine du domaine qu'il décrit, puis vérifiez son adresse publique. Confirmez le domaine et le chemin de publication avant d'écrire une version finale, surtout si votre projet utilise plusieurs sites ou sous-domaines.

Un système de gestion de contenu, une configuration d'hébergement ou un processus de publication peut affecter qui peut ajouter un fichier à la racine. Demandez à la personne qui gère les modifications du site de confirmer le chemin avant de planifier en fonction de celui-ci. Après la publication, ouvrez l'adresse publique dans un navigateur et testez chaque lien, pas seulement le premier.

Conservez une copie approuvée avec vos notes de site. Lorsqu'une page liée bouge, vérifiez si le fichier nécessite une mise à jour. Pour une question distincte sur les données structurées, consultez notre guide sur le balisage schema pour la recherche IA ; les deux approches ont des rôles différents.

Utilisez des preuves que vous pouvez inspecter directement

Vous pouvez évaluer le fichier en vérifiant s'il est disponible, précis et utile pour un lecteur. Enregistrez son adresse publique, les pages qu'il nomme et les corrections apportées lors de la révision. Ce sont des vérifications concrètes que votre équipe peut répéter après des modifications.

Essayez une révision en 4 parties : ouvrez le fichier en ligne et confirmez que le texte approuvé apparaît. Suivez chaque lien, puis demandez à une autre personne d'expliquer ce que couvrent les pages liées. Si elle ne trouve pas de réponse, améliorez la destination ou reconsidérez sa place dans la liste. Conservez une copie de la version révisée afin que les modifications ultérieures aient une référence claire.

Le fichier peut également aider votre équipe à garder un œil sur ses explications publiques les plus importantes. Si une page produit ou une divulgation change, vérifiez la description et le lien pendant que la mise à jour est fraîche. Pour les questions de contenu au-delà de ce fichier, notre guide sur l'optimisation des FAQ pour les réponses IA peut vous aider à organiser les réponses sur les pages elles-mêmes.

Une prochaine étape calme consiste à rassembler les URL que les gens partagent déjà dans le chat. Examinez ces pages avec un collègue, puis décidez si un court index faciliterait le chemin.

Séparez le fichier des décisions de la plateforme

Un fichier llms.txt peut montrer quelles pages votre équipe a choisi de mettre en avant ; il ne peut pas confirmer comment une plateforme externe les a traitées. La convention est proposée. Chaque plateforme contrôle son propre accès, son interprétation et son utilisation du contenu Web, donc la publication ne peut pas promettre un résultat de citation ou de classement.

Cette distinction vous donne un moyen pratique de rendre compte du travail. Confirmez l'emplacement en ligne, comparez-le avec le brouillon approuvé et vérifiez si ses liens se résolvent. Gardez ces observations séparées de tout examen de la façon dont votre projet apparaît dans les réponses de recherche ou d'assistant.

Si vous voulez qu'une autre personne vérifie la mise en œuvre, partagez le brouillon, le domaine qu'il décrit et les pages que vous avez sélectionnées. Chez Brand Community, nous pouvons examiner l'URL en ligne et la liste de liens avec vous, puis signaler les écarts entre le fichier et ses destinations. Commencez par les pages auxquelles votre équipe fait déjà confiance ; après cela, vous pouvez décider si la publication de la carte est utile.

Comment ça marche

1. Choisissez le domaineDécidez quel site ou sous-domaine le fichier décrit. Vérifiez qui peut publier un fichier à sa racine.
2. Sélectionnez les pages prêtes pour le lecteurRassemblez les pages publiques qui répondent aux questions courantes. Laissez de côté tout ce qui est obsolète ou peu clair.
3. Rédigez et révisezAjoutez une courte orientation, des titres simples et des liens utiles. Vérifiez que chaque étiquette correspond à sa page.
4. Publiez et testezPlacez le fichier à l'adresse racine prévue. Ouvrez-le publiquement et suivez chaque lien.
5. Gardez-le à jourConservez la version approuvée et revisitez les liens lorsque des pages importantes changent ou bougent.