llms.txt لمواقع التوثيق
نُشر:
مواقع التوثيق هي حالة الاستخدام المثالية لـ llms.txt: يسأل الناس باستمرار أدوات الذكاء الاصطناعي "كيف أفعل X في منتجك"، وملف منسّق بعناية يوجّه تلك النماذج مباشرة نحو الصفحات الصحيحة.
لماذا يستفيد التوثيق أكثر من غيره
توثيقك بالفعل هو الإجابات. يتيح لك llms.txt أن تقدّم للنموذج فهرسًا نظيفًا لها — البدء السريع، والأدلة، والمرجع البرمجي للـ API — بدلًا من تركه يزحف عبر شريط التنقل وواجهات البحث وصفحات التسويق.
أنشئه من بنية موقعك
تمتلك معظم مواقع التوثيق بالفعل ملف sitemap.xml. اجمع تلك الروابط في بضعة أقسام منطقية بدلًا من سردها بشكل مسطّح:
# Acme Docs > Documentation for the Acme API: setup, guides, and the full endpoint reference. ## Getting started - [Quickstart](https://acme.com/docs/quickstart): First request in 5 minutes - [Authentication](https://acme.com/docs/auth): API keys and scopes ## Reference - [Endpoints](https://acme.com/docs/api): Every endpoint and parameter ## Optional - [Changelog](https://acme.com/docs/changelog): Release history
اربط نسخ Markdown
تستطيع العديد من أطر عمل التوثيق (Docusaurus و MkDocs و Mintlify و GitBook وغيرها) تقديم نسخة Markdown أو نص عادي لكل صفحة. اربط تلك النسخ — page.md — كي تحلّل النماذج محتوى نظيفًا بدلًا من HTML المُعروض مع شريط التنقل والأشرطة الجانبية.
أضف llms-full.txt للسياق الكامل
بالنسبة لمجموعات التوثيق الأكبر، انشر ملفًا مرافقًا llms-full.txt يتضمّن النص الكامل مُضمّنًا، كي يتمكّن وكيل ذكي من استيعاب كل شيء في عملية جلب واحدة. أبقِ llms.txt كفهرس موجز.
نسّق، ثم تحقّق
سواء كتبت الملف يدويًا أو أنشأته من إضافة برمجية، راجع المُخرجات — تميل المولّدات التلقائية إلى تضمين الكثير. اطّلع على أمثلة llms.txt للأنماط، ثم تحقّق لتأكيد البنية وأن كل رابط يعمل بشكل صحيح.