llms.txt a stránky manifestu agentů: Udržovaný strojově čitelný index webu

Stránka llms.txt a manifest agenta je strojově čitelný index, který AI systémům sděluje, co web představuje, které veřejné stránky jsou autoritativní a — pokud podnik podporuje akce agentů — které ověřené schopnosti a zásady platí. Je to mapa k udržovaným zdrojům, nikoli náhrada těchto zdrojů a nikoli příslib, že ji jakýkoli konkrétní crawler použije.

Jejím kontraktem je identita → rozsah → autoritativní cíle → volitelné schopnosti → omezení → aktuálnost. Soubor uspěje, když jej stroj může načíst, interpretovat bez hádání, sledovat živé kanonické URL a dospět k faktům, která stále odpovídají produkční realitě.

Otázky, na které odpovídá

Hlavní otázka zní: „Které části tohoto webu by měl AI systém použít k pochopení organizace, jejího obsahu a podporovaných akcí?“ Podpůrné otázky zahrnují:

• Jaký je kanonický název webu, doména, účel a cílová skupina?
• Které stránky produktu, služby, dokumentace, cen, zásad a podpory jsou autoritativní?
• Které stránky by měly být preferovány před archivy, kampaněmi, parametry nebo duplicitními regionálními verzemi?
• Nabízí web skutečnou schopnost agenta, nebo pouze lidsky čitelnou informaci?
• Kde jsou zdokumentovány autentizace, omezení rychlosti, nakládání s daty, obchodní podmínky a podpora?
• Která tvrzení jsou popisným vodítkem, nikoli pravidly řízení přístupu?
• Kdo soubor vlastní, jaká událost spouští aktualizaci a jak se detekuje odchylka?

Kdy použít tento typ příspěvku

Použijte tento typ, pokud má web dostatek veřejného, trvalého obsahu, aby profitoval z kurátorského strojově čitelného indexu, a pokud existuje někdo, kdo může zajistit jeho údržbu. Důvodem k publikování je snížit nejednoznačnost pro vyhledávací systémy, nikoli vytvářet další URL pro vlastní potřebu.

Nezaměňujte vodítko s řízením. robots.txt vyjadřuje preference přístupu crawlerů; XML sitemap pomáhá crawlerům objevovat URL; autentizace a autorizace rozhodují, zda akce může proběhnout. llms.txt poskytuje kurátorský kontext. Věta v llms.txt nemůže udělit přístup, odebrat přístup, ochránit tajemství ani přepsat podmínky cílové stránky.

Nejvhodnější pro tyto typy podnikání

1. SaaS . Nejsilnější shoda, protože softwarová společnost má obvykle oddělené zdroje pro produkt, funkce, ceny, integrace, API, bezpečnost, stav a dokumentaci. Index může určit, která stránka vlastní které faktum, zatímco samostatný manifest schopností může popisovat pouze akce, které produkt skutečně podporuje.
2. Ecommerce . Silné, když jsou produkty, doprava, vrácení, dostupnost a zásady zákaznického servisu veřejné a kanonické. Udržujte volatilní data položek v feedech nebo API; pomocí indexu odkazujte na tyto udržované zdroje, místo abyste kopírovali katalog do Markdownu.
3. Marketplaces . Cenné, když se zásady pro kupující, prodávající, poskytovatele a platformu liší. Označte každé publikum a jurisdikci, aby agent nepoužil pravidla pro prodejce na kupujícího nebo neodvodil zásoby platformy z jedné nabídky.
4. B2B služby . Užitečné pro objasnění schopností, odvětví, hranic služeb, důkazů, nákupních materiálů a kontaktních cest. Nepřevádějte sjednaný rozsah nebo závazek vůči konkrétnímu klientovi na univerzální strojově čitelné tvrzení.
5. Agentury . Užitečné, když firma udržuje mnoho stránek služeb, metodik, případových studií a odborných znalostí. Portály klientů, pověření, soukromé zprávy a interní playbooky zůstávají mimo veřejný soubor.
6. Výrobci a průmyslové podniky . Užitečné pro směrování systémů na produktové rodiny, specifikace, certifikace, manuály, distributory a bezpečnostní dokumenty. Index nesmí nikdy parafrázovat bezpečnostně kritické pokyny, když je řízený dokument autoritou.

