بث مباشر 18.11 · الدفعة 318 نوفمبر، 19:00 بتوقيت موسكو — ورشة عملية مجانية لوكلاء الذكاء الاصطناعي · الدفعة 3 تبدأ 23.11ورشة 18 نوفمبر ←الدفعة 3 (23.11)
إصدارAPI / منتج · جاهز للعملHabr AI→ المصدر

«Куб три» منحت وكيل الذكاء الاصطناعي ذاكرة للمشروع: مراجعة أسهل، لكن النموذج أغلى بنحو الثلث

يبدأ الوكيل عمله كل يوم كأنه يفعل ذلك للمرة الأولى. كتب Claude نقطة نهاية (endpoint)، لكنه كرّر نظام تفويض جاهزًا. يبني فريق «Куб три» منذ عام ونصف منصة AI Council، وهي ذاكرة للمشروع مكوّنة من رسم بياني للشيفرة والقرارات والقواعد. بفضل هذه الذاكرة تمر الشيفرة في المراجعة بسهولة أكبر، لكن تشغيل النموذج يكلّف أكثر بما يقارب الثلث. الخلاصة: على الفريق أن يزوّد الوكيل بالمعرفة بنفسه.

معالج بواسطة الذكاء الاصطناعي من Habr AI؛ بتحرير Hamidun News
«Куб три» منحت وكيل الذكاء الاصطناعي ذاكرة للمشروع: مراجعة أسهل، لكن النموذج أغلى بنحو الثلث
المصدر: Habr AI. كولاج: Hamidun News.
استمع للمقال
بطاقة الحقائق والأرقام
المعيارالتفاصيل
المصدر الأصليHabr AI ↗
رئيس التحرير
حقيقة رئيسية #1لم يتحقق الوكيل من القواعد من تلقاء نفسه إلا في 16% من 12 ألف جلسة عمل
حقيقة رئيسية #2قبل أول تعديل على الشيفرة، طُلبت القواعد في 13% من الجلسات التي تضمنت تعديلات
حقيقة رئيسية #3يُربط سجل المعرفة بملف، ويصل إلى السياق عند فتح هذا الملف

الوكيل الذكي الذي يكتب الشيفرة يبدأ كل صباح من صفحة بيضاء: لا يتذكر محادثة الأمس، ولا أثر في الشيفرة لقرارات اتخذها الفريق قبل ستة أشهر. في بداية 2025 طلب مطورو استوديو «Куб три» من Claude إضافة نقطة نهاية API (endpoint) إلى المشروع. جاءت الشيفرة سريعة ومرتبة، لكن المراجعة (مراجعة الشيفرة على يد الزملاء قبل دمجها في المشروع) كشفت ثلاث مشكلات: كان منطق العمل موجودًا في المتحكم (controller) مع أن المشروع لا يعتمد ذلك، وكُتبت دالة التفويض من جديد مع أن دالة مماثلة موجودة أصلًا، وسُمّيت الدالة getUser بدلًا من الاسم المعتمد get_user.

وفي اليوم التالي تكرر الأمر نفسه في مهمة أخرى. على مدى عام ونصف بنى الفريق للوكيل «ذاكرة للمشروع»، هي منصة AI Council. وفي مقارنة مباشرة، كتب الوكيل المزوّد بها شيفرة أسهل في القبول عند المراجعة، لكن تشغيل النموذج كلّف أكثر بما يقارب الثلث، وهذه هي نسبة الزيادة في نفقات الاستعلامات الموجهة إلى الذكاء الاصطناعي.

إذا كنتم تدخلون الوكلاء في التطوير الجماعي، فستدلّكم هذه المقارنة على مواضع الفائدة وعلى ما سيتعين عليكم دفع ثمنه.

ما الذي لا يعرفه الوكيل

حلّل الفريق ملاحظات المراجعة في مشاريعه وحدّد ثلاثة أنواع من الفجوات. الأول هو البنية: ما الوحدات الموجودة، ومن يستدعي من، وأين توجد الدالة المطلوبة. يمكن استخراج البنية من الشيفرة بمحلّل (parser) أو بالبحث، مع أن الوكيل نفسه ينجز ذلك ببطء وبكلفة عالية. الثاني هو القرارات: لماذا تمر المدفوعات عبر طابور، وأي خيار رُفض سابقًا. لا يبقى في الشيفرة سوى النتيجة، أما الأسباب فتبقى في المحادثات وطلبات الدمج (merge request) المغلقة وفي رؤوس الناس. الثالث هو قواعد الفريق: الطبقات والتسمية والمحظورات. لا يتحقق linter إلا من جزء ضئيل منها، وبعد كتابة الشيفرة.

