llms.txt a stránky manifestu agentov: Udržiavaný strojovo čitateľný index stránky

Stránka llms.txt a manifestu agenta je strojovo orientovaný index, ktorý hovorí AI systémom, čo stránka predstavuje, ktoré verejné stránky sú autoritatívne a — keď podnik podporuje akcie agentov — ktoré overené schopnosti a politiky platia. Je to mapa k udržiavaným zdrojom, nie náhrada za tieto zdroje a nie sľub, že ju bude používať konkrétny prehľadávač.

Jeho zmluvou je identita → rozsah → autoritatívne ciele → voliteľné schopnosti → obmedzenia → aktuálnosť. Súbor je úspešný, keď ho stroj dokáže získať, interpretovať bez hádania, sledovať živé kanonické URL a dospieť k faktom, ktoré stále zodpovedajú produkčnej realite.

Otázky, na ktoré odpovedá

Primárna otázka je: „Ktoré časti tejto stránky by mal AI systém použiť na pochopenie organizácie, jej obsahu a podporovaných akcií?“ Podporné otázky zahŕňajú:

• Aký je kanonický názov stránky, doména, účel a publikum?
• Ktoré stránky produktov, služieb, dokumentácie, cien, politík a podpory sú autoritatívne?
• Ktoré stránky by mali byť uprednostnené pred archívmi, kampanovými stránkami, parametrami alebo duplicitnými regionálnymi verziami?
• Vystavuje stránka skutočnú schopnosť agenta, alebo len čitateľné informácie?
• Kde sú zdokumentované autentifikácia, limitovanie, spracovanie údajov, obchodné podmienky a podpora?
• Ktoré vyhlásenia sú opisným usmernením a nie pravidlami riadenia prístupu?
• Kto vlastní súbor, aká udalosť spúšťa aktualizáciu a ako sa zisťuje odchýlka?

Kedy použiť tento typ príspevku

Tento typ použite, keď má stránka dostatok verejného, trvalého obsahu, ktorý profituje z usporiadaného strojovo orientovaného indexu, a keď niekto môže vlastniť jeho údržbu. Dôvodom na zverejnenie je znížiť nejednoznačnosť pre vyhľadávacie systémy, nie vytvoriť ďalšiu URL len pre ňu samotnú.

Nezamieňajte usmernenie s kontrolou. robots.txt vyjadruje preferencie prístupu prehľadávačov; XML sitemap pomáha prehľadávačom objavovať URL; autentifikácia a autorizácia rozhodujú, či akcia môže nastať. llms.txt poskytuje usporiadaný kontext. Veta v llms.txt nemôže udeliť prístup, odobrať prístup, chrániť tajomstvo ani prepísať podmienky cieľovej stránky.

Najvhodnejšie pre tieto typy podnikov

1. SaaS . Najsilnejšie prispôsobenie, pretože softvérová spoločnosť má zvyčajne odlišné zdroje produktov, funkcií, cien, integrácií, API, bezpečnosti, stavu a dokumentácie. Index môže vyriešiť, ktorá stránka vlastní ktorý fakt, zatiaľ čo samostatný manifest schopností môže popísať len akcie, ktoré produkt skutočne podporuje.
2. Ecommerce . Silné, keď sú produkty, doprava, vrátenie tovaru, dostupnosť a politiky zákazníckeho servisu verejné a kanonické. Udržujte volatilné údaje o položkách v feedoch alebo API; použite index na odkazovanie na tieto udržiavané zdroje namiesto kopírovania katalógu do Markdown.
3. Marketplaces . Cenné, keď sa politiky kupujúcich, predávajúcich, poskytovateľov a platformy líšia. Označte každé publikum a jurisdikciu, aby agent neuplatnil pravidlá predávajúceho na kupujúceho alebo neodvodil inventár platformy z jedného inzerátu.
4. B2B služby . Užitočné na objasnenie schopností, odvetví, hraníc služieb, dôkazov, obstarávacích materiálov a kontaktných ciest. Nemeňte dohodnutý rozsah alebo sľub špecifický pre klienta na univerzálne strojovo čitateľné tvrdenie.
5. Agentúry . Užitočné, keď firma udržiava mnoho stránok služieb, metodológií, prípadových štúdií a odborných znalostí. Portály klientov, poverenia, súkromné správy a interné playbooky zostávajú mimo verejného súboru.
6. Výrobcovia a priemyselné podniky . Užitočné na nasmerovanie systémov na produktové rodiny, špecifikácie, certifikácie, príručky, distribútorov a bezpečnostné dokumenty. Index nikdy nesmie parafrázovať bezpečnostne kritické pokyny, keď je riadený dokument autoritou.

