Un agent qui répond à une question API peut avoir besoin d'un guide d'authentification et d'une référence de point d'accès. Charger un site entier inclut aussi du contenu sans rapport avec cette tâche.
La proposition llms.txt offre aux éditeurs un emplacement pour décrire leur contenu et renvoyer vers des pages Markdown utiles.
Que contient le fichier ?
Le fichier contient un nom de projet et peut inclure un résumé, des consignes et des liens groupés vers des informations complémentaires.
La proposition utilise le Markdown pour que les personnes et les programmes puissent traiter le même fichier. Ses listes de liens pointent vers du contenu que l'agent peut récupérer au besoin.
Un index de documentation peut regrouper l'authentification, l'envoi de messages et les événements de livraison sous des titres distincts. De courtes descriptions aident l'agent à distinguer ces destinations avant de les télécharger.
La proposition autorise aussi des index sous la racine du site. Un index sous un chemin de documentation couvre le contenu situé sous ce chemin.
Est-ce la même chose que robots.txt ou un sitemap ?
Ces fichiers remplissent des rôles différents : règles d'accès, découverte d'URL et parcours organisé vers le contenu.
| Fichier | Rôle |
|---|---|
robots.txt | Fournit aux clients automatisés des règles d'exploration |
| Sitemap | Liste les URL à découvrir par les moteurs de recherche |
llms.txt | Décrit le contenu et renvoie vers des détails utiles aux agents |
La comparaison de la proposition avec les standards existants décrit llms.txt comme complémentaire aux autres fichiers. Le publier n'accorde pas l'accès à du contenu protégé.
Il n'expose pas non plus d'action exécutable. Un agent a besoin d'une API séparée ou d'une connexion MCP pour effectuer des opérations dans l'espace de travail.
Le publier prouve-t-il que les agents l'utilisent ?
Publier un index lisible établit sa disponibilité. La preuve d'utilisation exige d'observer un client récupérer et exploiter ce contenu.
L'audit Lighthouse de Chrome vérifie les erreurs serveur lors de la récupération du fichier. Un fichier absent reçoit un résultat non applicable, car le fichier est facultatif. Réussir cette vérification ne mesure pas la qualité des réponses de l'agent.
Pour votre propre évaluation, enregistrez la tâche et les documents récupérés par le client. Vérifiez si l'agent a atteint la bonne réponse ou effectué l'action prévue. Comparez des exécutions équivalentes pour déterminer si l'index a aidé.
Une requête dans un journal d'accès prouve une récupération. Elle ne prouve pas, à elle seule, que le client a utilisé le contenu dans sa réponse. Une citation établit une observation différente. Gardez ces résultats séparés dans vos rapports.
Quelle documentation Bird fournir à un agent ?
Vous pouvez fournir l'index llms.txt de Bird lorsqu'un agent doit découvrir la documentation et récupérer les pages pertinentes.
Le guide de documentation lisible par les machines décrit l'index, les pages Markdown individuelles et le corpus complet. L'index fournit des liens ; les pages individuelles permettent au client de récupérer une réponse ciblée.
llms-full.txt concatène la documentation avec les URL sources. Ce format plus volumineux convient à un flux de travail qui a explicitement besoin du corpus, dans la limite du contexte du client.
Pour effectuer une tâche de messagerie après avoir récupéré les instructions, connectez le serveur MCP de Bird. La documentation fournit les informations ; la connexion authentifiée donne accès aux opérations de l'espace de travail.