دليل llms.txt: متى تستخدمه وكيف تصونه

CH.01

ما هو llms.txt — ووضعه الحالي بكل صراحة

llms.txt ملخص Markdown منتقى للوكلاء الذين يستخدمونه. يسمح المقترح الحالي بوضعه في جذر الموقع أو مسار فرعي مثل /docs/llms.txt ليغطي محتوى ذلك المسار. يبقى مقترحًا مجتمعيًا؛ والتبنّي والسلوك يعتمدان على الوكيل.

نشر Jeremy Howard المقترح في llmstxt.org في سبتمبر 2024، وحدّثه إلى v2 في 10 أغسطس 2026. يقدّم سياقًا موجزًا وروابط منتقاة للتفاصيل التي تُجلب عند الحاجة. يمكن لملف الجذر وصف الموقع كله، ولملف المسار الفرعي وصف قسمه.

أمثلة تبني مواقع التوثيق لا تثبت استعمال الوكيل. Google يقول إن Search يتجاهل llms.txt بلا أثر إيجابي أو سلبي في الظهور أو الترتيب. هذا لا يصف جميع المزودين.

• →قد يوفّر llms.txt سياقًا وروابط منتقاة للوكلاء المشاركين؛ لكنه لا يثبت تحسن الترتيب أو الاستشهاد
• →يمكن للوكيل استخدام llms.txt إذا دعمه سير عمله أو تسلّم الملف صراحةً؛ لا توجد محطة أولى إلزامية لجميع الوكلاء
• →geo.tenten.co/llms.txt و/pricing.md روابط مرجعية للفحص. المحتوى يتغير؛ لا نثبت هنا عدد أسطر أو خطط حاليًا أو تبني جميع الوكلاء.

CH.02

صياغة المقترح ومثال قابل للنسخ

Markdown مع H1 وملخص وسياق اختياريين وأقسام وروابط مختارة. هذه أعراف لمسارات مشاركة، لا ضمان فهم كل نموذج.

قالب أدنى جاهز للنسخ المباشر

• →# شركة Acme
• →> Acme مزوّد حلول أتمتة مستودعات B2B، يقدّم خدمات تطبيق أنظمة WMS والاستشارات لمصانع يتراوح حجمها بين 50 و500 موظف، ومن عملائه…（جملة إلى ثلاث جمل، واقعية وقابلة للتحقّق）
• →## الخدمات — ثم كل سطر: - [خدمة تطبيق WMS](https://acme.example/services/wms): عملية تطبيق خلال 30 يومًا، ونطاق التسعير، والمخرجات
• →## التوثيق — - [توثيق API](https://acme.example/docs/api): مرجع REST API الكامل، شاملًا التحقّق ورموز الأخطاء
• →## التواصل — - [احجز استشارة](https://acme.example/contact): تقييم مجاني مدته 30 دقيقة
• →## Optional — ضع هنا فهرس المدوّنة والتغطية الإعلامية وسائر الروابط الثانوية

صف حقائق الصفحة واختر الروابط للمستفيد. لا حد عام من 10–30 رابطًا. geo.tenten.co/llms.txt لا يثبت أربعة أقسام حاليًا أو أقل من 40 سطرًا؛ افحص الاستجابة الفعلية.

CH.03

llms.txt و robots.txt و sitemap.xml: ثلاثة ملفات، وثلاث وظائف

ينقل robots.txt تعليمات الزحف إلى الوكلاء الذين يحترمونه؛ ويسرد sitemap.xml عناوين URL للاكتشاف؛ ويقترح llms.txt ملخصًا منتقى للوكلاء الذين يستخدمونه. لا يفرض أي منها تحكمًا في الوصول، ولا يستبدل llms.txt أهلية Search المعتادة.

في تدقيق مدته 30 يومًا، افحص أولًا الوصول المقصود لزواحف البحث والجلب بطلب المستخدم، ثم اكتشاف الصفحات المعتاد وأخيرًا llms.txt الاختياري. لا يمنع حظر GPTBot أو ClaudeBot للتدريب OAI-SearchBot أو Claude-SearchBot بحد ذاته. افحص مجموعة robots وقاعدة CDN المطبّقتين لكل وكيل.

