Markdown pro AI agenty
Když AI nástroj potřebuje manuál jen číst, nemusíte ho připojovat přes konektor. Stačí Markdown podoba stránek, rozcestník llms.txt nebo ZIP s celým obsahem, který stáhnete v panelu.
Tři cesty a kdy kterou použít
| Cesta | Pro koho | Aktuálnost | Zamčený obsah |
|---|---|---|---|
| AI konektor | agent, který čte i upravuje | živý | po přihlášení ano |
Markdown na adrese stránky a llms.txt | nástroje a crawlery, které čtou web | živý | ne |
| Export pro AI agenty (ZIP) | nástroje bez připojení k webu, předání partnerovi | snímek z okamžiku exportu | jen kompletní AI export |
Stránka jako Markdown
Každá zveřejněná veřejná stránka vrátí na své běžné adrese místo HTML čistý Markdown, když o něj nástroj požádá hlavičkou Accept: text/markdown. Zvláštní adresa s koncovkou .md neexistuje. Vyzkoušet si to můžete v terminálu:
curl -H "Accept: text/markdown" https://vaseznacka.visualbook.pro/logo
Odpověď obsahuje hlavní obsah stránky bez navigace a patičky. Hlavička x-markdown-tokens uvádí odhadovaný počet tokenů, aby nástroj věděl, kolik místa text zabere. Prohlížeč si vždy řekne o HTML, takže v něm Markdown neuvidíte.
Rozcestník llms.txt
Na adrese https://vaseznacka.visualbook.pro/llms.txt najdou AI nástroje textový rozcestník v hlavním jazyce manuálu. Druhý jazyk má vlastní, například …/en/llms.txt. Rozcestník obsahuje:
- název a popis značky,
- seznam veřejných stránek s odkazy,
- jazykové verze, odkaz na mapu webu a na vyhledávání, pokud je zapnuté,
- adresy AI konektoru – veřejného i s přihlášením, podle toho, který je zapnutý,
- pravidla použití: veřejný obsah lze číst a citovat s uvedením zdroje, zamčený obsah se z webu stahovat nesmí.
Stránky vyřazené z indexace ani zamčené stránky v seznamu nejsou. Když je zamčený celý manuál, llms.txt neexistuje. Rozcestník se obnovuje průběžně – smazaná nebo skrytá stránka z něj zmizí hned, jiná změna z panelu se v něm může projevit s až hodinovým zpožděním.
Export pro AI agenty
Celý obsah manuálu stáhnete jako ZIP připravený pro AI nástroje – třeba pro projekt v Claude, vlastní GPT nebo Figma AI. Postup:
- V panelu otevřete Nastavení → Exporty a najděte část Export pro AI agenty.
- U manuálu s více značkami nejdřív vyberte Značku.
- Klikněte na Generovat veřejný AI export nebo Generovat kompletní AI export.
- Po dokončení stáhněte ZIP tlačítkem Stáhnout u řádku s vygenerovaným exportem.
ZIP obsahuje:
- soubor
nazev-znacky-brand.mds textem manuálu, - strukturovaný
manifest.json, - složku
assets/se soubory ke stažení – logy, písmy a dokumenty.
Export pojme nejvýš 500 souborů a 200 MB a ZIP je ke stažení 24 hodin. Písma z Adobe Fonts v něm nejsou, jen název rodiny a řezu.
| Veřejný AI export | Kompletní AI export | |
|---|---|---|
| Zamčené stránky | vynechá i s podstránkami | obsahuje |
| Soubory | jen z veřejných stránek | všechny, i z chráněných stránek |
| Komu ho dát | externím partnerům a jejich nástrojům | jen důvěryhodným příjemcům |