Malé brožúrové stránky s piatimi stabilnými stránkami môžu získať málo z ďalšieho udržiavaného artefaktu. Stránky bez jasného vlastníka obsahu by mali najprv opraviť kanonizáciu, navigáciu a kvalitu zdrojov pred zverejnením súboru, ktorý okamžite zastará.

Zámer vyhľadávania

Zámer vyhľadávania je výsledok očakávaný od dotazu. Tento typ má dve publiká s rôznym zámerom. Stroj načíta predvídateľnú koreňovú cestu a očakáva stručný Markdown, stabilné nadpisy, kanonické odkazy a žiadny dekoratívny šum. Ľudský vyhľadávač zvyčajne chce implementačné usmernenie: „llms.txt príklad“, „čo patrí do llms.txt“ alebo „formát manifestu agenta“. Verejná vysvetľujúca stránka môže odpovedať na tieto otázky, zatiaľ čo nasadený /llms.txt zostáva optimalizovaný pre strojové vyhľadávanie.

Samotný súbor nie je vstupnou stránkou pre kľúčové slová. Nepridávajte všeobecné definície, opakované kategórie alebo stovky blogových odkazov, aby „rankoval“. Každý riadok navyše spotrebúva pozornosť a vytvára ďalšiu povinnosť údržby. Uprednostnite desať zámerných odkazov s jasnými popismi pred výpisom desaťtisíc URL.

Pretože konvencie a podpora spotrebiteľov sa môžu meniť, uveďte, na čom je vaša implementácia založená, a vyhnite sa tvrdeniu o univerzálnej adopcii. Úspešné načítanie dokazuje len to, že súbor je dostupný a spracovateľný; nedokazuje, že ho konkrétny AI produkt používa na hodnotenie, vyhľadávanie, trénovanie alebo citácie.

Štruktúra stránky

Slovné rozsahy sú editačné obmedzenia, nie ciele. Nasadený súbor by mal zostať dostatočne stručný na auditovanie riadok po riadku. Implementačná poznámka pre ľudí môže byť dlhšia, ale nesmie byť skopírovaná do strojového súboru.

Typický usporiadaný súbor má približne 200–700 slov. Dĺžka nie je signál kvality: správna veľkosť je najmenší index, ktorý stanovuje identitu a smeruje spotrebiteľa k udržiavaným zdrojom bez skrývania kľúčových rozdielov.

Povinné prvky

Index musí byť nudný v najlepšom zmysle slova: predvídateľný, explicitný a ľahko porovnateľný. Umiestnite kritickú interpretáciu pred voliteľné odkazy, aby čiastočné prečítanie neviedlo k nesprávnemu záveru.

Frontmatter

Postupujte podľa špecifikácie frontmatter . Na tejto špecifikácii typu príspevku použite entity = "post-type-llms-txt-page" a schemaType = "Article". Na implementačnej stránke pre konkrétnu organizáciu použite stabilnú identitu, ako napríklad acme-ai-access-index, nie frázu kampane alebo dátum.

Použite Article, pretože webová stránka vysvetľuje implementáciu. schema markup popisuje viditeľný obsah; nemení surový textový súbor na uznávaný agentný protokol. Neoznačujte stránku ako SoftwareApplication, Dataset alebo HowTo, pokiaľ jej viditeľný obsah a šablóna nespĺňajú príslušné požiadavky nezávisle.

Surový /llms.txt súbor normálne nemá frontmatter, pretože frontmatter nesmie presakovať do publikovaného výstupu. Jeho operačné metadáta ukladajte v CMS, konfigurácii generátora alebo zázname repozitára: kanonická doména, jazykový rozsah, vlastník, zdrojová kolekcia, režim generovania, dátum posledného overenia, pravidlo ďalšej kontroly, výsledok validátora a cieľ upozornenia. Ak existujú lokalizované súbory, zdokumentujte pravidlo výberu a zachovajte jednu jednoznačnú kanonickú koreňovú odpoveď.

