Drupal
بنية RAG في Drupal: ما الذي تبنيه وما الذي تديره عبر خدمة
حدّد أدوار Search API والتقسيم والتضمينات وقواعد المتجهات وLLM والاستشهادات وضوابط الوصول في Drupal، ثم قرر ما ستبنيه وما ستديره.
9 دقائق للقراءة

بنية RAG في Drupal أكبر من مجرد روبوت محادثة. فالحل الأصلي داخل Drupal يحتاج عادةً إلى استخراج المحتوى وتقسيمه وتوليد التضمينات والاسترجاع المتجهي وإعداد Search API ونموذج LLM والاستشهادات وفحوص الوصول ومهام التحديث والواجهة والتشغيل. تنقل الخدمة المُدارة للموقع العام عدة طبقات إلى خارج Drupal؛ وتعتمد الحدود الصحيحة على الوصول إلى البيانات وعلى الجهة التي تتحمل مسؤولية الأعطال.
Michael Shamanoff Founder, Achla AI لمن: لمالكي مواقع Drupal والمعماريين والمنفذين الذين يقيّمون البحث الدلالي أو الإجابات المدعومة بالمصادر. كيف أُعدت: استناداً إلى صفحات مشاريع Drupal الرسمية وملفات منتج Achla الحالية التي روجعت في 3 أغسطس 2026، مع مصفوفة أصلية للملكية وبطاقة لتقييم التجربة. استُخدم الذكاء الاصطناعي للمساعدة في الصياغة، وربطت الادعاءات الواقعية الجوهرية بمصادرها في السجل المرفق. لماذا: تسمي أدلة التثبيت المكونات، لكن متخذي القرار يحتاجون أيضاً إلى معرفة من يشغّل كل طبقة وكيف يمكن أن تفشل وما المتطلبات التي تستبعد مسار الزحف العام المُدار.
بنية RAG في Drupal، طبقةً تلو الأخرى
لدى RAG مساران. تحول الفهرسة المحتوى إلى سجلات قابلة للاسترجاع، وتحول معالجة الاستعلام السؤال إلى استرجاع وسياق وتوليد وأدلة يمكن فحصها.
مسار الفهرسة: من المحتوى إلى مقاطع قابلة للاسترجاع
- اختر كيانات Drupal وحقوله وأوضاع العرض التي تحتوي على مادة مصدر مفيدة.
- استخرج النص مع الاحتفاظ بالهوية واللغة وURL وبيانات الوصول وإشارات التحديث أو الحذف.
- قسّم المحتوى الطويل إلى مقاطع تحتفظ بسياق كافٍ ليظل معناها واضحاً.
- أنشئ التضمينات وخزّنها في نظام خلفي يدعم المتجهات.
- حدّث السجلات أو استبدلها أو احذفها عندما يتغير محتوى Drupal.
يدمج مشروع AI Search الرسمي التضمينات المتجهية مع Search API، ويوثق نظاماً خلفياً متجهياً وتقسيم المحتوى وحدود الدرجات وفحوص وصول الكيانات بعد الاستعلام والبحث الهجين وتكامل RAG. هذه لبنات بناء وليست نموذج تشغيل كاملاً.
مسار الاستعلام: من السؤال إلى إجابة موثقة
- حوّل السؤال أو وجّهه إلى طريقة الاسترجاع المختارة.
- استرجع المقاطع المرشحة وطبّق الحدود أو المرشحات أو منطق البحث الهجين.
- اجمع سياق LLM من دون فقدان هوية المصدر أو قيود الوصول.
- ولّد إجابة أو نتيجة فارغة صادقة.
- اعرض الاستشهادات وسجّل أدلة تكفي لتشخيص الاسترجاع بمعزل عن التوليد.
احتفظ بالمصادر المسترجعة والنص المولّد والاستشهادات الظاهرة للزائر كأنواع أدلة منفصلة: فقد يُلخص استرجاع ذو صلة بصورة سيئة، بينما قد يعتمد نص سلس على المصدر الخطأ.
ما الذي يفعله Search API — وما الذي لا يفعله وحده
Search API هو إطار البحث القابل للتوسعة في Drupal. يعرّف الفهارس ويعمل مع الأنظمة الخلفية والحقول والمعالجات وViews والمرشحات والأوجه. لكنه لا يختار وحده نموذج التضمين، ولا يشغّل كل نظام خلفي، ولا يجمع موجّه LLM، ولا يولّد الإجابة، ولا يصمم واجهة المحادثة، ولا يقيّم مدى استناد الإجابة إلى المصادر.
وتوضح صفحته الرسمية حداً أمنياً مهماً: لا يستطيع Search API توفير قيود وصول عامة لكل حالة استخدام. يظل مالكو الموقع مسؤولين عن ضمان فهرسة العناصر المتاحة وعرضها فقط، رغم توفر تعديل node-access وفحوص إضافية في أجزاء من المنظومة.
لا يلزم أن تتحول صفحة النتائج الدلالية إلى محادثة. قرر هل يحتاج الزوار إلى نتائج دلالية مرتبة، أم إجابة موثقة، أم محادثة، أم أكثر من واجهة.
يجب أن تؤثر حالة مشاريع Drupal الحالية في قرار المخاطر
تتغير تسميات الإصدارات والتغطية الأمنية؛ لذلك حدّث هذا الجدول قبل المراجعة البشرية ومرة أخرى قبل أي قرار تنفيذ. رُصدت المعلومات التالية في صفحات Drupal.org الرسمية في 3 أغسطس 2026.
| المشروع | حالة الإصدار المرصودة | حالة تغطية التنبيهات الأمنية |
|---|---|---|
| Search API | 8.x-1.41، إصدار مستقر لـ Drupal 10.3/11 | الإصدار المستقر مشمول بسياسة Drupal الأمنية. |
| AI Search | 2.0.0-alpha2 و1.3.0-alpha4؛ لا يوجد إصدار مستقر مدعوم | الإصدارات المستقرة مشمولة، لكن الإصدارات المتاحة حالياً alpha. |
| RAG Search | 1.0.5 بلا لاحقة alpha/beta | يذكر المشروع صراحةً أنه غير مشمول بالسياسة. |
| Drupal as RAG | 1.0.0-alpha5 | يذكر المشروع صراحةً أنه غير مشمول بالسياسة. |
| AI RAG Search Chat | 1.0.7 بلا لاحقة alpha/beta | يذكر المشروع صراحةً أنه غير مشمول بالسياسة. |
لا يحل رقم 1.0.x محل التغطية الأمنية. راجع النضج والصيانة وإصدارات Drupal واعتماديات مقدمي الخدمة وحالة السياسة الأمنية كلّاً على حدة.
مسار البناء الذاتي: المكونات التي يجب أن يمتلكها فريقك
يبقي البناء الأصلي داخل Drupal قدراً أكبر من التحكم قريباً منه، لكنه ينشئ مزيداً من المسؤوليات التشغيلية. يوضح مشروع RAG Search فهرس Search API متجهياً يغذي تجميع الموجّه وLLM، مع ذاكرات تخزين مؤقت دقيقة ودلالية اختيارية، وتحديد معدل الطلبات، وإعادة فحص الوصول قبل تقديم المقاطع المخزنة. ويظل استبعاده من السياسة الأمنية تحذيراً جوهرياً.
يعرض Drupal as RAG مساراً آخر يستخدم Drupal 11 وPostgreSQL مع pgvector وOllama على مضيف محلي أو شبكي. كان الإصدار المرصود alpha وخارج التغطية، لذا فهو مثال معماري وليس توصية.
| الطبقة | المهمة | مالك البناء الذاتي | مالك الخدمة المُدارة | إشارة الفشل | الحد الأدنى للاختبار | تنبيه البيانات/الوصول |
|---|---|---|---|---|---|---|
| الاستخراج | اختيار وعرض محتوى المصدر | فريق Drupal/المحتوى | مشغّل الزاحف | صفحات مفقودة أو مشوهة | مقارنة المصادر المفهرسة بقائمة معتمدة | يجب ألا تتسرب الحقول الخاصة إلى فهرس عام. |
| التقسيم والتضمينات | إنشاء تمثيلات قابلة للاسترجاع | مهندس الذكاء الاصطناعي/البحث | مشغّل الخدمة | ضعف الاستدعاء أو فقدان السياق | مجموعة بحث بالكلمات الدقيقة وإعادة الصياغة | قد تغير النماذج أو الجهات النتائج. |
| الاسترجاع المتجهي | إعادة المقاطع ذات الصلة | مالك البحث/النظام الخلفي | مشغّل الخدمة | مرشحون غير ملائمين أو فارغون | تسجيل المصادر والدرجات قبل التوليد | يجب أن تبقى المرشحات وبيانات الوصول. |
| الموجّه وLLM | إنتاج صياغة مقيدة | مالك تطبيق الذكاء الاصطناعي | مشغّل الخدمة | إجابة بلا دعم أو مفرطة الثقة | حالات معروفة وملتبسة وبلا إجابة | السياق المسترجع لا يضمن صحة الصياغة. |
| الواجهة والاستشهادات | عرض الإجابة والأدلة | فريق Drupal/الواجهة | مشغّل الودجت/الخدمة | روابط مكسورة أو مختلقة | فتح كل استشهاد واختبار لوحة المفاتيح/الهاتف | يجب أن يحدد الاستشهاد المصدر المسترجع فعلاً. |
| التحديث والحذف | إبقاء الفهرس متزامناً | مالك الطوابير/التشغيل | مشغّل الزحف/الفهرسة | استمرار محتوى قديم أو محذوف | تعديل صفحة اختبار وحذفها ومراقبة الفهرس | يحتاج إبطال الذاكرة والحذف إلى مسؤول واضح. |
تُشرح المفاضلة الأوسع في بحث الذكاء الاصطناعي للمؤسسات مقابل البناء الذاتي.
المسار المُدار: ما الطبقات التي تنتقل خارج Drupal
ينقل المسار المُدار للموقع العام الزحف والفهرسة والاسترجاع واستدعاءات النموذج وتسليم الإجابة وبعض المراقبة إلى مشغّل الخدمة. يوفر Drupal الصفحات العامة وبرنامجاً نصياً أو موصلاً. يقل حجم المنظومة داخله، لكن الخدمة تفقد المعرفة الأصلية بالحقول والمراجعات والأدوار وقرارات الوصول ما لم تُنفذ وتُتحقق صراحةً.
تصف ملفات Achla المفحوصة موصل Drupal 10/11 يُسلّم عبر Composer، ومصفوفة تحقق PHP 8.3، وتحديثات تلقائية وُصفت بأنها متاحة عند آخر مراجعة في 16 يوليو 2026. يزحف المسار المُدار إلى الموقع العام ويفهرسه ويعرض إجابات مرتبطة بالمصادر عبر ودجت يدعم أوضاع bubble وinline وattach.
Achla ليس نظاماً خلفياً لـ Search API. إنه مسار منفصل للزحف العام والودجت المُدارين. يجب ألا يُعرض كحل لمحتوى Drupal الخاص أو الموثّق، أو للاسترجاع المدرك للأدوار، أو أذونات مستوى الصف، أو إجراءات Drupal المعاملاتية. راجع الإعداد المُدار من دون مطور لفهم هذا الحد التشغيلي.
البناء أم الإدارة؟ استخدم المتطلبات لا الموضة
| المتطلب | فضّل نموذج Drupal أصلياً عندما… | فكّر في مسار مُدار للموقع العام عندما… |
|---|---|---|
| حدود المحتوى | يجب أن يعكس الاسترجاع الحقول والمراجعات والأدوار أو المحتوى الموثّق. | المصدر المعتمد عام عمداً وقابل للزحف. |
| الاستثمار الحالي | توجد فهارس Search API ومزودون وفريق تشغيل بالفعل. | لا يريد الفريق تشغيل التضمينات والتخزين المتجهي واستدعاءات LLM وواجهة الإجابة. |
| التحكم | يجب إبقاء اختيار المزود ومنطق الموجّه ومكان التخزين وضبط الاسترجاع داخلياً. | يُقبل عقد خدمة محدود وقيد المحتوى العام. |
| الواجهة | تعد Views والنماذج والأذونات أو مسارات Drupal المخصصة أساسية. | يكفي ودجت بإجابات موثقة أو تجربة بحث عام مرفقة. |
| ملكية الحوادث | يستطيع الفريق تشخيص الطوابير والوصول والاسترجاع والتوليد والذاكرة والواجهة. | يمتلك المشغّل هذه الطبقات ويكشف أدلة وحلاً احتياطياً مناسباً. |
أدخل البنية التحتية والتحديثات والمراجعة الأمنية ومفاتيح مقدمي الخدمة وقابلية الرصد وعمليات المحتوى والاستجابة للحوادث وإثبات عمل قيود الوصول، لا تكلفة الترخيص وحدها.
احمِ الوصول والاستشهادات وسلوك التحديث
المحتوى الخاص نقطة تفرع معمارية حاسمة. لا يحل إطار Search API العام كل القيود تلقائياً. يوثق AI Search فحوص وصول الكيان بعد الاستعلام؛ ويوثق RAG Search مفاتيح ذاكرة تعتمد على الدور وإعادة فحص وصول المصدر. وتظل هذه الآليات الخاصة بالوحدات بحاجة إلى اختبار بأدوار حقيقية ومحتوى غير منشور وأذونات متغيرة وإجابات مخزنة.
يبين مشروع AI RAG Search Chat أن سطح الإنتاج أوسع من الاسترجاع: فهو يضيف صفحات بحث ومحادثة وجلسات وأذونات وتحديداً للمعدل ومقدمي خدمات ومصادر مرتبطة. كان إصدار 1.0.7 المرصود خارج تغطية تنبيهات Drupal الأمنية.
في أي بنية، احتفظ بعناوين URL والمعرفات خلال التقسيم، وتحقق من أن كل استشهاد يدعم الإجابة، وحدد إخفاقاً صادقاً، واختبر انتقال التحديث والحذف. تسهل مراجعة الإجابة المرتبطة بمصادر، لكن الاسترجاع والاستشهادات لا يزيلان خطأ النموذج. استخدم هذا الدليل للحكم على موثوقية بحث الذكاء الاصطناعي.
استخدم بطاقة تقييم قابلة للتكرار للتجربة
ابنِ مجموعة التقييم من مهام حقيقية. عشرون إلى ثلاثين سؤالاً ممثلاً طريقة تخطيط، وليست معياراً أو حداً مضموناً.
- سجّل السؤال وصفحة المصدر المتوقعة وفئة المحتوى/الوصول ونتيجة «غير موجود» المقبولة.
- أدرج المصطلحات الدقيقة وإعادة الصياغة والصفحات المتعارضة والمحتوى القديم أو المحذوف وسؤالاً لا توجد إجابته.
- لاختبار محتوى خاص أصلي في Drupal، استخدم حسابات بأدوار مختلفة وافشل الاختبار عند كشف أي مصدر غير متاح.
- سجّل المصادر المسترجعة منفصلة عن الصياغة المولدة والاستشهادات الظاهرة للزائر.
- اختبر تحديث الفهرس بعد التعديل والحذف، ثم كرر بعد احتمال تدخل الذاكرات المؤقتة.
- أضف اختبارات لوحة المفاتيح والهاتف والانقطاع والنتيجة الفارغة والبديل للواجهة المختارة.
- صنّف كل فشل ضمن الإدخال أو الاسترجاع أو التوليد أو الاستشهاد/الواجهة أو الوصول أو التشغيل، وعيّن من يصلحه في كل بنية.
افشل التجربة عند كشف محتوى مقيّد أو اختلاق المصادر أو كسر روابط الاستشهاد أو عدم الإقرار بغياب الإجابة أو بقاء محتوى محذوف بعد نافذة التحديث الموثقة. لا تخترع درجة دقة عامة. توفر ورقة أدلة RAG مكاناً لفصل الادعاء والمصدر والسلوك المتوقع والنتيجة المرصودة.
أخطاء معمارية شائعة
- معاملة LLM كأنه الاسترجاع بدلاً من قياس الأدلة المسترجعة.
- فهرسة حقول أو محتوى خاص من دون حفظ قواعد الوصول واختبارها.
- إسقاط URL أو اللغة أو المراجعة أو هوية الكيان أثناء التقسيم.
- اختبار الإضافات دون التعديلات والحذف وإبطال الذاكرة والإخفاق الصادق.
- وصف إصدار بأنه «آمن» لأنه بلا لاحقة alpha مع تجاهل التغطية الأمنية.
- تسمية الزاحف العام نظاماً خلفياً لـ Search API أو تكاملاً للمحتوى الخاص.
- مقارنة سعر الترخيص مع إغفال البنية التحتية وملكية الحوادث.
خطوة عملية تالية لموقع Drupal عام
أنشئ نموذجاً ذاتياً عندما تكون حقول Drupal وأذوناته والتحكم في المزود وتشغيل Search API الحالي متطلبات مركزية. وقيّم بحثاً مُداراً للموقع العام عندما يكون المصدر عاماً عمداً ويريد الفريق أن يتولى مشغّل آخر طبقات خدمة RAG.
إذا كان المطلوب إجابات موثقة فوق صفحات ووثائق Drupal العامة من دون تشغيل منظومة RAG داخله، فقيّم إعداد Achla لـ Drupal. Achla ليس نظاماً خلفياً لـ Search API وليس مسار المحتوى الخاص المبين أعلاه.
أسئلة تطرحها فرق Drupal
هل أحتاج إلى Search API؟
نعم للمسار الأصلي المبني حول وحدات Search API. ويمكن لخدمة زحف عام مُدارة مستقلة استخدام فهرسها الخاص. هاتان بنيتان مختلفتان؛ ولا يحول الموصل أو الودجت الفهرس المُدار إلى نظام خلفي لـ Search API.
هل أحتاج دائماً إلى قاعدة بيانات متجهية؟
ليس لكل تجربة بحث. يمكن لبحث الكلمات المفتاحية أو الأوجه استخدام أنظمة أخرى. تستخدم وحدة AI Search أنظمة تدعم المتجهات للاسترجاع الدلالي، بينما قد تخفي الخدمة المُدارة بنيتها خلف حدودها.
هل يعمل البحث الدلالي من دون محادثة؟
نعم. يمكنه إرجاع نتائج مرتبة في واجهة بحث. أضف التوليد فقط عندما تخدم الإجابة المكتوبة المهمة، ويمكن حفظ المصادر ومعالجة الإخفاقات بصدق واختبار الصياغة بمعزل عن الاسترجاع.
ماذا عن المحتوى الخاص؟
ضع متطلبات التحكم في الوصول في القرار منذ البداية. قد يحفظ التصميم الأصلي أذونات Drupal إذا اختُبر مسار الفهرسة والاسترجاع والذاكرة والعرض كاملاً. يقتصر مسار Achla في هذه المقالة على المحتوى العام القابل للزحف.
كيف أقارن التجارب؟
استخدم مجموعة الأسئلة نفسها وتوقعات المصادر وحالات الوصول واختبارات التحديث وفحوص الاستشهاد وظروف الواجهة وفئات الفشل. قارن الأدلة والملكية، لا عرضاً اختاره المورد أو درجة عامة غير مدعومة.
الرسم التوضيحي المشترك
يوزع قرار بنية RAG مسؤوليات الاستخراج والاسترجاع والتوليد والاستشهادات والتشغيل بين جهات مختلفة.
*يوزع قرار بنية RAG مسؤوليات الاستخراج والاسترجاع والتوليد والاستشهادات والتشغيل بين جهات مختلفة.*


