لا توجد نسخة Markdown لوكلاء الذكاء الاصطناعي

إجابة موجزة

عند طلب الصفحة مع Accept: text/markdown أرسل الخادم HTML، والصفحة لا تربط بأي نسخة Markdown. فيقرأ وكلاء الذكاء الاصطناعي HTML كاملًا بما فيه القوائم والتذييلات والسكربتات. تقديم نسخة Markdown اختياري: إنه عُرف حديث، لذا أولوية هذا P3.

agent.no_markdown · الأولوية: P3

ماذا يعني

عند الطلب مع Accept: text/markdown أعادت الصفحة HTML، ولا تربط بأي نسخة Markdown (<link rel="alternate" type="text/markdown">). فيقرأ الوكلاء HTML كاملًا بما فيه القوائم والسكربتات. اختياري: تقديم Markdown للوكلاء عُرف حديث وليس معيارًا.

لماذا يهم ذلك في البحث بالذكاء الاصطناعي

الوكلاء الذين يتصفحون نيابةً عن المستخدم (والأدوات التي تحمّل الصفحات في سياق النموذج) يتعاملون مع النص لا مع التنسيق. نسخة Markdown نظيفة من الصفحة أصغر من HTML بعدة مرات، وتحتفظ بالعناوين والقوائم والروابط المهمة. بعض شبكات CDN وأطر العمل تجيب أصلًا على Accept: text/markdown بنسخة كهذه، ويقترح llmstxt.org نسخة .md بجانب كل صفحة.

لا يتعطّل شيء من دونها: لا تزال الزواحف تقرأ HTML. إنها تحسين قليل الكلفة بعد إصلاح الملاحظات المتعلقة بالوصول وrobots.txt والمحتوى.

كيف تصلحه

  1. اختر طريقة واحدة لتقديم Markdown: أجب على Accept: text/markdown على عنوان الصفحة نفسه، أو انشر نسخة مثل /guide/index.md.
  2. إن كنت تستخدم CDN فشغّل تحويل Markdown للوكلاء إن كان متاحًا. وفي إطار العمل أضِف middleware يعيد نسخة Markdown حين تطلب ترويسة Accept القيمة text/markdown.
  3. أرسل Content-Type: text/markdown; charset=utf-8، وأرسل أيضًا Vary: Accept حين يكون العنوان هو نفسه عنوان صفحة HTML.
  4. اربط النسخة من رأس HTML عبر <link rel="alternate" type="text/markdown">، كي يجدها أيضًا الوكلاء الذين لا يتفاوضون على الصيغة.
  5. شغّل «افحص مجددًا» في تقرير الصفحة للتأكد من النتيجة.

مثال

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

كيف تتأكد من الإصلاح

بعد التغيير، اضغط «افحص مجددًا» في التقرير: سيعرض ما تم إصلاحه وكيف تغيّرت الدرجة.

افحص صفحتي ←

أدلة ذات صلة

كل الملاحظات وكيف تُحسب الدرجة