llms.txt- en Agent-manifestpagina's: Een onderhouden, machine-leesbare site-index

Een llms.txt- en agent-manifestpagina is een machine-leesbare index die AI-systemen vertelt wat een site vertegenwoordigt, welke openbare pagina’s gezaghebbend zijn en—wanneer het bedrijf agentacties ondersteunt—welke geverifieerde capaciteiten en beleidsregels van toepassing zijn. Het is een kaart naar onderhouden bronnen, geen vervanging voor die bronnen en geen belofte dat een bepaalde crawler het zal gebruiken.

Het contract is identiteit → reikwijdte → gezaghebbende bestemmingen → optionele capaciteiten → beperkingen → versheid. Het bestand slaagt wanneer een machine het kan ophalen, interpreteren zonder te gissen, live canonieke URL’s kan volgen en uitkomt bij feiten die nog steeds overeenkomen met de productiewerkelijkheid.

Vragen die het beantwoordt

De primaire vraag is: “Welke delen van deze site moet een AI-systeem gebruiken om de organisatie, de content en de ondersteunde acties te begrijpen?” Ondersteunende vragen zijn:

• Wat is de canonieke naam, het domein, het doel en het publiek van de site?
• Welke product-, dienst-, documentatie-, prijs-, beleids- en ondersteuningspagina’s zijn gezaghebbend?
• Welke pagina’s moeten de voorkeur krijgen boven archieven, campagne pagina’s, parameters of dubbele regionale versies?
• Biedt de site een daadwerkelijke agentcapaciteit, of alleen mens-leesbare informatie?
• Waar zijn authenticatie, snelheidslimieten, gegevensverwerking, commerciële voorwaarden en ondersteuning gedocumenteerd?
• Welke uitspraken zijn beschrijvende richtlijnen in plaats van toegangscontrolegels?
• Wie is eigenaar van het bestand, welke gebeurtenis triggert een update en hoe wordt afwijking gedetecteerd?

Wanneer dit posttype te gebruiken

Gebruik dit type wanneer de site voldoende openbare, duurzame content heeft om te profiteren van een samengestelde machine-leesbare index en iemand het onderhoud ervan kan beheren. De reden om het te publiceren is om dubbelzinnigheid voor ophaalsystemen te verminderen, niet om nog een URL te creëren omwille van de URL.

Verwar richtlijnen niet met controle. robots.txt geeft crawler-toegangsvoorkeuren aan; een XML-sitemap helpt crawlers URL’s te ontdekken; authenticatie en autorisatie bepalen of een actie mag plaatsvinden. llms.txt biedt samengestelde context. Een zin in llms.txt kan geen toegang verlenen, toegang intrekken, een geheim beschermen of de voorwaarden van een bestemmingspagina overschrijven.

Het beste voor deze bedrijfstypen

1. SaaS . De beste match omdat een softwarebedrijf meestal aparte product-, functie-, prijs-, integratie-, API-, beveiligings-, status- en documentatiebronnen heeft. De index kan bepalen welke pagina eigenaar is van welk feit, terwijl een apart capaciteitenmanifest alleen acties beschrijft die het product werkelijk ondersteunt.
2. E-commerce . Sterk wanneer producten, verzending, retouren, beschikbaarheid en klantenservicebeleid openbaar en canoniek zijn. Houd vluchtige productgegevens in feeds of API’s; gebruik de index om naar die onderhouden bronnen te verwijzen in plaats van een catalogus in Markdown te kopiëren.
3. Marktplaatsen . Waardevol wanneer kopers-, verkopers-, aanbieders- en platformbeleid verschillen. Label elk publiek en rechtsgebied zodat een agent geen verkopersregels toepast op een koper of platformvoorraad afleidt uit één advertentie.
4. B2B-diensten . Nuttig voor het verduidelijken van capaciteiten, branches, dienstgrenzen, bewijslast, inkoopmateriaal en contactroutes. Zet geen onderhandelde scope of klantspecifieke belofte om in een universele machine-leesbare claim.
5. Bureaus . Nuttig wanneer het bureau veel service-, methodologie-, case study- en expertisepagina’s onderhoudt. Klantportalen, inloggegevens, privérapporten en interne playbooks blijven buiten het openbare bestand.
6. Fabrikanten en industriële bedrijven . Nuttig voor het verwijzen van systemen naar productfamilies, specificaties, certificeringen, handleidingen, distributeurs en veiligheidsdocumenten. De index mag nooit veiligheidskritische instructies parafraseren wanneer het gecontroleerde document de autoriteit is.

