Tiada versi Markdown untuk ejen AI

Jawapan ringkas

Apabila halaman diminta dengan Accept: text/markdown, pelayan menghantar HTML, dan halaman tidak memautkan salinan Markdown. Ejen AI kemudian membaca seluruh HTML, termasuk menu, pengaki dan skrip. Menyediakan versi Markdown adalah pilihan: ia konvensi yang masih baharu, jadi ini P3.

agent.no_markdown · Keutamaan: P3

Maksudnya

Apabila diminta dengan Accept: text/markdown, halaman menjawab dengan HTML dan tidak memautkan salinan Markdown (<link rel="alternate" type="text/markdown">). Ejen kemudian membaca seluruh HTML, termasuk menu dan skrip. Pilihan: Markdown untuk ejen ialah konvensi yang masih baharu, bukan standard.

Mengapa ini penting untuk carian AI

Ejen yang melayari web untuk pengguna (dan alat yang memuatkan halaman ke dalam konteks model) bekerja dengan teks, bukan susun atur. Versi Markdown yang bersih bagi sesuatu halaman beberapa kali lebih kecil daripada HTMLnya dan mengekalkan tajuk, senarai dan pautan yang penting. Sesetengah CDN dan rangka kerja sudah menjawab Accept: text/markdown dengan versi sedemikian, dan llmstxt.org mencadangkan salinan .md di sebelah setiap halaman.

Tiada apa yang rosak tanpanya: perangkak masih membaca HTML. Ia penambahbaikan yang murah setelah penemuan akses, robots.txt dan kandungan dibetulkan.

Cara membetulkannya

  1. Pilih satu cara untuk menyediakan Markdown: jawab Accept: text/markdown pada URL halaman itu sendiri, atau terbitkan salinan seperti /guide/index.md.
  2. Pada CDN, hidupkan penukaran Markdown untuk ejen jika ada. Dalam rangka kerja, tambah middleware yang mengembalikan versi Markdown apabila pengepala Accept meminta text/markdown.
  3. Hantar Content-Type: text/markdown; charset=utf-8 dan, apabila URL sama dengan halaman HTML, Vary: Accept.
  4. Pautkan salinan itu dari head HTML dengan <link rel="alternate" type="text/markdown">, supaya ejen yang tidak berunding kandungan juga dapat menemuinya.
  5. Jalankan "Semak semula" pada laporan halaman untuk mengesahkan hasilnya.

Contoh

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

Cara mengesahkan pembetulan

Selepas perubahan, tekan "Semak semula" pada laporan: ia menyenaraikan apa yang dibetulkan dan bagaimana skor berubah.

Semak halaman saya →

Panduan berkaitan

Semua penemuan dan cara skor dikira