Malé brožurové weby s pěti stabilními stránkami mohou z dalšího udržovaného artefaktu získat jen málo. Weby bez jasného vlastníka obsahu by měly nejprve opravit kanonizaci, navigaci a kvalitu zdrojů, než publikují soubor, který okamžitě zastará.

Vyhledávací záměr

Vyhledávací záměr je výsledek očekávaný od dotazu. Tento typ má dvě cílové skupiny s různým záměrem. Stroj načítá předvídatelnou kořenovou cestu a očekává stručný Markdown, stabilní nadpisy, kanonické odkazy a žádný dekorativní šum. Lidský vyhledávač obvykle chce implementační návod: „příklad llms.txt“, „co patří do llms.txt“ nebo „formát manifestu agenta“. Veřejná vysvětlující stránka může na tyto otázky odpovědět, zatímco nasazený /llms.txt zůstává optimalizovaný pro strojové získávání.

Samotný soubor není vstupní stránkou pro klíčová slova. Nepřidávejte obecné definice, opakované kategorické termíny nebo stovky blogových odkazů, aby „rankoval“. Každý řádek navíc spotřebovává pozornost a vytváří další závazek údržby. Preferujte deset záměrných odkazů s jasnými popisy před výpisem deseti tisíc URL.

Protože se konvence a podpora spotřebitelů mohou měnit, uveďte, na čem je vaše implementace založena, a vyhněte se tvrzení o univerzální adopci. Úspěšné načtení dokazuje pouze to, že je soubor přístupný a parsovatelný; nedokazuje, že ho konkrétní AI produkt používá pro rankování, vyhledávání, trénování nebo citace.

Struktura stránky

Rozsahy počtu slov jsou editační omezení, nikoli cíle. Nasazený soubor by měl zůstat dostatečně stručný, aby byl auditovatelný řádek po řádku. Lidsky čitelná implementační poznámka může být delší, ale nesmí být zkopírována do strojového souboru.

Typický kurátorský soubor má zhruba 200–700 slov. Délka není signálem kvality: správná velikost je nejmenší index, který stanoví identitu a nasměruje spotřebitele k udržovaným zdrojům, aniž by skrýval klíčové rozdíly.

Požadované prvky

Index musí být nudný v tom nejlepším smyslu: předvídatelný, explicitní a snadno porovnatelný. Umístěte kritickou interpretaci před volitelné odkazy, aby částečné přečtení nevedlo k chybnému závěru.

Frontmatter

Postupujte podle specifikace frontmatter . U této specifikace typu příspěvku použijte entity = "post-type-llms-txt-page" a schemaType = "Article". Na lidsky čitelné implementační stránce pro konkrétní organizaci použijte stabilní identitu, například acme-ai-access-index, nikoli frázi z kampaně nebo datum.

Použijte Article, protože webová stránka vysvětluje implementaci. Schema markup popisuje viditelný obsah; neproměňuje raw textový soubor v uznávaný protokol pro agenty. Neoznačujte stránku jako SoftwareApplication, Dataset nebo HowTo, pokud její viditelný obsah a šablona nesplňují příslušné požadavky nezávisle.

Raw soubor /llms.txt obvykle nemá frontmatter, protože frontmatter nesmí uniknout do publikovaného výstupu. Ukládejte jeho provozní metadata v CMS, konfiguraci generátoru nebo záznamu repozitáře: kanonická doména, jazykový rozsah, vlastník, zdrojová kolekce, režim generování, datum posledního ověření, pravidlo příští revize, výsledek validátoru a cíl upozornění. Pokud existují lokalizované soubory, zdokumentujte pravidlo výběru a udržujte jedno jednoznačné kanonické kořenové odpovědi.

Úplný příklad

