Agenteille tarkoitettu Markdown-versio on rikki

Lyhyt vastaus

Sivu tarjoaa agenteille Markdown-version, joko vastauksena otsakkeeseen Accept: text/markdown tai elementillä <link rel="alternate" type="text/markdown">, mutta versio palauttaa virheen, tyhjän rungon tai HTML-sivun. Sitä pyytävät agentit eivät saa mitään käyttökelpoista.

agent.markdown_broken · Prioriteetti: P2

Mitä se tarkoittaa

Sivu tarjoaa agenteille Markdownia (vastauksena otsakkeeseen Accept: text/markdown tai linkitettynä kopiona), mutta takaisin tulee virhe, tyhjä runko tai HTML-sivu.

Miksi tämä on tärkeää tekoälyhaussa

Agentti, joka näkee Markdown-linkin tai saa text/markdown-vastauksen, luottaa siihen eikä välttämättä palaa HTML:ään. Rikkinäinen kopio on huonompi kuin ei kopiota lainkaan: agentti epäonnistuu tai lukee virhesivun sisältönäsi.

Tämä tapahtuu yleensä siirron tai uudelleenrakentamisen jälkeen: .md-tiedostoja ei julkaistu, uudelleenkirjoitussääntö osoittaa vanhaan polkuun tai middleware merkitsee HTML:n muotoon text/markdown.

Näin korjaat

  1. Avaa todisteissa oleva URL ja katso tilakoodi, Content-Type ja runko.
  2. Jos kopio on kadonnut, julkaise se uudelleen tai poista siihen osoittavat <link rel="alternate" type="text/markdown"> -tagi ja Link-otsake.
  3. Jos vastaus on HTML:ää tai tyhjä, korjaa muunnos niin, että se palauttaa sivun tekstin Markdownina otsakkeella Content-Type: text/markdown.
  4. Vahvista tulos painamalla sivuraportissa ”Tarkista uudelleen”.

Esimerkki

curl -sS -H 'Accept: text/markdown' -D - -o /dev/null https://example.com/guide/
# expect: HTTP/2 200, content-type: text/markdown; charset=utf-8, vary: Accept

Miten korjauksen voi varmistaa

Paina muutoksen jälkeen raportissa "Tarkista uudelleen": se näyttää, mitä korjattiin ja miten pistemäärä muuttui.

Tarkista sivuni →

Aiheeseen liittyvät oppaat

Kaikki havainnot ja miten pistemäärä lasketaan