Úplný príklad

Tento fiktívny súbor demonštruje stručný index pre SaaS platformu. Jeho URL, produkt a schopnosť sú príklady; vzor je špecifikácia.

# Northstar Analytics

> Northstar Analytics je reportovacia platforma pre operačné tímy. Tento index ukazuje na verejné stránky, ktoré definujú produkt, plány, dokumentáciu, politiky a podporovanú schopnosť agenta.

Prístupové povolenia sú riadené robots.txt, autentifikáciou a politikami uvedenými nižšie. Tento súbor neudeľuje prístup ani povolenie na opätovné použitie obsahu.

## Produkt

- [Prehľad produktu](https://www.northstar.example/product): Aktuálny rozsah produktu a podporované reportovacie pracovné postupy.
- [Plány a ceny](https://www.northstar.example/pricing): Aktuálne verejné plány, zahrnuté funkcie a fakturačné podmienky.
- [Integrácie](https://www.northstar.example/integrations): Podporované zdroje údajov a cieľové systémy.

## Dokumentácia

- [Domov dokumentácie](https://docs.northstar.example/): Aktuálna dokumentácia pre používateľov a administrátorov.
- [API referencia](https://docs.northstar.example/api/): Verejné endpointy, schémy, autentifikácia, chyby a limity.
- [Poznámky k vydaniam](https://docs.northstar.example/releases/): Dátumované zmeny v správaní produktu a API.

## Dôvera a podpora

- [Bezpečnosť](https://www.northstar.example/security): Bezpečnostný program a aktuálne dokumenty o zárukách.
- [Ochrana súkromia](https://www.northstar.example/privacy): Spracovanie údajov, uchovávanie a práva používateľov.
- [Podpora](https://www.northstar.example/support): Podporované kontaktné cesty a odkaz na stav služby.

## Schopnosť agenta

- [Akcia exportu reportu](https://docs.northstar.example/agents/export-report): Autentifikovaná zmluva o akcii, akceptované vstupy, výstupný formát, limity a spracovanie chýb. Dostupnosť závisí od plánu a roly používateľa.

## Voliteľné

- [Knižnica výskumu](https://www.northstar.example/research): Originálne benchmarkové správy s metódami a dátumami publikácie.

Overené 2026-08-27 tímom Dokumentačných operácií. Vygenerované z kanonického registra verejných zdrojov; validujte po zmenách produktu, plánu, politiky, API alebo URL.

Príklad deklaruje iba jednu schopnosť, pretože existuje reálna, zdokumentovaná zmluva o akcii. Ak produkt nemá žiadnu podporovanú akciu agenta, túto sekciu vynechajte. Nikdy neodvodzujte transakčnú schopnosť z prítomnosti vyhľadávacieho poľa, formulára alebo nezdokumentovaného endpointu.

Pre manifest agenta uložený oddelene od /llms.txt dodržiavajte rovnakú disciplínu. Špecifikujte verzovaný formát, kanonický identifikátor, produkčný endpoint, metódu autentifikácie, povolené operácie, vstupnú a výstupnú schému, limity, hranice súhlasu, chybové stavy a URL politík. Validujte ho voči živému systému. Syntakticky platné vyhlásenie, ktoré inzeruje zakázanú akciu, je stále nesprávne.

Galéria dizajnov

Surový súbor má zámerne málo vizuálneho dizajnu. Varianty galérie by mali testovať informačnú architektúru, poradie skenovania, mobilnú čitateľnosť implementačnej stránky pre ľudí a operačné dôkazy — nie dekoráciu.

Kontrolný zoznam kvality

Zverejnite len vtedy, keď je každé použiteľné tvrdenie pravdivé:

• Súbor je dostupný na zamýšľanej koreňovej URL bez autentifikácie, presmerovacích slučiek, súhlasných stien alebo vykreslenej aplikačnej škrupiny.
• Odpoveď je čitateľný obyčajný text alebo Markdown, používa UTF-8 a nezávisí od JavaScriptu na odhalenie svojho obsahu.
• H1 uvádza kanonický názov organizácie alebo stránky a popis uvádza účel, publikum a rozsah bez sloganov.
• Každá odkazovaná URL je kanonická, verejná, indexovateľná podľa politiky, dosiahnuteľná a vlastnená organizáciou alebo jasne označená ako externá.
• Popisy odkazov hovoria, akú autoritu cieľ drží; neopakujú generický text kotvy ako „zistite viac“.
• Primárne zdroje produktu, cien, dokumentácie, politiky a podpory sú v súlade s indexom.
• Archívne stránky, výsledky vyhľadávania, sledovacie parametre, duplicitné jazykové mutácie, kampanové stránky a nízkohodnotné stránky tagov sú vylúčené.
• Tvrdenia o schopnostiach zodpovedajú živému, podporovanému, autentifikovanému kontraktu a obsahujú príslušné obmedzenia.
• Neobjavuje sa žiadne tajomstvo, token, súkromný endpoint, osobné údaje, klientsky dokument, nezverejnená položka roadmapy ani bezpečnostne citlivý detail implementácie.
• Jazyk prístupu, povolení, licencovania a politiky odkazuje na riadiace zdroje a nie je v rozpore s indexom.
• Súbor netvrdí zaručené hodnotenie, citáciu, vylúčenie z trénovania ani univerzálnu podporu spotrebiteľov.
• Jazykový a regionálny rozsah sú explicitné všade, kde sa ceny, politiky, dostupnosť alebo dokumentácia líšia.
• Vlastník, register zdrojov, proces generovania a metóda validácie sú zaznamenané mimo súboru alebo na jeho konci.
• Kontroly nefunkčných odkazov, neočakávaných presmerovaní, stavových kódov, hashov obsahu a požadovaných sekcií sa vykonávajú po relevantných nasadeniach.
• Dátum overenia sa mení len po vecnej kontrole cieľov, popisov, schopností a politík.

Časté chyby

Považovanie súboru za sitemapu. Úplný inventár URL ničí prioritizáciu a je ťažko kontrolovateľný. Uchovávajte XML sitemapy pre objavovanie; usporiadajte llms.txt okolo autoritatívnych zdrojov a zmysluplných skupín.

Považovanie za riadenie prístupu. Požiadavka v Markdown nie je vynucovacia vrstva. Vyjadrite pravidlá prehľadávania v robots.txt, chráňte súkromné zdroje autentifikáciou a umiestnite záväzné požiadavky do príslušných politík a systémových kontrol.

Kopírovanie cieľového obsahu do indexu. Opakované ceny, špecifikácie produktov a politiky sa rozchádzajú. Zhrňte len toľko, aby ste identifikovali autoritu, potom odkážte na udržiavaný zdroj.

Zverejňovanie špekulatívnych schopností. Nezdokumentovaný formulár alebo API cesta nerobí stránku pripravenú pre agentov. Deklarujte len produkčne podporované akcie s autentifikáciou, schémami, obmedzeniami, chybami a vlastníkom.

Zahrnutie všetkého „pre každý prípad“. Viac odkazov vytvára viac nejednoznačnosti a viac bodov zlyhania. Voliteľný obsah by si mal zarobiť zahrnutie odpovedaním na pravdepodobnú potrebu vyhľadávania, ktorú primárne sekcie nepokrývajú.

Odhalenie súkromného materiálu. Verejné strojovo čitateľné súbory sú verejné. Nikdy neuvádzajte staging hosty, interné API, poverenia, exporty zákazníkov, nezverejnené dokumenty ani bezpečnostné detaily, ktoré neboli zámerne schválené na publikáciu.

Generovanie bez riadenia. Automatizácia môže reprodukovať zlé zdrojové dáta rýchlosťou. Generátor potrebuje schválený register zdrojov, pravidlá vylúčenia, deterministické poradie, validáciu, vlastníctvo kontroly a výstrahy pri nasadení.

Ručná úprava vygenerovaného súboru. Ďalšie generovanie prepíše opravu. Opravte zdrojový záznam alebo generátor, znova vygenerujte a zaznamenajte podstatnú zmenu.

Tvrdenie o nepodporovaných výsledkoch. „Toto zaručuje AI citácie“ mení neistú implementačnú konvenciu na zavádzajúci sľub. Reportujte dôkazy o dostupnosti a vyhľadávaní oddelene od výsledkov viditeľnosti a citácií.

Aktualizácia dátumu bez kontroly reality. Nový časový údaj nemôže opraviť mŕtvu URL dokumentácie, premenovaný plán ani zakázanú akciu. Overenie znamená porovnanie každého dôležitého vyhlásenia s jeho produkčným zdrojom.

Interné prepojenie

Prepojte implementačnú stránku pre ľudí smerom nahor na SEO typy príspevkov , keď autor musí rozlíšiť strojový index od adresára, dokumentačnej stránky alebo politiky. Prepojte každé operačné tvrdenie s jeho riadiacim zdrojom: rozsah produktu so stránkou produktu, aktuálne ceny s cenami, správanie s dokumentáciou, povolenia s riadením prístupu a povinnosti s politikou.

Surový súbor by mal používať kanonické absolútne URL, pretože môže byť načítaný mimo bežnej navigácie stránky. Uprednostnite jednu autoritatívnu destináciu na fakt. Ak sa dve stránky prekrývajú, vyriešte vlastníctvo pred uvedením oboch; index by mal odhaliť hierarchiu zdrojov, nie zakonzervovať interný nesúlad.

Používajte krátke, stabilné názvy sekcií ako Produkt, Dokumentácia, Politiky a Schopnosti agenta. Udržujte jazykové varianty v jasne označených skupinách len vtedy, keď sa materiálne líšia. Neodkazujte na každý blogový príspevok; vyberte trvalý výskum alebo príručky len vtedy, keď pomáhajú systému pochopiť tému a dôkazy stránky.

Prichádzajúce odkazy sú dôležité aj operačne. Dokumentácia, vývojárske portály a usmernenie AI dostupnosti by mali smerovať správcov k implementačnému záznamu, zatiaľ čo záznam ukazuje na živý súbor a validátor. To vytvára cestu kontroly pre ľudí bez zahltenia strojového indexu.

Ako merať výsledky

Merajte súbor najprv ako infraštruktúru a až potom ako vstup viditeľnosti. Zvýšenie citácií nemožno pripísať llms.txt len preto, že oboje nastalo po publikácii.

Sledujte štyri vrstvy:

• Dostupnosť: stavová odpoveď koreňovej URL, správanie presmerovania, typ obsahu, kódovanie, latencia, nezávislosť od vykreslenia a prevádzková doba.
• Integrita: úspešnosť parsovania, požadované sekcie, duplicitné URL, nefunkčné odkazy, ciele presmerovania, kanonický nesúlad, neautorizované domény, odhalené tajomstvá a zmeny hash obsahu.
• Aktuálnosť: dni od vecného overenia, zmeny cieľov od overenia, pokrytie registra zdrojov, potvrdenie vlastníkom a čas na opravu odchýlky.
• Výsledky: načítania zo serverových logov identifikovateľnými agentmi tam, kde je to právne a technicky vhodné, návštevy indexovaných cieľov, AI citácie preferovaných kanonických stránok a presnosť odpovedí na sledované otázky značky alebo produktu.

Stanovte základnú líniu pred nasadením: ktoré URL sú citované, ktoré fakty sú nesprávne uvedené, či koreňový súbor existuje a ktoré prehľadávače ho vyžadujú. Anotujte publikáciu a každú podstatnú aktualizáciu. Porovnávajte pozorovacie okná, ktoré sú dostatočne dlhé na to, aby nedošlo k zámene jedného načítania alebo citácie za trend, a zachovajte rozdiel medzi koreláciou a kauzalitou.

Testujte režimy zlyhania priamo. Premenujte stagingovú kópiu uvedenej URL a potvrďte, že validátor zachytí zlom. Zmeňte kanonické mapovanie a potvrďte, že generátor aktualizuje index. Zakažte schopnosť v riadenom testovacom prostredí a potvrďte, že kontrola manifestu zlyhá. Tieto testy dokazujú systém údržby, nie externú adopciu.

Použite ako meriame výsledky na oddelenie technickej dostupnosti, strojovej reprezentácie, objavovania, citácií, angažovanosti a obchodných výsledkov. V AmICited skontrolujte živý súbor v sekcii Agent Accessibility a použite Cockpit report na sledovanie citovaných URL a AI viditeľnosti spolu s anotáciami nasadenia. Dôveryhodný úspech je „súbor je platný, aktuálny a smeruje systémy k zamýšľaným zdrojom“; akákoľvek zmena viditeľnosti smerom nadol vyžaduje samostatný dôkaz.

FAQ

Často kladené otázky