ما الذي يجعل llms.txt جيداً؟

يفعل ملف llms.txt المكتوب جيداً شيئاً واحداً: يمنح نظام ذكاء اصطناعي اختصاراً موثوقاً ومنسّقاً إلى أهم صفحات موقعك. وعندما يقرأ وكيل أو مسار RAG الملف، ينبغي أن يعرف فوراً موضوع موقعك والصفحات التي يحمّلها للسياق وترتيب أهميتها.

لا يقدم الملف سيئ الكتابة، المليء بالنص التسويقي أو بعناوين URL النسبية أو بكل صفحات الموقع، أي ميزة على زحف sitemap.xml. وقيمة llms.txt تأتي من الانتقاء والوضوح.

ما ينبغي فعله

استخدم عناوين URL مطلقة

يجب أن يستخدم كل رابط في llms.txt عنوان URL مطلقاً كاملاً. لا تعمل المسارات النسبية لأن الملف قد يجلبه عميل لا يعرف نطاقك مسبقاً.

# Correct
- [API reference](https://example.com/docs/api/): complete endpoint documentation.

# Incorrect, relative URL
- [API reference](/docs/api/): complete endpoint documentation.

اكتب اقتباساً واقعياً

الاقتباس الاختياري (لكن الموصى به بشدة) مباشرة بعد عنوان H1 هو أول ما يقرأه نظام الذكاء الاصطناعي. استخدمه لتعريف موقعك أو منتجك في جملة إلى ثلاث جمل عادية. فكّر فيه بوصفه وصفاً مقروءاً آلياً لا عرضاً ترويجياً.

# Acme

> Acme is an open-source inventory management platform for small manufacturers.
> It provides real-time stock tracking, supplier integration, and demand forecasting.
> Documentation covers setup, configuration, and the REST API.

ضمّن أهم صفحاتك وعددها 5 إلى 15

التنقيح هو الغاية الأساسية. بالنسبة إلى معظم المواقع، النقطة المثلى هي 5 إلى 15 رابطاً. إذا كان موقع التوثيق صغيراً، فعدد أقل من الروابط مناسب. وإذا كانت لديك منصة كبيرة ذات مجالات منتجات متعددة ومتميزة، يمكنك رفع العدد، لكن ما يتجاوز 30 رابطاً يبدأ بتخفيف الإشارة.

أعط الأولوية للبدء السريع والمفاهيم الأساسية ومرجع API والمصادقة وأي صفحات تجيب عن الأسئلة التي يطرحها المستخدمون غالباً على المساعدات الذكية حول منتجك.

أبقِ الملف ضمن حجم معقول

لا تفرض المواصفة الحد الأقصى لحجم الملف، لكن الحدود العملية مهمة. ويمكن جلب ملف يقل كثيراً عن 100 KB وتحليله بكفاءة. وإذا نما llms.txt لديك كثيراً، ففكّر فيما إذا كان بعض المحتوى ينتمي إلى llms-full.txt بدلاً من ذلك.

ضمّن توثيق API إن كان متاحاً

إذا كان لمنتجك API، فمن شبه المؤكد أن مرجع API هو أهم ما ينبغي ربطه. كثيراً ما يطلب المطورون المساعدة من المساعدين الذكاء الاصطناعي في استدعاءات API، وتُعد نقطة نهاية أو معلمة مختلقة أكثر أنواع أخطاء الذكاء الاصطناعي إزعاجاً. الإشارة إلى مرجع API الأساسي تقلل هذا الخطر.

حافظ على قابليته للقراءة آلياً

تستخدم المواصفة صياغة روابط Markdown القياسية: - [Link text](URL): description. لا تضف HTML أو مقدمة front matter أو تنسيقاً غير قياسي. أبقِ البنية واضحة حتى يتمكن أي محلل Markdown من معالجتها بصورة صحيحة.

ما لا ينبغي فعله

لا تُدرج صفحات محمية بالمصادقة

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

لا تضع نصاً تسويقياً في الاقتباس

يقرأ الذكاء الاصطناعي الاقتباس لسياق واقعي، لا للإقناع البشري. واللغة التسويقية («الحل الرائد في الصناعة لـ...») لا تساعد الذكاء الاصطناعي على فهم منتجك. أما اللغة الواقعية المحددة فتساعد.

لا تستخدم عناوين URL نسبية

عناوين URL نسبية مثل /docs/api/ ليست صالحة في llms.txt. استخدم دائماً عناوين URL مطلقة كاملة تتضمن البروتوكول والنطاق.

لا تربط بكل صفحة في الموقع

llms.txt ليس خريطة موقع. فالملف الذي يضم مئات الروابط لا يقدّم تقريباً أي إشارة إلى التنظيم. وإذا احتاج عميل ذكاء اصطناعي إلى اكتشاف جميع صفحاتك، فلديه sitemap.xml لذلك. ينبغي أن يجيب llms.txt عن السؤال: «إذا لم يكن بوسعك قراءة سوى 10 صفحات لفهم هذا الموقع، فأيّ 10 صفحات تختار؟»

لا تنشر وتنسَ

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

لا تُدرج عناوين URL للتجهيز أو إعادة التوجيه

اربط بعناوين URL الأساسية في الإنتاج فقط. فقد تكون عناوين بيئة الاختبار محمية بكلمة مرور، وتضيف سلاسل إعادة التوجيه زمن وصول، وتربك العناوين غير الأساسية أنظمة الاسترجاع التي تتعقب عناوين URL بصفتها معرّفات.

تسمية الأقسام وبنيتها

تعرّف المواصفة الأقسام بأنها عناوين Markdown من المستوى H2 (##) وتحتوي على قوائم روابط. لا توجد أسماء موحّدة للأقسام؛ اختر أسماء تعكس تنظيم محتواك. ومن الأنماط الشائعة:

التوثيق أو الوثائق, لمواقع التوثيق.
مرجع API, للمنتجات التي تملك API عاماً.
البدء، للمنتجات التي تركز على الإعداد.
الأدلة, للمحتوى بأسلوب البرامج التعليمية.
المدونةللمحتوى التحريري (وسمه اختيارياً إذا كان ثانوياً).
اختياري, القسم الذي تحدده المواصفة للروابط ذات الأولوية الأقل التي قد يختار العميل تخطيها.

اختر أسماء أقسام تعكس تنظيم محتواك، لا كلمات SEO. ويفهم عميل الذكاء الاصطناعي الذي يقرأ الملف اللغة الطبيعية، فاستخدم الأسماء التي توضح البنية.

كتابة أوصاف روابط جيدة

يمكن أن يحتوي كل رابط في llms.txt على وصف اختياري يفصله عن عنوان URL نقطتان:

- [Page title](https://example.com/page/): what this page contains.

الأوصاف الجيدة قصيرة (أقل من 20 كلمة) وواقعية ومحددة بشأن ما تغطيه الصفحة. تعامل معها كملخصات مصغرة لا عبارات ترويجية.

جيد: «مرجع كامل لجميع نقاط REST API، بما فيها المصادقة وحدود المعدل ورموز الأخطاء.»
سيئ: «توثيق API عالمي المستوى سيساعدك على بناء تكاملات مذهلة بسرعة.»
جيد: «دليل بدء سريع خطوة بخطوة للمستخدمين الجدد، من إنشاء الحساب حتى أول استدعاء API.»
سيئ: «ابدأ اليوم واختبر قوة Acme.»

القسم الاختياري

## Optional هو وسم تحريري، وليس تعليمة معالجة خاصة في الإصدار V2. استخدمه عندما تجعل مجموعة منفصلة من الموارد الثانوية فهمها أسهل للأشخاص والعملاء المتوافقين. ومن الأمثلة المناسبة:

مقالات المدونة والمحتوى التحريري الذي يقدم سياقاً لكنه ليس ضرورياً تقنياً.
صفحات سجل التغييرات أو ملاحظات الإصدار.
الإصدارات بلغات إضافية من صفحاتك الأساسية.
صفحات FAQ والمسرد مفيدة، لكنها ليست المادة المرجعية الأساسية.

لا تفترض أن العميل سيتخطى هذا القسم أو يخفض أولويته أو يعامله بطريقة مختلفة. وإذا كانت الأولوية مهمة لسير العمل، فوثّق ذلك السلوك في العميل بدلاً من استنتاجه من العنوان.

إبقاؤه محدثاً

عادة صيانة بسيطة: في كل مرة تنشر أو تقاعد صفحة مهمة، تحقّق مما إذا كان ينبغي تحديث llms.txt. وبالنسبة إلى المواقع الأكبر، فكّر في:

إنشاء llms.txt تلقائياً من بنية التنقل أو CMS وقت البناء.
أضف مراجعة llms.txt إلى قائمة فحص نشر المحتوى لديك.
التشغيل الدوري لـ المدقّق لاكتشاف الروابط المعطلة.

إذا كان موقعك يتغير نادراً، فعادةً تكفي مراجعة llms.txt كل ثلاثة أشهر. وإذا كنت تنشر بكثرة، فاربطه بمسار النشر لديك.

واصل القراءة

أفضل الممارسات (دليل كامل)، عشر قواعد لملف مفيد ومتوافق مع المواصفة.
مرجع التنسيق، المواصفة الكاملة مع أمثلة الصياغة.
المولّد، أنشئ ملفاً صالحاً من نموذج خلال دقائق.
أمثلة حقيقية، وتعرّف إلى طريقة بناء Anthropic وCloudflare وStripe لملفاتها.

أفضل ممارسات `llms.txt`: اكتب ملفاً واضحاً يسهل تحديثه