CH.04

الأساليب المتقدمة: llms-full.txt وصفحات .md المرآة

إن احتاج مسار العمل Markdown، فكر في تصدير موحد أو مرايا .md. Google Search لا يطلبها. HTML ليس غير قابل للقراءة بذاته؛ اختر حسب النظام المستهلك.

llms-full.txt: ملف واحد يحتوي المحتوى كاملًا

llms-full.txt قد يجمع محتوى مختارًا لأداة. الحجم والسياق والخصوصية والتحديث تتبع النطاق. قرر وفق احتياج موثق ومصدر متزامن؛ لا عائد أعلى مثبت هنا.

صفحات .md المرآة: أضف .md بعد العنوان الأصلي

مرآة .md تقدم محتوى مختارًا. قارن استجابة /pricing.md بالأسعار والشروط والعملة الحالية في HTML. صيغة اختيارية، لا إثبات قراءة جميع الوكلاء لها.

• →اختر بالحاجة الفعلية كالمواصفات أو الأسعار، دون افتراض أكثر صفحات كل ذكاء اصطناعي طلبًا.
• →اربط المرايا المصانة بوصف صحيح؛ الرابط لا يثبت استخدامًا تلقائيًا.
• →أبق التواريخ والأسعار والشروط دقيقة بين الصيغ. نسخة قديمة قد تضلل؛ التاريخ وحده لا يثبت الحداثة.
• →انضباط الصيانة: عند تعديل صفحة HTML تُحدَّث نسخة .md بالتزامن، فضعها في قائمة تحقّق الإصدار نفسها، ولا تعتمد على الذاكرة

CH.05

ستة فحوص للنشر

استخدم الفحوص الستة لمراجعة الأوصاف والتحديثات واختيار الروابط والنص المعروض ووصول الزواحف وصيغة الاستجابة. هي فحوص عملية، وليست تقديرًا منشورًا لتكرار الأخطاء في مواقع العملاء.

• →فحص 1 · الأوصاف: معلومات محددة عن الصفحة، لا شعارات فقط.
• →فحص 2 · التحديث: راجع الأسماء والروابط والحقائق عند النشر. المراجعة الفصلية تذكير Tenten، لا جهد عام مقاس.
• →فحص 3 · الانتقاء: روابط مفيدة للنطاق والمستخدم، بلا حد عام أو ادعاء أن القائمة الطويلة عديمة القيمة.
• →فحص 4 · العرض: افحص HTML وعرض النظام المقصود. Google ينفذ JavaScript والآخرون يختلفون. اختر الخادم أو المرآة لحاجة محددة.
• →الفحص 5 · وصول الوكيل: قارن OAI-SearchBot وClaude-SearchBot وPerplexityBot مع robots.txt وقواعد WAF والسجلات المتحقق منها. رفض تدريب GPTBot أو ClaudeBot عمدًا لا يعني فشل llms.txt. طبّق استثناءات الجلب بطلب المستخدم بصورة منفصلة.
• →فحص 6 · الاستجابة: تحقق من الحالة وContent-Type نصي مناسب وجسم Markdown. خطأ200 أو الرؤوس وحدها قد يخفي خللًا؛ لا MIME موحدًا إلزاميًا.

CH.06

خطوات التطبيق الأربع وقائمة التحقّق

إن قررت النشر، اتبع أربع خطوات: كتابة ونشر وتحقق وصيانة. قدّر حسب الموقع، بلا وعد بإكمال في عصر واحد أو دقائق ثابتة.

• →curl -sI https://yourdomain/llms.txt يفحص الرؤوس. اجلب الجسم واستجابات الروابط أيضًا.
• →خطأ التلخيص سؤال للتحقيق. إعطاء الملف لـChatGPT أو Claude لا يثبت اكتشافًا أو أولوية مستقلة.
• →راجع وصول OAI-SearchBot وClaude-SearchBot وPerplexityBot منفصلًا عن ضوابط تدريب/grounding الخاصة بـ GPTBot وClaudeBot وGoogle-Extended. تحقّق من استثناءات طلبات المستخدم؛ لا يتطلب llms.txt قبولًا شاملًا للتدريب.