اجتمع في قصة نقطة النهاية نوعان من الأنواع الثلاثة. كتب الوكيل نسخة ثانية من التفويض لأنه لم يعرف البنية، أما المنطق في المتحكم والاسم getUser فظهرا لأنه لم يعرف القواعد.

ويضاف إلى ذلك عامل الزمن. التوثيق الذي تخلّف عن الشيفرة ضارّ، لأن الوكيل يصدّقه. وإذا عمل خمسة وكلاء في خمسة فروع، فلا ينبغي أن يؤثر قرار اتُّخذ في فرع على الفروع الأخرى ما دام الفرع لم يُدمج في main.

تغطي الأدوات المجانية جزءًا من هذه المهام. يقدّم الملفان CLAUDE.md وAGENTS.md القواعد على شكل نصيحة، ويتقادمان من دون أن يلاحظ أحد. أما Serena وclaude-context وCodeGraph وTeaRAGs فتعرف بنية الشيفرة، لكنها لا تعرف القرارات ولا القواعد. وتحفظ خوادم الذاكرة (Memory) ملاحظات لا ترتبط بالشيفرة. أما أدوات المراجعة بالذكاء الاصطناعي (CodeRabbit وGreptile وQodo) فتدخل على الخط بعد أن تكون الشيفرة قد كُتبت. ولمشروع صغير يعمل عليه مطوّر أو اثنان، ينصح المؤلفون بالاكتفاء بـ CLAUDE.md مع Serena أو claude-context.

كيف صُمّمت AI Council

تتكوّن المنصة من ثلاث طبقات مترابطة. يبني التحليل الساكن الرسم البياني للشيفرة دون مشاركة النموذج. ويتولى البحث المتجهي (vector search) البحث بحسب المعنى. وتحتفظ طبقة منفصلة بما لا يمكن استنتاجه من الشيفرة، أي سجلات المعرفة والقواعد. يشرح السجل كيف صُمّم أمر ما ولماذا، ويرتبط بفئات أو وحدات أو ملفات. أما القاعدة فلها قوة MUST (إلزامي) أو SHOULD (مستحسن) ونطاق سريان. يأخذ الوكيل السجل علمًا، لكنه ملزم بتنفيذ القاعدة.

أكثر الملاحظات عملية تخص طريقة التسليم. فقد فحص الفريق 12 ألف جلسة عمل: لم يشغّل الوكيل من تلقاء نفسه أداة MCP للتحقق من القواعد إلا في 16% منها، وقبل أول تعديل على الشيفرة في 13% من الجلسات التي تضمنت تعديلات. أي أنه في نحو 87% من هذه الجلسات شرع في العمل على الشيفرة دون أن يسأل عن القواعد. لذلك جعل الفريق خطافات (hooks) Claude Code القناة الأساسية، وهي معالجات تعمل في لحظات محددة ولا يستطيع النموذج تجاوزها. عند البدء تصل قواعد المشروع، وعند فتح ملف تصل القواعد والسجلات المرتبطة به، وفي نهاية الرد تصل قائمة فحوصات. وبقي MCP مسارًا احتياطيًا للوكلاء الذين لا تتوفر لديهم الخطافات.

مثال من مشروع لأحد العملاء: كان في نظام CRM مطلوب دمج جهات اتصال «مجهولة» من الرسائل الواردة مع جهات معروفة. لكن الدمج (merge) القياسي كان يمسح الحقول. أمضى المطوّر يومًا كاملًا حتى وجد الحل (نقل الروابط إلى جهة الاتصال المعروفة وحذف المجهولة)، ثم ربط السجل بنموذج جهة الاتصال. وعندما فتح الوكيل ملف النموذج في المرة التالية، وصل السجل إلى السياق تلقائيًا، ولم يضطر إلى ابتكار الدمج من جديد.

الكلفة والتحفظات

