ملف llms.txt: ما هو وكيف تكتبه

ما الذي يقوله المقترح فعلًا

المشكلة التي صُمّم llms.txt لها هي السياق لا الزحف. فحين يحتاج نموذج أو وكيل إلى الإجابة عن سؤال باستعمال موقعك، تكون نافذة سياقه محدودة ومدخلاته عدائية: صفحات HTML مليئة بقوائم التنقّل ولافتات الكوكيز والأشرطة الجانبية والإعلانات والمحتوى المعروض بـJavaScript. وتحويل موقع كبير إلى شيء يستطيع نموذج أن يفكّر فيه مكلف ومهدر للمعلومات.

تقترح مواصفة llms.txt إصلاحين متكاملين. الأول ملف Markdown واحد على /llms.txt يعمل فهرسًا منتقى — هذا ما يكونه المشروع، وهذه الصفحات المهمّة، مرتّبةً بحسب الأولوية. والثاني نشر نسخ Markdown نظيفة للصفحات المفردة على روابط يمكن توقّعها (صفحة على /docs/setup متاحة أيضًا على /docs/setup.md)، حتى إذا اختار الوكيل رابطًا من فهرسك جلب نصًّا لا قالبًا.

ولاحظ ما ليس هو. فهو لا يحوي توجيهات ولا قواعد سماح أو منع ولا أذونات. إنه قائمة قراءة تعرضها، ولكل مستهلك أن يتجاهلها. والمواصفة عمدًا بصيغة Markdown لا JSON ولا XML، لأن المستهلك المقصود نموذج لغوي، ولأن على البشر أن يستطيعوا صيانته يدويًا.

أين يقف التبنّي فعلًا

كن متشكّكًا تجاه من يزعم أن llms.txt صار عامل ترتيب. فقد شبّهه John Mueller من Google علنًا بوسم keywords القديم وقال إن Google لا تستعمله في البحث، وتجد تغطية ذلك في Search Engine Roundtable. ولا تذكر وثائق Google للزحف والفهرسة هذا الملف مطلقًا؛ أما الملف الذي توثّقه للتحكّم بالزواحف فهو robots.txt.

وعلى جانب الاستهلاك، الموقف الصادق أن لا مورّد مساعد كبير نشر وثائق تقول إن زاحفه أو طبقة الاسترجاع لديه تستعمل /llms.txt لتقرير ما تجلبه أو تستشهد به. أما حيث يُستعمل الملف فعلًا فهو الاتّجاه الآخر: يلصق المطوّرون رابط llms.txt في محادثة أو يوجّهون وكيل برمجة إليه، فيتبع الوكيل الروابط. وهذا سير عمل حقيقي، وهو السير الذي كُتبت المواصفة لأجله.

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

كيف تكتب llms.txt: الصيغة الدقيقة

تحدّد المواصفة ترتيبًا دقيقًا للمستند، والترتيب هو المقصد كلّه — إذ ينبغي أن يستطيع المستهلك تحليله بقارئ Markdown بسيط لا بالتخمين.

العنصر الوحيد المطلوب عنوان H1 يحمل اسم الموقع أو المشروع. وكل ما بعده اختياري لكنه مقيّد بالموضع: اقتباس اختياري يلي H1 مباشرةً يحمل ملخّصًا قصيرًا بالمعلومات الأساسية اللازمة لفهم البقيّة؛ ثم صفر أو أكثر من أقسام Markdown نثرًا أو قوائم بتفاصيل إضافية، بلا أي عناوين؛ ثم صفر أو أكثر من أقسام H2، يحمل كلٌّ منها قائمة روابط.

وتأتي أسطر الروابط بصيغة عنصر قائمة في Markdown يضمّ رابطًا ووصفًا اختياريًا بعد النقطتين: الاسم، ثم الرابط، ثم جملة تشرح متى تُقرأ. وتلك الأوصاف تؤدّي عملًا حقيقيًا — فبها يقرّر النموذج أي رابطين من روابطك الخمسة عشر يستحقّان إنفاق السياق، فاكتبها تعليمات توجيه لا نصوص تسويق.

ولعنوان H2 واحد معنى خاص: القسم المعنون Optional. فالروابط تحته يجوز تخطّيها حين يلزم سياق أقصر. استعمله لسجلّات التغييرات والمواد المرجعية العميقة وكل ما يستطيع القارئ الإجابة عنه دونه. وثمّة عرف منفصل، llms-full.txt، يحمل النصّ الكامل المجمَّع لوثائقك، وهو شائع في منصّات التوثيق لكنه ليس جزءًا من المواصفة الأساسية — عامله إضافةً، ولا تنشره إلا إذا كان محتواك يتّسع فعلًا في نافذة سياق حديثة.

