Ni različice v Markdownu za agente UI
Na zahtevo za stran z Accept: text/markdown je strežnik poslal HTML, stran pa ne povezuje na kopijo v Markdownu. Agenti UI zato berejo ves HTML, skupaj z meniji, nogami in skriptami. Različica v Markdownu je neobvezna: gre za mlado konvencijo, zato je to P3.
Kaj pomeni
Na zahtevo z Accept: text/markdown je stran odgovorila s HTML in ne povezuje na kopijo v Markdownu (<link rel="alternate" type="text/markdown">). Agenti zato berejo ves HTML, skupaj z meniji in skriptami. Neobvezno: Markdown za agente je mlada konvencija, ne standard.
Zakaj je to pomembno za iskanje z UI
Agenti, ki brskajo namesto uporabnika (in orodja, ki nalagajo strani v kontekst modela), delajo z besedilom, ne s postavitvijo. Čista različica strani v Markdownu je nekajkrat manjša od njenega HTML in ohrani naslove, sezname in povezave, ki štejejo. Nekateri CDN-ji in ogrodja že odgovarjajo na Accept: text/markdown s tako različico, llmstxt.org pa predlaga kopijo .md ob vsaki strani.
Brez nje se nič ne pokvari: pajki še vedno berejo HTML. To je poceni izboljšava, ko so ugotovitve o dostopu, robots.txt in vsebini že odpravljene.
Kako to popraviti
- Izberite en način streženja Markdowna: odgovarjajte na
Accept: text/markdownna URL-ju same strani ali objavite kopijo, na primer/guide/index.md. - Če ima vaš CDN pretvorbo v Markdown za agente, jo vklopite. V ogrodju dodajte vmesno programsko opremo (middleware), ki vrne različico v Markdownu, ko glava
Acceptzahtevatext/markdown. - Pošiljajte
Content-Type: text/markdown; charset=utf-8in, kadar je URL enak kot pri strani HTML, tudiVary: Accept. - Kopijo povežite iz glave HTML z
<link rel="alternate" type="text/markdown">, da jo najdejo tudi agenti, ki se o formatu ne pogajajo. - V poročilu strani zaženite „Preveri znova“, da potrdite rezultat.
Primer
<!-- 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 Kako potrditi popravek
Po spremembi v poročilu pritisnite »Preveri znova«: pokaže, kaj je odpravljeno in kako se je spremenila ocena.