ملف llms.txt
خريطة Markdown عادية تُقدَّم في الجذر أو في مسار محدد للوكلاء المتوافقين. تغطي هذه الصفحة الموضع وبنية V2 والاكتشاف والتحقق.
آخر تحديث:
ما هو الملف
ملف llms.txt وثيقة Markdown ترسم خريطة للموارد المختارة للوكلاء المتوافقين، مع ملاحظة اختيارية لكل رابط. اقترحه Jeremy Howard (Answer.AI) في سبتمبر 2024 كاتفاقية، لا معياراً مفروضاً. وإذا أردت فهم المفهوم وصورة التبنّي، فابدأ بـ ما هو llms.txt؛ تركّز هذه الصفحة على الملف نفسه.
مكانه
يسمح V2 بجذر المصدر، https://yourdomain.com/llms.txt، أو مسار أكثر تحديداً مثل https://yourdomain.com/docs/llms.txt. يصف الملف الأكثر تحديداً والمنطبق نطاق الصفحة. صرّح به باستخدام rel="describedby" في HTML أو HTTP Link
الرأس متى أمكن. وملف مصاحب llms-full.txt قد يحمل محتوى صفحات مدمجاً
للعملاء الذين يدعمون تلك الاتفاقية صراحةً.
البنية في لمحة
- عنوان H1 واحد مع اسم الموقع أو المشروع. مطلوب، في السطر الأول.
- اقتباس اختياري بعد H1: ملخص واقعي.
- متن Markdown مجاني اختياري للسياق (بلا عناوين).
- أقسام H2، وكل منها قائمة بـ
- [name](url): noteعناصر. قسم بعنوانOptionalقد تضع تسميات تحريرية للروابط الثانوية، من دون دلالات خاصة بالإصدار v2.
توجد القواعد الكاملة مع أمثلة مشروحة في مرجع التنسيق.
مثال صالح بالحد الأدنى
# Acme
> Acme is a hosted analytics platform for product teams.
## Documentation
- [Quickstart](https://acme.example/docs/start): install, init, first dashboard.
- [API reference](https://acme.example/docs/api): full endpoint catalogue.
## Optional
- [Blog](https://acme.example/blog): product updates and tutorials.الأخطاء الشائعة
- عناوين URL نسبية غامضة. الروابط المطلقة أكثر أماناً عندما يكون الملف قابلاً للنسخ.
- نص تسويقي في الملخص. أبقِ الاقتباس واقعياً.
- تفريغ خريطة الموقع بالكامل. الملف خريطة منسّقة لا فهرس.
- HTML بدلاً من Markdown. يجب أن يكون الملف Markdown بنص عادي.
- تقديمه بنوع MIME خاطئ. استخدم
text/plain(UTF-8).
تقديمه بصورة صحيحة
في معظم المكدسات، يكون هذا ملفاً ثابتاً في دليلك العام: راجع أدلة كل مكدس لمعرفة
Next.js, Astro,
WordPress, Hugo أو
Cloudflare Pages. اضبط
Content-Type: text/plain; charset=utf-8 وتخزين مؤقت قصير حتى تنتشر التحديثات.
الأسئلة الشائعة
هل llms.txt هو نفسه llm.txt؟
اسم المواصفة هو llms.txt (جمع). llm.txt هو خطأ شائع في التهجئة؛ قدّم
هل يحتاج الملف إلى تحديث؟
نعم، مثل خريطة موقع: فالروابط المتقادمة تضعف ثقة الأدوات التي تقرأه. أعد توليده عند تغير صفحاتك الأساسية.
ما الحجم المناسب له؟
لا يضع الاقتراح حداً لعدد البايتات. أبقه مركزاً على المهام المقصودة، واختبر العملاء الذين تدعمهم، وقسّم النطاقات الحقيقية إلى ملفات على مستوى المسار عند الحاجة.