Kleine brochuresites met vijf stabiele pagina’s hebben mogelijk weinig baat bij nog een onderhouden artefact. Sites zonder duidelijke inhoudseigenaar moeten eerst canonicalisatie, navigatie en bronkwaliteit verbeteren voordat ze een bestand publiceren dat direct zal afwijken.

Zoekintentie

zoekintentie is het resultaat dat van een query wordt verwacht. Dit type heeft twee doelgroepen met verschillende intenties. Een machine haalt een voorspelbaar rootpad op en verwacht beknopte Markdown, stabiele koppen, canonieke links en geen decoratieve ruis. Een menselijke zoeker wil meestal implementatierichtlijnen: “llms.txt-voorbeeld”, “wat hoort in llms.txt” of “agent-manifestformaat”. De openbare uitlegpagina kan die vragen beantwoorden, terwijl het geïmplementeerde /llms.txt geoptimaliseerd blijft voor machine-ophaling.

Het bestand zelf is geen trefwoordbestemmingspagina. Voeg geen generieke definities, herhaalde categorietermen of honderden bloglinks toe om het te laten “rankën”. Elke extra regel kost aandacht en creëert een nieuwe onderhoudsverplichting. Geef de voorkeur aan tien bewuste links met duidelijke beschrijvingen boven een dump van tienduizend URL’s.

Omdat conventies en consumentenondersteuning kunnen veranderen, vermeld waarop uw implementatie is gebaseerd en vermijd te beweren dat er sprake is van universele adoptie. Een succesvolle ophaling bewijst alleen dat het bestand toegankelijk en parseerbaar is; het bewijst niet dat een bepaald AI-product het gebruikt voor rangschikking, ophaling, training of citatie.

Paginastructuur

Woordbanden zijn redactionele beperkingen, geen doelen. Het geïmplementeerde bestand moet beknopt genoeg blijven om regel voor regel te controleren. De voor mensen leesbare implementatienota kan langer zijn, maar mag niet worden gekopieerd naar het machinebestand.

Een typisch samengesteld bestand is ongeveer 200–700 woorden. Lengte is geen kwaliteitsindicator: de juiste grootte is de kleinste index die identiteit vaststelt en een consument naar onderhouden bronnen leidt zonder belangrijke onderscheidingen te verbergen.

Vereiste elementen

De index moet saai zijn in de beste zin: voorspelbaar, expliciet en gemakkelijk te diffen. Zet kritische interpretatie vóór optionele links, zodat een gedeeltelijke lezing geen valse conclusie oplevert.

Frontmatter

Volg de frontmatter-specificatie . Gebruik op deze posttype-specificatie entity = "post-type-llms-txt-page" en schemaType = "Article". Gebruik op een voor mensen leesbare implementatiepagina voor een specifieke organisatie een stabiele identiteit zoals acme-ai-access-index, geen campagneterm of datum.

Gebruik Article omdat de webpagina de implementatie uitlegt. schema-opmaak beschrijft zichtbare content; het verandert het ruwe tekstbestand niet in een erkend agentprotocol. Markeer de pagina niet als SoftwareApplication, Dataset of HowTo, tenzij de zichtbare content en het sjabloon onafhankelijk aan de relevante vereisten voldoen.

Het ruwe /llms.txt-bestand heeft normaal gesproken geen frontmatter omdat frontmatter niet in de gepubliceerde uitvoer mag lekken. Bewaar de operationele metadata in het CMS, de generatorconfiguratie of het repositoryrecord: canoniek domein, locale reikwijdte, eigenaar, broncollectie, generatiemodus, laatste verificatiedatum, volgende controlemoment, validatorresultaat en alertbestemming. Als er gelokaliseerde bestanden bestaan, documenteer dan de selectieregel en behoud één ondubbelzinnig canoniek root-antwoord.

Volledig voorbeeld

