كيفية إنشاء ملف llms.txt
نُشر:
يستغرق إنشاء ملف llms.txt نحو عشر دقائق. يشرح هذا الدليل كل جزء منه بالترتيب، وينتهي بملف يمكنك نسخه وتكييفه حسب احتياجك.
1. ابدأ بعنوان H1
يجب أن يكون السطر الأول عنوان H1 واحدًا — وهو اسم مشروعك أو موقعك. وهو العنصر الوحيد المطلوب بصرامة في هذه الصيغة.
# Acme Docs
2. أضِف ملخّصًا على شكل اقتباس
أسفل العنوان مباشرةً، أضِف اقتباسًا من جملة أو جملتين. هذا هو السياق الذي يقرؤه النموذج اللغوي أولًا، لذا اجعله محدّدًا: ما هو الموقع ولِمَن هو موجَّه.
> Acme is a payments API. This file links to the docs an LLM needs to integrate and debug Acme.
3. (اختياري) أضِف بضعة أسطر نصّية
قبل أي عنوان قسم، يمكنك إضافة فقرات عادية تقدّم توجيهًا إضافيًا. لا تستخدم عناوين هنا — واجعلها مقتصرة على جملة أو جملتين.
4. اجمع روابطك ضمن أقسام H2
كل قسم هو عنوان H2 يتبعه قائمة بصيغة markdown. كل عنصر هو رابط مع وصف اختياري بعد نقطتين رأسيتين.
## Docs - [Quickstart](https://acme.com/docs/quickstart): Integrate in five minutes - [API reference](https://acme.com/docs/api): Every endpoint and parameter ## Examples - [Sample app](https://acme.com/examples/app): A working end-to-end example
استخدم عناوين URL مطلقة بصيغة https، واجعل الأوصاف مركّزة على ما يحتاجه المطوّر أو النموذج — وليس على نصوص تسويقية.
5. استخدم قسم "Optional" للعناصر المرغوبة دون أن تكون ضرورية
للقسم المُسمّى حرفيًا ## Optional دلالة خاصة: يمكن تخطّي روابطه عند الحاجة إلى سياق أقصر. ضع هنا سجلّات التغييرات، والمقالات، والمراجع الثانوية.
6. استضِفه في الجذر
قدِّم الملف على https://yourdomain.com/llms.txt مع Content-Type: text/plain. وغالبًا ما تنشر المواقع الكبيرة أيضًا ملف llms-full.txt يتضمّن المحتوى الكامل والموسَّع.
7. تحقَّق من الصحة قبل النشر
الصق نطاقك في أداة التحقّق. فهي تفحص البنية، وتتأكّد من أن كل رابط يعمل فعلًا، وتعرض بالضبط ما يجب إصلاحه. اسعَ إلى تحقيق 100/100.