- [ الرئيسية ](/ar/) / - ملف llms.txt # ملف `llms.txt` خريطة Markdown عادية تُقدَّم في الجذر أو في مسار محدد للوكلاء المتوافقين. تغطي هذه الصفحة الموضع وبنية V2 والاكتشاف والتحقق. آخر تحديث: 12 أغسطس 2026 في هذه الصفحة - [ ماهيّة الملف ](#what) - [ موضعه ](#location) - [ البنية في لمحة ](#structure) - [ مثال صالح بالحد الأدنى ](#example) - [ الأخطاء الشائعة ](#mistakes) - [ تقديمه بصورة صحيحة ](#serve) - [ الأسئلة الشائعة ](#faq) ## ما هو الملف ملف llms.txt وثيقة Markdown ترسم خريطة للموارد المختارة للوكلاء المتوافقين، مع ملاحظة اختيارية لكل رابط. اقترحه Jeremy Howard (Answer.AI) في سبتمبر 2024 كاتفاقية، لا معياراً مفروضاً. وإذا أردت فهم المفهوم وصورة التبنّي، فابدأ بـ [ما هو llms.txt](/ar/what-is-llms-txt/)؛ تركّز هذه الصفحة على الملف نفسه. ## مكانه يسمح V2 بجذر المصدر، `https://yourdomain.com/llms.txt`، أو مسار أكثر تحديداً مثل `https://yourdomain.com/docs/llms.txt`. يصف الملف الأكثر تحديداً والمنطبق نطاق الصفحة. صرّح به باستخدام `rel="describedby"` في HTML أو HTTP `Link` الرأس متى أمكن. وملف مصاحب [llms-full.txt](/ar/llms-full-txt/) قد يحمل محتوى صفحات مدمجاً للعملاء الذين يدعمون تلك الاتفاقية صراحةً. ## البنية في لمحة - **عنوان H1 واحد** مع اسم الموقع أو المشروع. مطلوب، في السطر الأول. - **اقتباس اختياري** بعد H1: ملخص واقعي. - متن Markdown مجاني اختياري للسياق (بلا عناوين). - **أقسام H2**، وكل منها قائمة بـ `- [name](url): note` عناصر. قسم بعنوان `Optional` قد تضع تسميات تحريرية للروابط الثانوية، من دون دلالات خاصة بالإصدار v2. توجد القواعد الكاملة مع أمثلة مشروحة في [مرجع التنسيق](/ar/llms-txt-format/). ## مثال صالح بالحد الأدنى llms.txt نسخ ``` # 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](/ar/llms-txt-nextjs/), [Astro](/ar/llms-txt-astro/), [WordPress](/ar/llms-txt-wordpress/), [Hugo](/ar/llms-txt-hugo/) أو [Cloudflare Pages](/ar/llms-txt-cloudflare/). اضبط `Content-Type: text/plain; charset=utf-8` وتخزين مؤقت قصير حتى تنتشر التحديثات. ملاحظة أنشئ الملف، ثم تحقّق منه أسرع مسار: أنشئ مسودة من خريطة موقعك , عدّله، ثم تحقّق منه مقابل المواصفة . كلتا الأداتين مجانيتان وتعملان من دون حساب. ## الأسئلة الشائعة ### هل llms.txt هو نفسه llm.txt؟ اسم المواصفة هو `llms.txt` (جمع). `llm.txt` هو خطأ شائع في التهجئة؛ قدّم ### هل يحتاج الملف إلى تحديث؟ نعم، مثل خريطة موقع: فالروابط المتقادمة تضعف ثقة الأدوات التي تقرأه. أعد توليده عند تغير صفحاتك الأساسية. ### ما الحجم المناسب له؟ لا يضع الاقتراح حداً لعدد البايتات. أبقه مركزاً على المهام المقصودة، واختبر العملاء الذين تدعمهم، وقسّم النطاقات الحقيقية إلى ملفات على مستوى المسار عند الحاجة. ## المصادر - [ llmstxt.org، اقتراح المجتمع ](https://llmstxt.org/)