Tento fiktivní soubor demonstruje stručný index pro SaaS platformu. Jeho URL, produkt a schopnosti jsou příklady; vzor je specifikace.

# Northstar Analytics

> Northstar Analytics je reportingová platforma pro provozní týmy. Tento index ukazuje na veřejné stránky, které definují produkt, plány, dokumentaci, zásady a podporovanou schopnost agenta.

Přístupová oprávnění jsou řízena robots.txt, autentizací a zásadami uvedenými níže. Tento soubor neuděluje přístup ani oprávnění k opětovnému použití obsahu.

## Produkt

- [Přehled produktu](https://www.northstar.example/product): Aktuální rozsah produktu a podporované reportingové workflow.
- [Plány a ceny](https://www.northstar.example/pricing): Aktuální veřejné plány, zahrnuté funkce a platební podmínky.
- [Integrace](https://www.northstar.example/integrations): Podporované zdroje dat a cílové systémy.

## Dokumentace

- [Domovská stránka dokumentace](https://docs.northstar.example/): Aktuální uživatelská a administrátorská dokumentace.
- [API reference](https://docs.northstar.example/api/): Veřejné endpointy, schémata, autentizace, chyby a omezení rychlosti.
- [Poznámky k vydáním](https://docs.northstar.example/releases/): Datované změny chování produktu a API.

## Důvěryhodnost a podpora

- [Bezpečnost](https://www.northstar.example/security): Bezpečnostní program a aktuální dokumenty zajištění.
- [Zásady ochrany soukromí](https://www.northstar.example/privacy): Zpracování dat, uchovávání a práva uživatelů.
- [Podpora](https://www.northstar.example/support): Podporované kontaktní cesty a odkaz na stav služby.

## Schopnost agenta

- [Akce exportu reportu](https://docs.northstar.example/agents/export-report): Autentizovaný akční kontrakt, akceptované vstupy, výstupní formát, omezení rychlosti a zpracování chyb. Dostupnost závisí na plánu a roli uživatele.

## Volitelné

- [Výzkumná knihovna](https://www.northstar.example/research): Původní benchmarkové zprávy s metodami a daty publikace.

Ověřeno 2026-08-27 týmem Documentation Operations. Generováno z kanonického registru veřejných zdrojů; validujte po změnách produktu, plánu, zásad, API nebo URL.

Příklad deklaruje pouze jednu schopnost, protože existuje skutečný, zdokumentovaný kontrakt akce. Pokud produkt nemá podporovanou akci agenta, tuto sekci vynechejte. Nikdy neodvozujte transakční schopnost z přítomnosti vyhledávacího pole, formuláře nebo nedokumentovaného endpointu.

Pro manifest agenta uložený odděleně od /llms.txt dodržujte stejnou disciplínu. Specifikujte verzovaný formát, kanonický identifikátor, produkční endpoint, metodu autentizace, povolené operace, vstupní a výstupní schéma, omezení rychlosti, hranice souhlasu, chybové stavy a URL zásad. Validujte jej proti živému systému. Syntakticky platná deklarace, která inzeruje deaktivovanou akci, je stále chybná.

Galerie návrhů

Raw soubor má záměrně malý vizuální design. Varianty galerie by měly testovat informační architekturu, pořadí skenování, čitelnost na mobilu u lidsky čitelné implementační stránky a provozní důkazy — nikoli dekoraci.

Kontrolní seznam kvality

Publikujte pouze tehdy, když je každé použitelné tvrzení pravdivé:

• Soubor je dostupný na zamýšlené kořenové URL bez autentizace, přesměrovacích smyček, souhlasných stěn nebo vykresleného aplikačního shellu.
• Odpověď je čitelný plain text nebo Markdown, používá UTF-8 a není závislá na JavaScriptu pro odhalení svého obsahu.
• H1 uvádí kanonický název organizace nebo webu a popis uvádí účel, cílovou skupinu a rozsah bez sloganů.
• Každá odkazovaná URL je kanonická, veřejná, indexovatelná podle pravidel, dosažitelná a vlastněná organizací nebo jasně označená jako externí.
• Popisy odkazů říkají, jakou autoritu cíl drží; neopakují generický anchor text jako „dozvědět se více“.
• Primární zdroje produktu, cen, dokumentace, zásad a podpory souhlasí s indexem.
• Archivní stránky, výsledky vyhledávání, sledovací parametry, duplicitní lokality, kampaně a stránky s nízkou hodnotou tagů jsou vyloučeny.
• Tvrzení o schopnostech odpovídají živému, podporovanému, autentizovanému kontraktu a zahrnují relevantní omezení.
• Žádné tajemství, token, soukromý endpoint, osobní data, klientský dokument, nezveřejněný roadmap položka nebo bezpečnostně citlivý detail implementace se nevyskytuje.
• Jazyk přístupu, oprávnění, licencování a zásad odkazuje na řídicí zdroje a není v rozporu s indexem.
• Soubor netvrdí zaručené rankování, citace, vyloučení z trénování ani univerzální podporu spotřebitelů.
• Lokální a regionální rozsah je explicitní všude, kde se liší ceny, zásady, dostupnost nebo dokumentace.
• Vlastník, zdrojový registr, proces generování a metoda validace jsou zaznamenány mimo soubor nebo na jeho konci.
• Kontroly nefunkčních odkazů, neočekávaných přesměrování, stavu odpovědi, hash obsahu a požadovaných sekcí probíhají po relevantních nasazeních.
• Datum ověření se mění pouze po věcném zkontrolování cílů, popisů, schopností a zásad.

Časté chyby

Považování souboru za mapu webu. Kompletní inventář URL ničí prioritizaci a je obtížné ho kontrolovat. Používejte XML sitemapy pro objevování; kurátorsky vybírejte llms.txt podle autoritativních zdrojů a smysluplných skupin.

Považování souboru za řízení přístupu. Požadavek v Markdownu není vynucovací vrstva. Vyjádřete pravidla procházení v robots.txt, chraňte soukromé zdroje autentizací a umístěte závazné požadavky do relevantních zásad a systémových kontrol.

Kopírování cílového obsahu do indexu. Opakované ceny, specifikace produktů a zásady se rozcházejí. Shrňte jen tolik, aby byla identifikována autorita, pak odkazujte na udržovaný zdroj.

Publikování spekulativních schopností. Nedokumentovaný formulář nebo API cesta nedělá web připraveným pro agenty. Deklarujte pouze produkčně podporované akce s autentizací, schématy, omezeními, chybami a vlastníkem.

Zahrnutí všeho „pro jistotu.“ Více odkazů vytváří více nejednoznačnosti a více míst selhání. Volitelný obsah by si měl zasloužit zahrnutí tím, že odpovídá na pravděpodobnou potřebu vyhledávání, kterou primární sekce nepokrývají.

Vystavení soukromého materiálu. Veřejné strojově čitelné soubory jsou veřejné. Nikdy neuvádějte staging hostitele, interní API, přihlašovací údaje, exporty zákazníků, nezveřejněné dokumenty nebo bezpečnostní detaily, které nebyly záměrně schváleny k publikaci.

Generování bez řízení. Automatizace může rychle reprodukovat špatná zdrojová data. Generátor potřebuje schválený registr zdrojů, pravidla vyloučení, deterministické řazení, validaci, vlastnictví revize a výstrahy při nasazení.

Ruční úprava generovaného souboru. Další generování opravu přepíše. Opravte zdrojový záznam nebo generátor, regenerujte a zaznamenejte věcnou změnu.

Tvrzení o nepodporovaných výsledcích. „Toto zaručuje AI citace“ proměňuje nejistou implementační konvenci v zavádějící slib. Uvádějte důkazy o přístupnosti a vyhledávání odděleně od výsledků viditelnosti a citací.

Aktualizace data bez kontroly reality. Nový timestamp nemůže opravit mrtvou URL dokumentace, přejmenovaný plán nebo deaktivovanou akci. Ověření znamená porovnání každého důležitého tvrzení s jeho produkčním zdrojem.

Interní prolinkování

Odkazujte z lidsky čitelné implementační stránky nahoru na SEO typy příspěvků , když autor musí rozlišit strojový index od adresáře, dokumentační stránky nebo zásad. Odkazujte z každého provozního tvrzení na jeho řídicí zdroj: rozsah produktu na stránku produktu, aktuální ceny na ceny, chování na dokumentaci, oprávnění na řízení přístupu a povinnosti na zásady.

Raw soubor by měl používat kanonické absolutní URL, protože může být načten mimo běžnou navigaci webu. Preferujte jednu autoritativní destinaci na fakt. Pokud se dvě stránky překrývají, vyřešte vlastnictví před uvedením obou; index by měl odhalovat hierarchii zdrojů, ne uchovávat interní neshodu.

Používejte krátké, stabilní názvy sekcí jako Produkt, Dokumentace, Zásady a Schopnosti agenta. Udržujte jazykové varianty v jasně označených skupinách pouze tehdy, když se materiálně liší. Neodkazujte každý blogový příspěvek; vybírejte trvalý výzkum nebo návody pouze tehdy, když pomáhají systému porozumět tématu a důkazům webu.

Příchozí odkazy jsou také provozně důležité. Dokumentace, vývojářské portály a návody pro AI přístupnost by měly směřovat správce k implementačnímu záznamu, zatímco záznam odkazuje na živý soubor a validátor. To vytváří revizní cestu pro lidi, aniž by zahlcovalo strojový index.

Jak měřit výsledky

Měřte soubor nejprve jako infrastrukturu a poté jako vstup pro viditelnost. Zvýšení citací nelze přičíst llms.txt jen proto, že k obojímu došlo po publikaci.

Sledujte čtyři vrstvy:

• Dostupnost: stav odpovědi kořenové URL, chování přesměrování, typ obsahu, kódování, latence, nezávislost na vykreslování a doba provozu.
• Integrita: úspěšnost parsování, požadované sekce, duplicitní URL, nefunkční odkazy, cíle přesměrování, kanonické neshody, neautorizované domény, odhalená tajemství a změny hash obsahu.
• Aktuálnost: dny od věcného ověření, změny cílů od ověření, pokrytí zdrojového registru, potvrzení vlastníkem a čas na opravu odchylky.
• Výsledky: načtení ze serverových logů identifikovatelnými agenty (kde je to právně a technicky vhodné), návštěvy indexovaných cílů, AI citace preferovaných kanonických stránek a přesnost odpovědí na sledované otázky o značce nebo produktu.

Stanovte základní linii před nasazením: které URL jsou citovány, která fakta jsou chybně uvedena, zda kořenový soubor existuje a kteří crawleři jej vyžadují. Anotujte publikaci a každou materiální aktualizaci. Porovnávejte pozorovací okna dostatečně dlouhá, aby nedošlo k záměně jednoho načtení nebo citace za trend, a zachovejte rozdíl mezi korelací a kauzalitou.

Testujte režimy selhání přímo. Přejmenujte stagingovou kopii uvedené URL a potvrďte, že validátor zachytí chybu. Změňte kanonické mapování a potvrďte, že generátor aktualizuje index. Deaktivujte schopnost v kontrolovaném testovacím prostředí a potvrďte, že kontrola manifestu selže. Tyto testy dokazují systém údržby, nikoli externí adopci.

Použijte jak měříme výsledky k oddělení technické dostupnosti, strojové reprezentace, objevování, citace, zapojení a obchodních výsledků. V AmIcoted zkontrolujte živý soubor v sekci Agent Accessibility a použijte Cockpit report k pozorování citovaných URL a AI viditelnosti spolu s anotacemi nasazení. Důvěryhodným tvrzením o úspěchu je „soubor je platný, aktuální a směruje systémy k zamýšleným zdrojům“; jakákoli změna viditelnosti směrem dolů vyžaduje samostatný důkaz.

FAQ

Často kladené otázky