Chýba verzia v Markdowne pre AI agentov
Na požiadavku na stránku s Accept: text/markdown server poslal HTML a stránka neodkazuje na žiadnu kópiu v Markdowne. AI agenti potom čítajú celé HTML vrátane menu, pätičiek a skriptov. Verzia v Markdowne je nepovinná: ide o mladú konvenciu, preto je to P3.
Čo to znamená
Na požiadavku s Accept: text/markdown stránka odpovedala HTML a neodkazuje na žiadnu kópiu v Markdowne (<link rel="alternate" type="text/markdown">). Agenti potom čítajú celé HTML vrátane menu a skriptov. Nepovinné: Markdown pre agentov je mladá konvencia, nie štandard.
Prečo je to dôležité pre AI vyhľadávanie
Agenti, ktorí prechádzajú web za používateľa (a nástroje, ktoré načítavajú stránky do kontextu modelu), pracujú s textom, nie s rozložením. Čistá verzia stránky v Markdowne je niekoľkokrát menšia ako jej HTML a zachováva nadpisy, zoznamy a odkazy, na ktorých záleží. Niektoré CDN a frameworky už na Accept: text/markdown odpovedajú takouto verziou a llmstxt.org navrhuje kópiu .md vedľa každej stránky.
Bez nej sa nič nepokazí: crawlery ďalej čítajú HTML. Je to lacné vylepšenie, keď sú zistenia k prístupu, robots.txt a obsahu už opravené.
Ako to opraviť
- Vyberte jeden spôsob, ako Markdown servírovať: odpovedajte na
Accept: text/markdownna vlastnej URL stránky alebo zverejnite kópiu, napríklad/guide/index.md. - Ak vaše CDN vie prevod do Markdownu pre agentov, zapnite ho. Vo frameworku pridajte middleware, ktorý vráti verziu v Markdowne, keď hlavička
Acceptžiadatext/markdown. - Posielajte
Content-Type: text/markdown; charset=utf-8a ak je URL rovnaká ako pri stránke HTML, ajVary: Accept. - Odkážte na kópiu z hlavičky HTML pomocou
<link rel="alternate" type="text/markdown">, aby ju našli aj agenti, ktorí formát nevyjednávajú. - V správe o stránke spustite „Skontrolovať znova“ a overte výsledok.
Prí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 Ako overiť opravu
Po zmene stlačte v správe „Skontrolovať znova“: uvedie, čo sa opravilo a ako sa zmenilo skóre.