• قدّمه في جذر النطاق باسم /llms.txt، بنوع text/plain أو text/markdown، عبر HTTPS.
• أبقِه قصيرًا. فعشرة إلى ثلاثين رابطًا منتقى تتفوّق على تفريغ خريطة الموقع؛ وإن كنت تحتاج كل رابط فلديك خريطة XML أصلًا.
• اكتب أوصافًا تميّز: «باقات الأسعار وحدودها» لا «تعرّف أكثر على Growli».
• لا تربط إلا صفحات عامة ومستقرّة. فالروابط المكسورة في فهرس منتقى أسوأ من غياب الفهرس.
• أعد توليده في عملية البناء لا يدويًا، إن كانت وثائقك تتغيّر أسبوعيًا.

مثال منفَّذ: ملف Growli نفسه

ملفّنا صغير عمدًا. فـGrowli يقيس كيف يذكر مساعدو الذكاء الاصطناعي الأنشطة ويرشّحونها، ولذلك فالصفحات التي يحتاجها الوكيل هي: ماذا يفعل المنتج، وكيف يعمل القياس، والأسعار، ومقالات البحث التي تعرّف مصطلحاتنا. ولا شيء غير ذلك يستحقّ مقعدًا.

وإذا قُرئ بوصفه ملفًّا، فهو H1 وملخّص واحد في اقتباس، ثم قسما H2 — والثاني منهما Optional. وكل سطر أدناه هو سطر من ذلك الملف:

• # Growli
• > يتتبّع Growli كيف يذكر مساعدو الذكاء الاصطناعي — ChatGPT وGemini وClaude وPerplexity وCopilot وGrok — الأنشطة ويقارنونها ويرشّحونها، ويحوّل الفجوات إلى إجراءات مرتّبة بالأولوية.
• ## Core
• كيف يعمل: منهج القياس — مجموعات الأسئلة، ووتيرة التشغيل، وكيفية تقييم الذكر والترشيح.
• الظهور في الذكاء الاصطناعي: تعريف المقياس، وما يحرّكه، وما لا يحرّكه.
• ## Optional
• المدوّنة: مقالات بحثية عن سلوك المساعدين وأنماط الاستشهاد ومنهجية القياس.

أين يقع بجوار robots.txt والبيانات المهيكلة

تجيب هذه الملفّات الثلاثة عن ثلاثة أسئلة مختلفة، والخلط بينها أشيع خطأ نراه في التدقيقات.

يجيب robots.txt عن سؤال: هل يجوز لك الجلب؟ فهو ملف تحكّم بوصول الزواحف له سلوك تحليل موثَّق منذ زمن، وفيه تسمح للزواحف الذكية المسمّاة أو تمنعها. وإن أردت تقييد التدريب أو الزحف فذلك يجري هناك وفي شروطك، لا في llms.txt أبدًا. وتجيب البيانات المهيكلة عن سؤال: ما هذا؟ إذ تتيح لك مفردات Schema.org بصيغة JSON-LD أن تقول بلا لبس إنك Organization بهذا الاسم، وبهذه المنتجات، وهذا السعر، وهذه المراجعات، وهي نوع الوقائع المقروءة آليًا التي تصمد للتلخيص. أما llms.txt فلا يجيب إلا عن سؤال: ماذا أقرأ أولًا؟ لمستهلك قرّر أصلًا أن يقرأك.

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

فهل ينبغي أن تنشر واحدًا؟

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

وربما لا يستحقّ الأولوية إن كنت نشاط خدمات محليًّا أو متجرًا إلكترونيًا أو موقعًا تسويقيًا من اثنتي عشرة صفحة. فلا دليل على أنه يغيّر ترشيح المساعد لك، والجهد أجدى في ما يقرؤه المساعدون فعلًا: صفحات تُعرض بلا JavaScript، ومحتوى مقارنة وأسعار صريح، ووقائع كيان متّسقة عبر موقعك وإدراجاتك لدى الأطراف الثالثة، وحضور في مواقع المراجعة والقوائم التي تتّكئ عليها النماذج حين تجيب عن «أفضل X لـY».

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

FAQ