NewNo plan feeNo plan fee. Just 2.9% + $0.30 per card sale, and signing up is free.Try now →

Agentic commerce

llms.txt

llms.txt is een afspraak die een markdown-bestand op de root van een site plaatst, dat samenvat wat de site is en welke URL welke vraag beantwoordt, zodat assistenten niet alles hoeven te crawlen.

Of grote assistenten het consumeren is nog steeds onduidelijk. Wat wel vaststaat, is de adoptie: we hebben 58 bekende DTC-merken gecontroleerd en 73% van de bereikbare merken publiceert er al een — maar 70% daarvan heeft het niet zelf geschreven, omdat Shopify automatisch een sjabloonbestand genereert. Het publiceren ervan is daarom een basisvereiste in plaats van een voordeel.

Dat verschuift de nuttige vraag van of je er een moet hebben naar of de standaardinstelling jou beschrijft. Een gegenereerd bestand van 4.3KB beschrijft een generieke winkel; het weet niet welke producten belangrijk zijn, welke vragen je kopers stellen, of wat jou onderscheidt van de tweeëntwintig andere merken die een bijna identiek document publiceren.

De enige regel die bepaalt of het iets waard is: genereer het, schrijf het niet handmatig. Een handmatig bijgehouden index veroudert binnen twee implementaties, en een verouderde index is erger dan geen, omdat deze vol vertrouwen verwijst naar pagina's die zijn verplaatst.

Er is nu bewijs voor die regel, verder dan veroudering. Onder de winkels die we vonden die een agent-checkout accepteren, publiceren verschillende een handmatig geschreven bestand dat nooit de eindpunten noemt waarop hun eigen winkel antwoordt — dus het bestand dat een zorgvuldig team schreef, verbergt een functionaliteit die het gegenereerde bestand aankondigt. Lees wat er op dat pad staat voordat je het vervangt.

Hoe het bestand eruitziet

Het voorstel beschrijft een markdown-document in plaats van een nieuwe syntaxis om te leren. Het begint met een kop van niveau één met de naam van de site of het project, gevolgd door een korte blockquote die zegt wat de site is — de ene paragraaf die een lezer zonder andere context nodig heeft. Gewone tekst kan erop volgen.

Daaronder komen secties van niveau twee, elk met een lijst van links met een korte notitie bij elke link: wat de pagina is, en wanneer het de juiste pagina is. Een sectie die conventioneel is gereserveerd voor optioneel materiaal markeert links die kunnen worden overgeslagen wanneer een kortere context nodig is, wat de enige prioritering is die het formaat zelf met zich meebrengt.

Een aanvullende conventie plaatst een uitgebreid bestand op een apart pad, dat de inhoud zelf bevat in plaats van een index van links. De twee dienen verschillende behoeften: de ene oriënteert een lezer die de site nog nooit heeft gezien, de andere levert tekst zonder navigatie-elementen eromheen.

Het formaat is opzettelijk onopvallend. Alles wat van belang is aan de conventie is redactioneel — welke pagina's je noemt en hoe je ze beschrijft — omdat er verder niets in zit om fout te doen.

Waar het zich bevindt tussen de machinegerichte bestanden

De verwarring die teams iets kost, gaat niet over het formaat, het gaat over wat het bestand regelt. Door het naast de andere oppervlakken te plaatsen die een winkel voor machines publiceert, wordt de grens duidelijk.

De laatste rij is het hele argument. Drie hiervan hebben gedocumenteerde consumenten en gedefinieerde gevolgen; de vierde heeft geen van beide, wat tegelijkertijd het argument is om er een te publiceren en het argument om er geen project aan te besteden.

OppervlakWat het vermeldtGedocumenteerde consumentenWat er misgaat als het fout is
robots.txtWelke crawlers welke paden mogen ophalenElke grote crawler documenteert dat het deze respecteertEen onzorgvuldige 'disallow' verwijdert je volledig uit zoekmachines
sitemap.xmlWelke URL's bestaan en wanneer ze zijn gewijzigdZoekmachines documenteren dat ze het lezenTrage of gemiste ontdekking van nieuwe en gewijzigde pagina's
schema.org JSON-LDWat de feiten op deze pagina zijnZoekmachines documenteren dat ze het gebruiken voor rich resultsEen verouderde prijs of beschikbaarheid leidt tot vol vertrouwen gegeven foute antwoorden
llms.txtWat de site is en welke URL wat beantwoordtGeen enkele assistent-leverancier heeft gedocumenteerd dat het deze consumeertHeel weinig — wat ook het eerlijke argument is tegen inspanning
De vier machinegerichte oppervlakken die een winkel publiceert, en waarvoor elk dient.

Wat het niet kan doen