يستغرق انتقاء السياق لسؤال واحد من 9 إلى 18 ألف حرف، أي بضعة آلاف من الرموز (tokens)، وهو ما يعادل تقريبًا ملفًا واحدًا من 300–500 سطر. كما حلّل النموذج سجلات تذاكر Keycloak، وقد تجمّع منها أكثر من 3000 سجل، فدفع الفريق من عمل النموذج بدلًا من وقت البشر. ومن هنا جاء ارتفاع الكلفة بما يقارب الثلث.

التحفظات واضحة. المنتج تجاري، وجمع الفريق الأرقام بنفسه على بيئة الإنتاج لديه، ولم يجرِ ذلك قياس مستقل. ويجب اختيار روابط السجلات بعناية: فالرابط العام جدًا يُهمَل (في المثال تطابق الاسم مع 357 كيانًا). والتلميح المبني على كلمات الوكيل يصمت إذا سمّى الوكيل الشيء بكلمات أخرى.

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

القصة

أسئلة وأجوبة حول الخبر

ما أبرز التفاصيل حول ما الذي لا يعرفه الوكيل؟

حلّل الفريق ملاحظات المراجعة في مشاريعه وحدّد ثلاثة أنواع من الفجوات. الأول هو البنية: ما الوحدات الموجودة، ومن يستدعي من، وأين توجد الدالة المطلوبة. يمكن استخراج البنية من الشيفرة بمحلّل (parser) أو بالبحث، مع أن الوكيل نفسه ينجز ذلك ببطء وبكلفة عالية. الثاني هو القرارات: لماذا تمر المدفوعات عبر طابور، وأي خيار رُفض سابقًا. لا يبقى في الشيفرة سوى النتيجة، أما الأسباب فتبقى في المحادثات وطلبات الدمج (merge request) المغلقة وفي رؤوس الناس. الثالث هو قواعد الفريق: الطبقات والتسمية والمحظورات.

ما أبرز التفاصيل حول كيف صُمّمت AI Council؟

تتكوّن المنصة من ثلاث طبقات مترابطة. يبني التحليل الساكن الرسم البياني للشيفرة دون مشاركة النموذج. ويتولى البحث المتجهي (vector search) البحث بحسب المعنى. وتحتفظ طبقة منفصلة بما لا يمكن استنتاجه من الشيفرة، أي سجلات المعرفة والقواعد. يشرح السجل كيف صُمّم أمر ما ولماذا، ويرتبط بفئات أو وحدات أو ملفات. أما القاعدة فلها قوة MUST (إلزامي) أو SHOULD (مستحسن) ونطاق سريان. يأخذ الوكيل السجل علمًا، لكنه ملزم بتنفيذ القاعدة. أكثر الملاحظات عملية تخص طريقة التسليم.

ما أبرز التفاصيل حول الكلفة والتحفظات؟

يستغرق انتقاء السياق لسؤال واحد من 9 إلى 18 ألف حرف، أي بضعة آلاف من الرموز (tokens)، وهو ما يعادل تقريبًا ملفًا واحدًا من 300–500 سطر. كما حلّل النموذج سجلات تذاكر Keycloak، وقد تجمّع منها أكثر من 3000 سجل، فدفع الفريق من عمل النموذج بدلًا من وقت البشر. ومن هنا جاء ارتفاع الكلفة بما يقارب الثلث. التحفظات واضحة. المنتج تجاري، وجمع الفريق الأرقام بنفسه على بيئة الإنتاج لديه، ولم يجرِ ذلك قياس مستقل. ويجب اختيار روابط السجلات بعناية: فالرابط العام جدًا يُهمَل (في المثال تطابق الاسم مع 357 كيانًا).

ZK
جمال حميدون — مدير المنتجات في Alpina Digital ومدير منتج AlpinaGPT. يبني منتجات الذكاء الاصطناعي منذ 2019. بدأ Hamidun News كمشروع شخصي ثم أصبح مُجمِّعًا إنتاجيًا بأكثر من 6000 قارئ.
✦ Unified AI Workspace · Nomad

Test Frontier LLMs & Autonomous Agents in One Workspace

Run Claude Opus 5.5, GPT-6, Gemini 3.1, and DeepSeek side-by-side in Nomad AI (nomadnet.ai) — unified model routing, deep research, and multimodal workflows under one subscription.

Try Nomad AI →Launch Nomad Agent
ما رأيك؟
جارٍ تحميل التعليقات…