Een agent die een API-vraag beantwoordt, heeft misschien één authenticatiegids en één endpoint-referentie nodig. Het laden van een volledige website brengt ook materiaal mee dat niet gerelateerd is aan die taak.
Het llms.txt-voorstel geeft uitgevers een plek om hun content te beschrijven en te linken naar bruikbare Markdown-pagina's.
Wat staat er in het bestand?
Het bestand bevat een projectnaam en kan een samenvatting, richtlijnen en gegroepeerde links naar meer informatie bevatten.
Het voorstel gebruikt Markdown zodat mensen en programma's hetzelfde bestand kunnen verwerken. De linklijsten verwijzen naar content die de agent kan ophalen wanneer nodig.
Een documentatie-index kan authenticatie, het verzenden van berichten en bezorggebeurtenissen onder aparte kopjes groeperen. Korte beschrijvingen helpen de agent die bestemmingen te onderscheiden voordat hij ze downloadt.
Het voorstel staat ook indexen onder de siteroot toe. Een index onder een documentatiepad dekt de content onder dat pad.
Is het hetzelfde als robots.txt of een sitemap?
Deze bestanden dienen verschillende doelen: toegangsrichtlijnen, URL-ontdekking en een samengestelde route naar content.
| Bestand | Doel |
|---|---|
robots.txt | Geeft geautomatiseerde clients crawlregels |
| Sitemap | Vermeldt URL's die zoekmachines kunnen ontdekken |
llms.txt | Beschrijft content en linkt naar bruikbare details voor agents |
De vergelijking van het voorstel met bestaande standaarden beschrijft llms.txt als aanvullend op de andere bestanden. Publicatie ervan verleent geen toegang tot beschermde content.
Het stelt ook geen uitvoerbare actie beschikbaar. Een agent heeft een aparte API of MCP-verbinding nodig om werkruimte-bewerkingen uit te voeren.
Bewijst publicatie dat agents het gebruiken?
Het publiceren van een leesbare index stelt beschikbaarheid vast. Bewijs van gebruik vereist dat je observeert dat een client die content ophaalt en gebruikt.
Chrome's Lighthouse-audit controleert op serverfouten bij het ophalen van het bestand. Een ontbrekend bestand krijgt een niet-van-toepassing-resultaat omdat het bestand optioneel is. Het slagen voor die controle meet niet de antwoordkwaliteit van een agent.
Leg voor je eigen evaluatie de taak vast en de documenten die de client heeft opgehaald. Controleer of de agent het juiste antwoord heeft bereikt of de beoogde actie heeft voltooid. Vergelijk gelijkwaardige runs om te beoordelen of de index heeft geholpen.
Een verzoek in een toegangslog bewijst een fetch. Het bewijst op zichzelf niet dat de client de content in zijn antwoord heeft gebruikt. Een bronvermelding stelt weer een andere observatie vast. Houd deze uitkomsten gescheiden bij het rapporteren van resultaten.
Welke Bird-documentatie geef je een agent?
Je kunt de llms.txt-index van Bird aanbieden wanneer een agent documentatie moet ontdekken en relevante pagina's moet ophalen.
De gids voor machineleesbare documentatie beschrijft de index, individuele Markdown-pagina's en het volledige corpus. De index levert links; individuele pagina's laten de client een gericht antwoord ophalen.
llms-full.txt voegt de documentatie samen met bron-URL's. Die grotere vorm past bij een workflow die het corpus expliciet nodig heeft, afhankelijk van de contextlimieten van de client.
Verbind de MCP-server van Bird om na het ophalen van de instructies een berichtentaak uit te voeren. Documentatie levert informatie; de geauthenticeerde verbinding levert toegang tot werkruimte-bewerkingen.