Yapay zekâ ajanları için Markdown sürümü yok

Kısa yanıt

Sayfa Accept: text/markdown ile istendiğinde sunucu HTML gönderdi ve sayfa hiçbir Markdown kopyasına bağlantı vermiyor. Yapay zekâ ajanları bu durumda menüler, alt bilgiler ve betikler dahil tüm HTML'i okur. Markdown sürümü sunmak isteğe bağlıdır: yeni bir alışkanlıktır, bu yüzden bu bulgu P3'tür.

agent.no_markdown · Öncelik: P3

Ne anlama gelir

Accept: text/markdown ile istendiğinde sayfa HTML döndürdü ve hiçbir Markdown kopyasına bağlantı vermiyor (<link rel="alternate" type="text/markdown">). Ajanlar bu durumda menüler ve betikler dahil tüm HTML'i okur. İsteğe bağlı: ajanlar için Markdown yeni bir alışkanlık, bir standart değil.

Yapay zekâ araması için neden önemli

Bir kullanıcı adına gezinen ajanlar (ve sayfaları bir modelin bağlamına yükleyen araçlar) düzenle değil metinle çalışır. Bir sayfanın temiz bir Markdown sürümü HTML'inden birkaç kat küçüktür ve önemli başlıkları, listeleri ve bağlantıları korur. Bazı CDN'ler ve çatılar Accept: text/markdown isteğine zaten böyle bir sürümle yanıt verir; llmstxt.org da her sayfanın yanında bir .md kopyası önerir.

Bu olmadan hiçbir şey bozulmaz: tarayıcılar HTML'i okumaya devam eder. Erişim, robots.txt ve içerik bulguları düzeltildikten sonra ucuz bir iyileştirmedir.

Nasıl düzeltilir

  1. Markdown sunmak için tek bir yol seçin: sayfanın kendi URL'sinde Accept: text/markdown isteğine yanıt verin ya da /guide/index.md gibi bir kopya yayımlayın.
  2. CDN kullanıyorsanız, varsa ajanlar için Markdown dönüştürmesini açın. Bir çatıda, Accept üst bilgisi text/markdown istediğinde Markdown sürümünü döndüren bir middleware ekleyin.
  3. Content-Type: text/markdown; charset=utf-8 gönderin; URL, HTML sayfasınınkiyle aynıysa Vary: Accept da gönderin.
  4. İçerik anlaşması yapmayan ajanlar da bulabilsin diye kopyaya HTML head bölümünden <link rel="alternate" type="text/markdown"> ile bağlantı verin.
  5. Sonucu doğrulamak için sayfa raporunda "Yeniden denetle"yi çalıştırın.

Örnek

<!-- 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

Çözüm nasıl doğrulanır

Değişiklikten sonra raporda "Yeniden denetle" düğmesine basın: neyin düzeltildiğini ve puanın nasıl değiştiğini listeler.

Sayfamı denetle →

İlgili rehberler

Tüm bulgular ve puanın nasıl hesaplandığı