Dit fictieve bestand toont een beknopte index voor een SaaS-platform. De URL’s, het product en de capaciteit zijn voorbeelden; het patroon is de specificatie.

# Northstar Analytics

> Northstar Analytics is een rapportageplatform voor operationele teams. Deze index verwijst naar de openbare pagina's die het product, de abonnementen, documentatie, beleid en ondersteunde agentcapaciteit definiëren.

Toegangsmachtigingen worden beheerd door robots.txt, authenticatie en het hieronder gelinkte beleid. Dit bestand verleent geen toegang of toestemming om content te hergebruiken.

## Product

- [Productoverzicht](https://www.northstar.example/product): Huidige productscope en ondersteunde rapportageworkflows.
- [Abonnementen en prijzen](https://www.northstar.example/pricing): Huidige openbare abonnementen, inbegrepen functies en factuurvoorwaarden.
- [Integraties](https://www.northstar.example/integrations): Ondersteunde gegevensbronnen en doelsystemen.

## Documentatie

- [Documentatiestartpagina](https://docs.northstar.example/): Huidige gebruikers- en beheerdersdocumentatie.
- [API-referentie](https://docs.northstar.example/api/): Openbare eindpunten, schema's, authenticatie, fouten en snelheidslimieten.
- [Release-opmerkingen](https://docs.northstar.example/releases/): Gedateerde wijzigingen aan product- en API-gedrag.

## Vertrouwen en ondersteuning

- [Beveiliging](https://www.northstar.example/security): Beveiligingsprogramma en huidige assurance-documenten.
- [Privacybeleid](https://www.northstar.example/privacy): Gegevensverwerking, -bewaring en gebruikersrechten.
- [Ondersteuning](https://www.northstar.example/support): Ondersteunde contactroutes en servicestatuslink.

## Agentcapaciteit

- [Rapportexportactie](https://docs.northstar.example/agents/export-report): Geauthenticeerd actiecontract, geaccepteerde invoer, uitvoerformaat, snelheidslimieten en foutafhandeling. Beschikbaarheid hangt af van het abonnement en de rol van de gebruiker.

## Optioneel

- [Onderzoeksbibliotheek](https://www.northstar.example/research): Originele benchmarkrapporten met methoden en publicatiedata.

Geverifieerd op 2026-08-27 door het Documentatie Operations-team. Gegenereerd uit het canonieke openbare-bronnenregister; valideer na product-, abonnement-, beleids-, API- of URL-wijzigingen.

Het voorbeeld declareert slechts één capaciteit omdat er een echt, gedocumenteerd actiecontract bestaat. Als het product geen ondersteunde agentactie heeft, laat die sectie dan weg. Leid nooit een transactionele capaciteit af uit de aanwezigheid van een zoekvak, formulier of niet-gedocumenteerd eindpunt.

Bewaar voor een apart van /llms.txt opgeslagen agent-manifest dezelfde discipline. Specificeer een versieformaat, canonieke identificatie, productie-eindpunt, authenticatiemethode, toegestane bewerkingen, invoer- en uitvoerschema, snelheidslimieten, toestemmingsgrenzen, fouttoestanden en beleids-URL’s. Valideer het tegen het live systeem. Een syntactisch geldige verklaring die een uitgeschakelde actie adverteert, is nog steeds fout.

Ontwerpgallery

Het ruwe bestand heeft weinig visueel ontwerp door opzet. Galleryvarianten moeten informatiearchitectuur, scanvolgorde, mobiele leesbaarheid van de menselijke implementatiepagina en operationeel bewijs testen—geen decoratie.

Kwaliteitscontrolelijst

Publiceer alleen wanneer elke toepasselijke bewering waar is:

• Het bestand is bereikbaar via de beoogde root-URL zonder authenticatie, redirect-loops, toestemmingsmuren of een gerenderde applicatieshell.
• De respons is leesbare platte tekst of Markdown, gebruikt UTF-8 en is niet afhankelijk van JavaScript om de inhoud te tonen.
• De H1 geeft de canonieke organisatie- of sitenaam en de beschrijving vermeldt doel, publiek en reikwijdte zonder slogans.
• Elke gelinkte URL is canoniek, openbaar, indexeerbaar volgens beleid, bereikbaar en eigendom van de organisatie of duidelijk gemarkeerd als extern.
• Linkbeschrijvingen geven aan welk gezag de bestemming heeft; ze herhalen geen generieke ankertekst zoals “leer meer.”
• Primaire product-, prijs-, documentatie-, beleids- en ondersteuningsbronnen komen overeen met de index.
• Archiefpagina’s, zoekresultaten, trackingparameters, dubbele locale’s, campagne pagina’s en laagwaardige tagpagina’s zijn uitgesloten.
• Capaciteitsclaims komen overeen met een live, ondersteund, geauthenticeerd contract en bevatten de relevante beperkingen.
• Er komt geen geheim, token, privé-eindpunt, persoonsgegevens, klantdocument, niet-gepubliceerd roadmapitem of beveiligingsgevoelig implementatiedetail voor.
• Toegangs-, toestemmings-, licentie- en beleidstaal verwijst naar beherende bronnen en wordt niet tegengesproken door de index.
• Het bestand beweert geen gegarandeerde rangschikking, citatie, trainingsuitsluiting of universele consumentenondersteuning.
• Locale en regionale reikwijdte zijn expliciet waar prijzen, beleid, beschikbaarheid of documentatie verschillen.
• De eigenaar, bronnenregister, generatieproces en validatiemethode zijn buiten of aan het einde van het bestand vastgelegd.
• Controles op verbroken links, onverwachte redirects, responsstatus, content-hash en vereiste secties worden uitgevoerd na relevante implementaties.
• De verificatiedatum verandert alleen nadat bestemmingen, beschrijvingen, capaciteiten en beleid inhoudelijk zijn gecontroleerd.

Veelgemaakte fouten

Het bestand behandelen als een sitemap. Een volledige URL-inventaris vernietigt prioritering en is moeilijk te beoordelen. Houd XML-sitemaps voor ontdekking; beheer llms.txt rond gezaghebbende bronnen en betekenisvolle groepen.

Het behandelen als toegangscontrole. Een verzoek in Markdown is geen handhavingslaag. Druk crawlregels uit in robots.txt, bescherm privébronnen met authenticatie en plaats bindende vereisten in het relevante beleid en systeemcontroles.

Bestemmingscontent kopiëren naar de index. Herhaalde prijzen, productspecificaties en beleid gaan uiteenlopen. Vat alleen genoeg samen om het gezag te identificeren en link vervolgens naar de onderhouden bron.

Speculatieve capaciteiten publiceren. Een niet-gedocumenteerd formulier of API-route maakt een site niet agent-gereed. Declareer alleen productie-ondersteunde acties met authenticatie, schema’s, beperkingen, fouten en een eigenaar.

Alles opnemen “voor het geval dat.” Meer links creëren meer dubbelzinnigheid en meer foutpunten. Optionele content moet opname verdienen door een waarschijnlijke ophaalbehoefte te beantwoorden die primaire secties niet dekken.

Privémateriaal blootstellen. Openbare machine-leesbare bestanden zijn openbaar. Vermeld nooit staging-hosts, interne API’s, inloggegevens, klantexporten, niet-gepubliceerde documenten of beveiligingsdetails die niet opzettelijk zijn goedgekeurd voor publicatie.

Genereren zonder governance. Automatisering kan slechte brongegevens snel reproduceren. Een generator heeft een goedgekeurd bronnenregister, uitsluitingsregels, deterministische ordening, validatie, beoordelingseigenaar en implementatie-alerts nodig.

Handmatig bewerken van een gegenereerd bestand. De volgende generatie overschrijft de correctie. Corrigeer het bronrecord of de generator, regenereer en leg de materiële wijziging vast.

Niet-ondersteunde uitkomsten claimen. “Dit garandeert AI-citaties” verandert een onzekere implementatieconventie in een misleidende belofte. Rapporteer toegankelijkheid en ophaalbewijs apart van zichtbaarheids- en citatie-uitkomsten.

Datum bijwerken zonder de werkelijkheid te controleren. Een nieuwe tijdstempel kan een dode documentatie-URL, hernoemd abonnement of uitgeschakelde actie niet herstellen. Verificatie betekent het vergelijken van elke belangrijke verklaring met de productiebron.

Interne koppeling

Link de menselijke implementatiepagina omhoog naar SEO-posttypes wanneer een auteur de machine-index moet onderscheiden van een directory, documentatiepagina of beleid. Link van elke operationele claim naar de beherende bron: productscope naar de productpagina, huidige prijzen naar prijzen, gedrag naar documentatie, toestemmingen naar toegangscontroles en verplichtingen naar beleid.

Het ruwe bestand moet canonieke absolute URL’s gebruiken omdat het mogelijk buiten de normale sitenavigatie wordt opgehaald. Geef de voorkeur aan één gezaghebbende bestemming per feit. Als twee pagina’s overlappen, los dan het eigenaarschap op voordat beide worden vermeld; de index moet de bronhiërarchie tonen, geen interne onenigheid vereeuwigen.

Gebruik korte, stabiele sectienamen zoals Product, Documentatie, Beleid en Agentcapaciteiten. Houd locale varianten in duidelijk gelabelde groepen alleen wanneer ze materieel verschillen. Link niet naar elke blogpost; selecteer alleen duurzaam onderzoek of handleidingen wanneer ze een systeem helpen het onderwerp en bewijs van de site te begrijpen.

Inkomende links zijn ook operationeel belangrijk. Documentatie, ontwikkelaarsportalen en AI-toegankelijkheidsrichtlijnen moeten beheerders naar het implementatierecord verwijzen, terwijl het record naar het live bestand en de validator verwijst. Dat creëert een beoordelingspad voor mensen zonder de machine-index te vervuilen.

Hoe resultaten te meten

Meet het bestand eerst als infrastructuur en pas daarna als zichtbaarheidsinput. Een toename in citaties kan niet aan llms.txt worden toegeschreven alleen omdat beide na publicatie plaatsvonden.

Houd vier lagen bij:

• Beschikbaarheid: root-URL responsstatus, redirectgedrag, contenttype, codering, latentie, renderonafhankelijkheid en uptime.
• Integriteit: parseersucces, vereiste secties, dubbele URL’s, verbroken links, redirectdoelen, canonieke mismatch, niet-geautoriseerde domeinen, blootgestelde geheimen en content-hashwijzigingen.
• Versheid: dagen sinds inhoudelijke verificatie, bestemmingswijzigingen sinds verificatie, bronnenregisterdekking, eigenaarsbevestiging en tijd om afwijking te herstellen.
• Uitkomsten: serverlog-ophalingen door identificeerbare agents waar wettelijk en technisch passend, bezoeken aan geïndexeerde bestemmingen, AI-citaties van geprefereerde canonieke pagina’s en antwoordnauwkeurigheid voor bijgehouden merk- of productvragen.

Stel een basislijn vast vóór implementatie: welke URL’s worden geciteerd, welke feiten worden verkeerd weergegeven, of het rootbestand bestaat en welke crawlers het opvragen. Annoteer publicatie en elke materiële update. Vergelijk observatievensters die lang genoeg zijn om te voorkomen dat één ophaling of citatie als trend wordt gelezen, en behoud het onderscheid tussen correlatie en causaal verband.

Test de foutmodi direct. Hernoem een stagingkopie van een vermelde URL en bevestig dat de validator de breuk detecteert. Wijzig een canonieke mapping en bevestig dat de generator de index bijwerkt. Schakel een capaciteit uit in een gecontroleerde testomgeving en bevestig dat de manifestcontrole faalt. Deze tests bewijzen het onderhoudssysteem, niet externe adoptie.

Gebruik hoe we resultaten meten om technische beschikbaarheid, machinerepresentatie, ontdekking, citatie, betrokkenheid en bedrijfsresultaten te scheiden. Bekijk in AmICited het live bestand onder Agent Accessibility en gebruik het Cockpit-rapport om geciteerde URL’s en AI-zichtbaarheid te observeren naast implementatieannotaties. De geloofwaardige succesclaim is “het bestand is geldig, actueel en leidt systemen naar de beoogde bronnen”; eventuele stroomafwaartse zichtbaarheidsverandering vereist apart bewijs.

FAQ

Veelgestelde vragen