Comment les agents découvrent les ressources llms.txt v2
La proposition v2 définit deux relations de découverte. Notre baseline mesure leur présence sur les pages liées depuis des réponses racine commençant par un H1.
Dernière mise à jour:
alternate relie une page HTML à sa représentation Markdown. describedby relie cette page au fichier llms.txt le plus spécifique. Ensemble, ces relations évitent aux agents compatibles de deviner les URL. Elles n’ont aucun effet sur les clients qui n’implémentent pas la proposition.
À retenir
- 31 des 286 pages joignables annonçaient du Markdown.
- Quatre annonçaient
rel="describedby"dans le HTML ou un en-tête HTTP Link.- Découverte ne signifie ni utilisation, ni citation, ni gain Google.
Quels sont les deux signaux ?
Une page HTML peut publier <link rel="alternate" type="text/markdown" href="..."> pour annoncer le même contenu en Markdown. Elle peut publier <link rel="describedby" href=".../llms.txt"> pour indiquer la carte qui couvre cette page.
La proposition autorise aussi des en-têtes HTTP Link. Ils conviennent aux ressources non HTML ; les balises HTML sont souvent plus simples à générer depuis un layout. Dans les deux cas, testez l’URL finale et n’annoncez pas une conversion obsolète.
Que publiaient 294 pages ?
Le benchmark du 12 août a échantillonné jusqu’à trois pages liées depuis chacune des 113 réponses racine correspondant à la règle d’inclusion H1. Sur 294 pages demandées, 286 étaient joignables. Trente et une annonçaient une alternative Markdown et quatre annonçaient rel="describedby". Le détecteur a inspecté le HTML et les en-têtes HTTP Link.
Ce résultat est une baseline datée pour cet échantillon. Il ne prouve pas l’absence d’une URL Markdown non annoncée et ne couvre pas toutes les pages de chaque hôte. L’agrégat et la méthode sont publiés dans v2-adoption-stats.json.
Implémenter les relations sans erreur
Générez HTML et Markdown depuis la même source. Pour une route terminée par une barre oblique, v2 propose index.md ou index.html.md. Conservez le HTML comme document canonique pour Search et traitez le Markdown comme une représentation équivalente.
Résolvez describedby selon la portée. Une page générale peut utiliser /llms.txt, une documentation /docs/llms.txt, et une section localisée son propre fichier. Contrôlez le HTML construit, pas seulement les variables du template.
Ajoutez des tests CI pour les ressources absentes, les mauvais types MIME et les portées incohérentes. Le validateur contrôle la syntaxe ; la checklist de migration traite le déploiement.
Ce que ces relations ne font pas
Elles ne forcent aucun crawler, ne remplacent pas robots.txt, ne sécurisent pas une information privée et ne font pas monter une page dans Google. Google précise que Search n’utilise pas ces fichiers spéciaux.
Le bénéfice testable est plus étroit : un agent compatible peut trouver une représentation propre et une carte curée au moyen de liens Web standard. Vérifiez les logs avant toute autre affirmation.
Pour le contexte, repartez de la définition de llms.txt et comparez avec les exemples de production.
rel="describedby" est-il obligatoire ?
Non. Il appartient au mécanisme de découverte v2, pas à la syntaxe minimale du fichier.
Peut-on utiliser seulement les en-têtes HTTP ?
Oui. La proposition décrit les deux méthodes. Choisissez celle que vous pouvez générer et tester durablement.
Le Markdown doit-il être canonique ?
Pour Search, gardez la page HTML canonique. Le Markdown doit identifier sa source et conserver le même contenu essentiel.