كيف تجعل التوثيق جاهزاً للذكاء الاصطناعي لـ ChatGPT و Claude
ما الذي يجعل مركز المساعدة قابلاً للقراءة فعلياً بواسطة ChatGPT و Claude و Perplexity ووكلاء الذكاء الاصطناعي: HTML قابل للزحف، وقواعد robots.txt الصحيحة، ومقالات تبدأ بالإجابة مباشرة، ونظرة صادقة على llms.txt و MCP.
Berkay Akpolatقراءة لمدة 13 دقيقة
تم التحديث في 3 نوفمبر 2026
لجعل التوثيق جاهزاً للذكاء الاصطناعي، ابدأ بالأساسيات التي ثبتت أهميتها: يجب أن تكون زواحف الذكاء الاصطناعي قادرة على جلب صفحاتك كـ HTML عادي، ويجب أن يسمح ملف robots.txt الخاص بك لروبوتات البحث بالدخول، ويجب أن تجيب كل مقالة على سؤال واحد بوضوح، مع ذكر الخطة والدور والقيود. حافظ على تحديث الصفحات، ثم أضف نسخ Markdown، و llms.txt وخادم MCP لوكلاء الذكاء الاصطناعي. هذه الإضافات غير مكلفة، لكن تأثيرها المقاس على إجابات الذكاء الاصطناعي لا يزال ضئيلاً حتى الآن.
هذا الدليل مخصص لقادة الدعم الذين يسأل عملاؤهم الآن ChatGPT أو Perplexity أو Google AI Overviews عن كيفية استخدام منتجك، وللفرق التي يوجه مطوروها Claude Code أو Cursor إلى وثائقك. إنه يفصل ما تدعمه الأدلة عما لا يزال مجرد رهان.
ماذا يعني التوثيق الجاهز للذكاء الاصطناعي؟
التوثيق الجاهز للذكاء الاصطناعي هو التوثيق الذي يمكن لأنظمة الذكاء الاصطناعي جلبه وفهمه واقتباسه بشكل صحيح: وثائق قابلة للقراءة بواسطة الذكاء الاصطناعي لمحركات الإجابة، ووثائق لوكلاء الذكاء الاصطناعي الذين يعملون بناءً عليها. هناك نوعان من القراء يهماننا:
- محركات الإجابة (بحث ChatGPT، وPerplexity، وClaude، وGoogle AI Overviews وAI Mode) تجيب على أسئلة عملائك وتستشهد بالصفحات كمصادر.
- وكلاء الذكاء الاصطناعي (Claude Code، وCursor، وCodex، والمساعدون المخصصون) يقرؤون وثائقك لتنفيذ مهمة، غالباً من خلال ملفات Markdown أو خادم MCP.
كلاهما ينمو بسرعة. وجد استطلاع Stack Overflow لعام 2025 أن 84% من المطورين يستخدمون أو يخططون لاستخدام أدوات الذكاء الاصطناعي، وأحصى Similarweb 1.13 مليار زيارة إحالة من منصات الذكاء الاصطناعي في يونيو 2025، بزيادة 357% عن العام السابق، حيث أرسل ChatGPT أكثر من 80% منها. وعندما تعرض Google ملخصاً للذكاء الاصطناعي، يقل عدد الأشخاص الذين ينقرون للوصول إلى الموقع: وجد مركز Pew للأبحاث أن المستخدمين نقروا على رابط النتيجة في 8% من الزيارات التي تحتوي على ملخص ذكاء اصطناعي، مقابل 15% بدون ملخص. إذا تم عرض الإجابة دون الحاجة للنقر، فمن الأفضل أن تكون الإجابة صحيحة، وهي صحيحة فقط بقدر صحة وثائقك. المزيد من الأرقام حول الأماكن التي يبحث فيها العملاء عن المساعدة موجودة في إحصائيات الخدمة الذاتية للعملاء.
هل يمكن لزواحف الذكاء الاصطناعي قراءة مركز المساعدة الخاص بك فعلياً؟
تحقق من هذا أولاً، لأنه لا شيء آخر يهم إذا كانت الإجابة لا.
هل النص موجود في HTML؟ وجد تحليل Vercel في ديسمبر 2024 لحركة مرور الزواحف أن أياً من زواحف الذكاء الاصطناعي الرئيسية لا تقوم بعرض JavaScript، باستثناء زاحف Gemini من Google وزاحف Apple. مركز المساعدة الذي يحمل مقالاته باستخدام JavaScript من جانب العميل قد يبدو فارغاً لزواحف ChatGPT و Claude. اختبر ذلك:
curl -s -A "GPTBot" https://help.example.com/your-article \
| grep "a sentence from the article"إذا لم تكن الجملة موجودة في الاستجابة، فإن الزاحف لا يراها أيضاً. الصفحات التي يتم عرضها من جانب الخادم أو المعروضة مسبقاً تحل هذه المشكلة.
هل عناوين URL الخاصة بك تعمل؟ في نفس بيانات Vercel، حوالي 35% من عمليات جلب زواحف ChatGPT و Claude تصل إلى صفحات 404. احتفظ بعمليات إعادة التوجيه عند نقل المقالات أو إعادة تسميتها، وحافظ على تحديث خريطة الموقع. إذا كنت تغير المنصات، فاتبع قائمة التحقق من ترحيل مركز المساعدة.
هل الصفحة عامة؟ لا يمكن لمحركات الإجابة قراءة الصفحات الموجودة خلف تسجيل الدخول. إذا كان لديك وثائق خاصة للعملاء، فتقبل حقيقة أن إجابات الذكاء الاصطناعي ستأتي من صفحاتك العامة والمنتديات والمواقع الخارجية بدلاً من ذلك.
ما هي روبوتات الذكاء الاصطناعي التي يجب أن يسمح بها ملف robots.txt الخاص بك؟
تدير كل شركة ذكاء اصطناعي روبوتات منفصلة للتدريب وللبحث. حظر "جميع روبوتات الذكاء الاصطناعي" يزيلك من إجابات الذكاء الاصطناعي أيضاً.
| الروبوت (الشركة) | ماذا يفعل | احظره إذا… |
|---|---|---|
| GPTBot (OpenAI) | يجمع المحتوى لتدريب النموذج | تريد إلغاء الاشتراك في التدريب |
| OAI-SearchBot (OpenAI) | يجد الصفحات لعرضها في بحث ChatGPT | نادراً: حظره يبقيك خارج إجابات بحث ChatGPT |
| ChatGPT-User (OpenAI) | يجلب صفحة عندما يسأل مستخدم | غير عملي: عمليات الجلب التي يبدأها المستخدم قد لا تتبع robots.txt |
| ClaudeBot (Anthropic) | يجمع المحتوى للتدريب | تريد إلغاء الاشتراك في التدريب |
| Claude-SearchBot, Claude-User (Anthropic) | فهرسة البحث وعمليات الجلب التي يطلبها المستخدم | فقط للخروج من إجابات بحث Claude |
| PerplexityBot (Perplexity) | يفهرس الصفحات للاقتباس منها في الإجابات، وليس للتدريب | فقط للخروج من إجابات Perplexity |
| Perplexity-User (Perplexity) | يجلب صفحة عندما يسأل مستخدم | غير عملي: تقول Perplexity إنها تتجاهل robots.txt بشكل عام |
| Google-Extended (Google) | تدريب Gemini والتأسيس في تطبيقات Gemini؛ ليس البحث أو AI Overviews | تريد إلغاء الاشتراك في تدريب وتأسيس Gemini |
التفاصيل تأتي من وثائق كل شركة: OpenAI، وAnthropic، وPerplexity. مركز المساعدة الذي يريد أن يتم الاستشهاد به ولكن لا يُستخدم للتدريب يمكنه قول:
User-agent: GPTBot
Disallow: /
User-agent: ClaudeBot
Disallow: /
User-agent: Google-Extended
Disallow: /
User-agent: *
Allow: /
Sitemap: https://help.example.com/sitemap.xmlالروبوت الذي لديه مجموعته الخاصة يتجاهل قواعد *، لذا كرر أي أسطر Disallow (مثل /admin) في كل مجموعة مسماة. حظر Google-Extended يمنع أيضاً تطبيقات Gemini من تأسيس الإجابات على صفحاتك؛ بحث Google و AI Overviews لا يتأثران.
تحقق أيضاً من شبكة توصيل المحتوى (CDN) أو جدار الحماية الخاص بك. قد يؤدي تبديل "حظر روبوتات الذكاء الاصطناعي" هناك إلى تجاوز ملف robots.txt المسموح.
كيف يجب أن تكتب مقالات المساعدة حتى يجيب الذكاء الاصطناعي بشكل صحيح؟
محركات الإجابة تسحب فقرة، وليس موقعك بالكامل. يجب أن تقف كل فقرة بمفردها.
- مهمة واحدة لكل مقالة، مسمات بالطريقة التي يسأل بها العملاء. "إلغاء أو إيقاف اشتراكك مؤقتاً"، وليس "إدارة الاشتراك".
- ابدأ بالإجابة. يجب أن تجيب الجملتان الأوليان تحت كل عنوان على ذلك العنوان. تم بناء قالب مقالة مركز المساعدة الخاص بنا بهذه الطريقة.
- اذكر الشروط. أي خطة، أي دور، أي منصة. "المسؤولون فقط يمكنهم حذف مساحة عمل" هي جملة قابلة للاقتباس؛ "يمكنك حذف مساحة عمل" تنتج إجابات خاطئة لكل شخص آخر.
- قل ما لا يمكن للمنتج فعله. غالباً ما يُسأل المساعدون "هل يمكنني…؟" إذا كانت وثائقك تصف فقط ما هو موجود، فإن النموذج يخمن.
- استخدم اسماً واحداً لكل شيء، وعرفه مرة واحدة. إذا كانت "مساحة العمل" و"الحساب" و"المؤسسة" تعني نفس الشيء، فاختر واحداً، واحتفظ بصفحة مسرد قصيرة تعرف مصطلحات منتجك.
- امنح كل صفحة بيانات وصفية نظيفة. عنوان محدد، وصف من سطر واحد، تاريخ آخر تحديث، وحيثما ينطبق ذلك، الخطة أو منطقة المنتج. تستخدم محركات الإجابة وبحثك الخاص هذه لتحديد أي صفحة تجيب على سؤال.
- لا تخفِ الخطوات في الصور أو مقاطع الفيديو. امنح كل لقطة شاشة نصاً بديلاً حقيقياً، وتأكد من أن كل خطوة يعرضها الفيديو موجودة أيضاً كنص.
- غطِّ الأساسيات قبل الحالات النادرة. إذا كنت لا تزال تبني مركز المساعدة، فابدأ بـ كيفية بناء قاعدة معرفية باستخدام الذكاء الاصطناعي.
- حافظ على تحديثها. المقالة القديمة هي الآن إجابة قديمة، مكررة بثقة. دليلنا حول الحفاظ على تحديث التوثيق يغطي روتيناً لكل إصدار، وكيفية التحديث التلقائي للتوثيق في كل إصدار يوضح كيفية البدء من الإصدار نفسه.
تقول Google الشيء نفسه بكلمات أبسط: بالنسبة لميزات الذكاء الاصطناعي الخاصة بها، "لا توجد متطلبات إضافية" ولا توجد تحسينات خاصة مطلوبة تتجاوز تحسين محركات البحث (SEO) العادي. يقول دليلها أيضاً إنه لا يوجد متطلب لتقسيم المحتوى الخاص بك إلى قطع صغيرة من أجل الذكاء الاصطناعي، لذا لا تقطع المقالات إلى أجزاء لتناسب نموذجاً.
هل يجب عليك إضافة llms.txt للتوثيق؟
إنه يساعد أقل مما يقترحه البائعون. llms.txt هو ملف Markdown في جذر موقعك يسرد صفحاتك الأكثر فائدة مع أوصاف قصيرة. اقترح جيريمي هوارد ذلك في سبتمبر 2024 كخريطة لنماذج اللغة.
الأدلة حتى الآن:
- جوجل تتجاهله. يقول دليل جوجل إنك لا تحتاج إلى ملفات جديدة قابلة للقراءة آلياً، أو ملفات نصية للذكاء الاصطناعي، أو ترميز، أو Markdown للظهور في بحث جوجل، وأن ملفات llms.txt لن تساعد ولن تضر لأن البحث يتجاهلها. في عام 2025، قارن جون مولر من جوجل ملفات llms.txt بـ وسم الكلمات المفتاحية (keywords meta tag).
- عدد قليل من الروبوتات يطلبه. درست Ahrefs عدد 137,210 نطاقاً ووجدت أن 97% من ملفات llms.txt لم تتلق أي طلبات في مايو 2026. شكلت روبوتات استرجاع الذكاء الاصطناعي 1.1% فقط من الطلبات التي وصلت (ومساعدو الذكاء الاصطناعي 2.5% أخرى)؛ وكانت وكلاء البرمجة مثل Claude Code من بين القراء الرئيسيين المذكورين.
إذن: أضف llms.txt إذا كانت منصة التوثيق الخاصة بك توفره مجاناً، خاصة إذا كان المطورون يستخدمون وثائقك مع وكلاء البرمجة، لكن لا تتوقع أن يغير ذلك ما يقوله ChatGPT عنك. llms-full.txt (جميع الصفحات في ملف واحد) هو اصطلاح شائع، وليس جزءاً من المقترح.
هل يجب أن تكون وثائقك متاحة بصيغة Markdown؟
نعم، إذا كان ذلك لا يكلفك شيئاً. تعمل الوكلاء التي تجلب الصفحات بشكل أفضل مع Markdown نظيف بدلاً من HTML المليء بالتنقل والسكربتات، ويقترح مقترح llms.txt تقديم كل صفحة على نفس الرابط مع إضافة .md. ثلاث تفاصيل:
- قم بتمييز نسخ Markdown بـ
noindex(يعمل ترويسةX-Robots-Tag)، حتى لا تتعامل محركات البحث معها كنسخ مكررة من صفحات HTML. - حافظ على توليدها من نفس مصدر HTML، حتى لا تختلف عنها أبداً.
- اسمح للوكلاء بالعثور عليها: يقترح المقترح وسم
<link rel="alternate" type="text/markdown">على كل صفحة HTML.
كيف تستخدم وكلاء الذكاء الاصطناعي الوثائق عبر MCP؟
إن بروتوكول سياق النموذج (Model Context Protocol) هو معيار مفتوح يسمح لتطبيق الذكاء الاصطناعي باستدعاء الأدوات وقراءة البيانات من أنظمة أخرى. يسمح خادم MCP للوثائق للوكيل بالبحث في وثائقك عند الطلب بدلاً من الاعتماد على ما تعلمه أثناء التدريب، ومع الأذونات الصحيحة، يمكنه صياغة أو تحديث الصفحات. للمقارنة بين الخوادم المتاحة، انظر خوادم MCP للوثائق.
تنطبق نفس القواعد إذا قمت ببناء مساعدك الخاص على وثائقك (التوليد المعزز بالاسترجاع، أو RAG): لا يمكن أن يكون دقيقاً إلا بقدر دقة المقاطع التي يسترجعها. تحذيران: امنح حق القراءة فقط لأي شيء يواجه العميل ما لم يراجع شخص ما عمليات الكتابة، وتذكر أن MCP يساعد الوكلاء الذين يربطهم مستخدموك بأنفسهم. إنه لا يغير ما تقوله محركات الإجابة العامة.
كيف تختبر ما يقوله مساعدو الذكاء الاصطناعي عن منتجك؟
لا يمكن لأحد رؤية ما بداخل النماذج، لذا اختبر المخرجات. مرة واحدة في الشهر:
- اكتب 20 سؤالاً حقيقياً للعملاء من التذاكر وعمليات البحث الفاشلة في مركز المساعدة.
- اطرح كل سؤال في ChatGPT وPerplexity وClaude وجوجل (وضع الذكاء الاصطناعي أو نظرة عامة للذكاء الاصطناعي).
- سجل ما إذا كانت الإجابة صحيحة وأي صفحة تستشهد بها.
| السؤال (المساعد) | ما قاله (المصدر المذكور) | الإصلاح |
|---|---|---|
| كيف أقوم بتصدير الفواتير إلى CSV؟ (ChatGPT) | صحيح جزئياً: مسار قائمة قديم (منشور منتدى عام 2024) | تحديث مقالة التصدير؛ ضع المسار الجديد في فقرتها الأولى |
| هل يمكنني إيقاف اشتراكي مؤقتاً؟ (Perplexity) | خطأ: يقول إنه غير ممكن (لا يوجد مصدر) | إضافة مقالة "إيقاف مؤقت أو إلغاء" توضح حدود الخطة |
- أصلح المقالة التي كان يجب أن تأتي منها الإجابة الخاطئة، ثم أعد السؤال في الشهر التالي.
لمعرفة جانب الزيارات، قم بتقسيم الزيارات حسب المصدر (chatgpt.com, perplexity.ai, claude.ai)، وتحقق من سجلات خادمك لأسماء الروبوتات في الجدول أعلاه (باستثناء Google-Extended، الذي ليس لديه وكيل مستخدم خاص به). يقوم جوجل بحساب النقرات من ميزات الذكاء الاصطناعي في تقرير الأداء بـ Search Console، تحت نوع بحث الويب.
كيف تجعل الوثائق جاهزة للذكاء الاصطناعي: قائمة التحقق
| الأولوية | المهمة | الدليل |
|---|---|---|
| 1 | نص المقالة موجود في HTML بدون JavaScript | قوي: زواحف الذكاء الاصطناعي الرئيسية لا تعالج JS |
| 2 | robots.txt والجدار الناري يسمحان لروبوتات البحث بالدخول (روبوتات التدريب اختيارية) | قوي: موثق من قبل كل شركة ذكاء اصطناعي |
| 3 | مهمة واحدة لكل مقالة، الإجابة أولاً، الخطة والدور محددان | جيد: يطابق توجيهات جوجل |
| 4 | المحتوى محدث مع كل إصدار؛ لا توجد أخطاء 404 | جيد: الصفحات القديمة تنتج إجابات خاطئة |
| 5 | خريطة الموقع محدثة | جيد: اكتشاف قياسي |
| 6 | نسخة Markdown لكل صفحة، مع وسم noindex | متوسط: يستخدمه وكلاء البرمجة |
| 7 | llms.txt | ضعيف حتى الآن: طلبات قليلة، جوجل يتجاهله |
| 8 | خادم MCP للوكلاء | مفيد لمستخدمي الوكلاء؛ لا تأثير على الإجابات العامة |
| دائماً | اختبار شهري لـ 20 سؤالاً حقيقياً | دليلك الخاص |
كيف تم بناء مراكز مساعدة Clevera للقراء من الذكاء الاصطناعي
Clevera هي منصة ذكاء اصطناعي تحول تسجيل الشاشة إلى فيديو تعليمي، ومقالة مساعدة خطوة بخطوة، وصفحة في مركز المساعدة المستضاف الخاص بك، بـ 74 لغة. تتعامل مراكز المساعدة المستضافة الخاصة بها مع معظم النصف التقني من قائمة التحقق، في كل خطة بما في ذلك المجانية:
- صفحات مُعرضة مسبقاً وخريطة موقع، بحيث يكون نص المقالة في HTML الذي تجلبه الزواحف.
llms.txt،llms-full.txtونسخة.mdمن كل صفحة، تحت إعداد llms.txt ونسخ Markdown ("اسمح لأدوات الذكاء الاصطناعي بقراءة وثائقك")، وهو مفعل افتراضياً. في مركز المساعدة الخاص بنا، يتم تقديم نسخ Markdown بـnoindex. مراكز المساعدة الخاصة (Pro وما فوق) تبقي كل هذا خلف تسجيل الدخول.- اسأل الذكاء الاصطناعي لقرائك (قم بتفعيل إظهار المساعد في الإعدادات ← مساعد الذكاء الاصطناعي؛ 300 إجابة شهرياً في الخطة المجانية). يجيب المساعد المدمج من صفحاتك المنشورة فقط، ويربط مصادره، ويذكر ذلك عندما لا تغطي الوثائق سؤالاً، ويسرد تلك الأسئلة تحت أسئلة لم تتم الإجابة عليها حتى تعرف ما يجب كتابته تالياً (دليلنا حول فجوات محتوى مركز المساعدة يوضح كيفية العمل عليها).
- وكلاء الذكاء الاصطناعي وMCP (Pro وما فوق). يمكن لـ Claude Code أو Codex أو Cursor أو Claude أو ChatGPT البحث وصياغة وتحديث مركز المساعدة الخاص بك من خلال خادم MCP وAPI الخاص بـ Clevera، مع حقوق النشر. يمكن لرمز مساعد الدعم البحث فقط في الصفحات العامة المنشورة.
هذا هو الجزء العلوي من llms.txt الذي ينشره مركز المساعدة الخاص بنا (مختصر):
# Clevera Help Center
> Clevera turns screen recordings into polished videos: record your screen
> or let the AI record a website, edit with zooms, captions and AI
> voice-overs, then share or embed the result. ...
Every page is also available as Markdown: append `.md` to its URL.
The full text of all pages is at https://help.clevera.ai/llms-full.txt.
### Getting started
- [Understand what Clevera makes](https://help.clevera.ai/docs/getting-started/what-clevera-makes.md): ...
نصف الكتابة لا يزال ملكك، وتساعد Clevera هناك أيضاً: المقالات التي يتم إنشاؤها من تسجيل الشاشة تظهر كخطوات مرقمة مع لقطات شاشة لما يظهر على الشاشة، ويمكن للتسجيل خلف الفيديو أيضاً إنتاج مقالته المكتوبة، بحيث لا تعيش الخطوات في فيديو فقط. لا يمكن لأي منصة أن تعد بأن ChatGPT سيستشهد بك، ونحن لا نعد بذلك أيضاً.
ابدأ مجاناً مع مركز مساعدة مستضاف، أو استورد مركزك الحالي من Zendesk أو Intercom أو GitBook أو منصات أخرى. الإعدادات موجودة في التحكم في من يمكنه قراءة موقع الوثائق، إعداد مساعد موقع الوثائق وربط وكلاء الذكاء الاصطناعي بمواقع وثائقك. نظرة عامة على المنتج موجودة في صفحة برمجيات مركز المساعدة وفي منشور إطلاق مواقع الوثائق الخاص بنا.
الأسئلة الشائعة
هل يستحق llms.txt الإضافة إلى مركز المساعدة؟
أضفه إذا كانت منصتك تولده مجاناً. إنه لا يكلف شيئاً ووكلاء البرمجة يقرؤونه، لكن جوجل لا تستخدمه والدراسات تظهر عدم وجود طلبات تقريباً من روبوتات بحث الذكاء الاصطناعي. HTML القابل للزحف والمقالات الواضحة والحديثة تهم أكثر بكثير.
كيف أجعل ChatGPT يجيب على الأسئلة حول منتجي بشكل صحيح؟
تأكد من أن OAI-SearchBot يمكنه زحف مركز المساعدة العام الخاص بك، وأن نص المقالة موجود في HTML، وأن كل مقالة تجيب على سؤال واحد بالشروط المذكورة. ثم اختبر أسئلة العملاء الحقيقية شهرياً وأصلح الصفحات خلف الإجابات الخاطئة. هذا يحسن الاحتمالات؛ لا يمكن لأحد جعل ChatGPT يستشهد بك.
هل يجب أن أحظر GPTBot وClaudeBot؟
هذا قرار تدريب، وليس قرار ظهور. حظر GPTBot وClaudeBot يبقي وثائقك خارج تدريب النموذج؛ ولا يزيلك من بحث ChatGPT أو Claude، اللذين يستخدمان OAI-SearchBot وClaude-SearchBot. لا تحظر هؤلاء إذا كنت تريد أن يتم الاستشهاد بك.
هل تساعد البيانات المنظمة في نظرة عامة للذكاء الاصطناعي؟
يقول جوجل إنه لا حاجة لمخطط خاص لميزات الذكاء الاصطناعي. استخدم البيانات المنظمة حيث تصف محتوى مرئياً، كما تفعل في البحث العادي.
ما الفرق بين الوثائق الجاهزة للذكاء الاصطناعي وروبوت محادثة ذكاء اصطناعي في مركز المساعدة الخاص بي؟
تساعد المستندات الجاهزة للذكاء الاصطناعي المساعدات الخارجية في تقديم إجابات من صفحاتك. كما يقوم روبوت الدردشة الخاص بمركز المساعدة، مثل Ask AI من Clevera، بالإجابة على استفسارات القراء داخل موقعك باستخدام نفس الصفحات. يعتمد كلاهما على مقالات واضحة ومحدثة.