Drie functionaliteiten worden regelmatig aan dit bestand toegeschreven die het niet heeft, en elk heeft een andere juiste plek. Ze verkeerd begrijpen is hoe een team gaat geloven dat het een beleid heeft opgesteld, terwijl het een samenvatting heeft geschreven.

  • Het verleent en onthoudt niets. Er is geen directieve syntaxis en geen permissie-semantiek, dus het kan een crawler niet blokkeren. Toestemming is robots.txt voor crawlers die het respecteren, en een randregel voor degenen die dat niet doen.
  • Het vervangt geen gestructureerde data. Een index van URL's zegt niets over de prijs of beschikbaarheid op de pagina waarnaar het verwijst. Feiten horen in de markup op de pagina zelf, gegenereerd vanuit dezelfde bron waaruit de pagina wordt gerenderd.
  • Het is geen sitemap. Een sitemap somt elke URL op voor volledigheid; dit bestand selecteert er een paar en legt ze uit. Het reproduceren van de sitemap hier verwerpt het enige wat het formaat biedt, namelijk redactioneel oordeel over wat belangrijk is.

Wat je op je eigen domein moet controleren

De meeste winkels bieden er al een aan zonder dat iemand daartoe heeft besloten, omdat verschillende platforms het genereren. Dat maakt het controleren van het bestand dat je hebt nuttiger dan het schrijven van een nieuw bestand, en de controle bestaat uit vier commando's in plaats van een project.

  • Het content-type. Een route die stilletjes HTML retourneert, ziet er correct uit in een browser en is waardeloos voor een machine — en een catch-all pagina die 200 beantwoordt op dat pad, wordt door elk onderzoek dat statuscodes controleert in plaats van inhoud, als een adoptant beschouwd.
  • Of het iets benoemt dat je daadwerkelijk aanbiedt. Een gegenereerd bestand vermeldt soms machine-eindpunten die een handmatig geschreven vervanging stilzwijgend laat vallen, dus lees wat er staat voordat je het overschrijft.
  • Of het gegenereerd is. Een handmatig bijgehouden index veroudert binnen twee implementaties, en een verouderde index is erger dan geen, omdat deze vol vertrouwen verwijst naar pagina's die zijn verplaatst.
  • Of iets het opvraagt. Grep het toegangslogboek naar het pad. Een bestand dat niets ophaalt, is geen noodgeval, maar het is het enige directe bewijs dat beschikbaar is voor deze vraag en het kost één commando om te verkrijgen.

Veelgestelde vragen

Wat is llms.txt?
Een markdown-bestand op de root van een site dat samenvat wat de site is en welke URL welke vraag beantwoordt, zodat een AI-systeem zich kan oriënteren zonder alles te crawlen. Het is een gemeenschapsvoorstel in plaats van een standaard die is gepubliceerd door een zoek- of assistent-leverancier, en het verleent geen enkele vorm van toestemming.
Wat gaat er in een llms.txt bestand?
Een kop met de sitenaam, een korte blockquote die aangeeft wat de site verkoopt en wie het bedient, dan secties met links met elk een éénregelige beschrijving — categorieën, en de pagina's die echte vragen van vóór de aankoop beantwoorden, zoals maatvoering, verzending en retouren. Verwijs naar de sitemap-index voor de complete URL-lijst in plaats van deze te reproduceren.
Waar moet het llms.txt bestand staan?
Op de root van het domein dat klanten daadwerkelijk typen, aangeboden als markdown of platte tekst. Controleer het content-type na implementatie: een route die stilletjes HTML retourneert, wordt prima weergegeven in een browser en is nutteloos voor een machine, en het is de meest voorkomende manier waarop dit bestand stilzwijgend niet werkt.
Lezen AI-assistenten llms.txt daadwerkelijk?
Geen enkele assistent-leverancier heeft gedocumenteerd dat ze het gebruiken, en Google heeft publiekelijk verklaard dat hun systemen dat niet doen. Sommige zoekrobot-logs tonen dat het pad wordt opgevraagd, maar een ophaalactie is niet hetzelfde als een model dat de inhoud gebruikt. Behandel het bestand als goedkoop en onbewezen, in plaats van als een techniek met een verwacht resultaat.
Is llms.txt hetzelfde als robots.txt?
Nee. robots.txt vermeldt welke zoekrobots welke paden mogen ophalen en wordt vrijwillig gerespecteerd door goed gedragende zoekrobots. llms.txt biedt een samenvatting en verleent niets. Het verwijderen van robots.txt verandert wat zoekrobots mogen doen; het verwijderen van llms.txt verandert alleen wat ze als een snelkoppeling krijgen aangereikt.
Wat is llms-full.txt?
Een aanvullende conventie: in plaats van een index van links, een enkel bestand dat de uitgebreide inhoud zelf bevat, zodat een systeem het materiaal kan lezen zonder veel pagina's op te halen en de navigatie van elk ervan te verwijderen. Het is door het ontwerp veel groter en beantwoordt een andere behoefte dan het indexbestand.

Uitgebreid: Werkt llms.txt eigenlijk?

Verwante begrippen