Chybí verze v Markdownu pro AI agenty
Na požadavek na stránku s Accept: text/markdown server poslal HTML a stránka neodkazuje na žádnou kopii v Markdownu. AI agenti pak čtou celé HTML včetně menu, patiček a skriptů. Verze v Markdownu je volitelná: jde o mladou konvenci, proto je to P3.
Co to znamená
Na požadavek s Accept: text/markdown stránka odpověděla HTML a neodkazuje na žádnou kopii v Markdownu (<link rel="alternate" type="text/markdown">). Agenti pak čtou celé HTML včetně menu a skriptů. Volitelné: Markdown pro agenty je mladá konvence, ne standard.
Proč na tom záleží pro AI vyhledávání
Agenti, kteří procházejí web za uživatele (a nástroje, které načítají stránky do kontextu modelu), pracují s textem, ne s rozvržením. Čistá verze stránky v Markdownu je několikrát menší než její HTML a zachovává nadpisy, seznamy a odkazy, na kterých záleží. Některá CDN a frameworky už na Accept: text/markdown takovou verzí odpovídají a llmstxt.org navrhuje kopii .md vedle každé stránky.
Bez ní se nic nerozbije: crawlery dál čtou HTML. Je to levné vylepšení, jakmile jsou opravena zjištění k přístupu, robots.txt a obsahu.
Jak to opravit
- Zvolte jeden způsob, jak Markdown podávat: odpovídejte na
Accept: text/markdownna vlastní URL stránky, nebo zveřejněte kopii, například/guide/index.md. - Pokud vaše CDN umí převod do Markdownu pro agenty, zapněte ho. Ve frameworku přidejte middleware, který vrátí verzi v Markdownu, když hlavička
Acceptžádátext/markdown. - Posílejte
Content-Type: text/markdown; charset=utf-8a pokud je URL stejná jako u stránky HTML, takéVary: Accept. - Odkažte na kopii z hlavičky HTML pomocí
<link rel="alternate" type="text/markdown">, aby ji našli i agenti, kteří formát nevyjednávají. - Na reportu stránky spusťte „Zkontrolovat znovu“ a ověřte výsledek.
Příklad
<!-- in <head>: where agents find the Markdown version -->
<link rel="alternate" type="text/markdown" href="/guide/index.md">
# the Markdown answer
Content-Type: text/markdown; charset=utf-8
Vary: Accept Jak ověřit opravu
Po změně klikněte ve zprávě na „Zkontrolovat znovu“: uvidíte, co bylo opraveno a jak se změnilo skóre.