7 لبنات أساسية لتصميم وكلاء الذكاء الاصطناعي من وثائق Opencode

Opencode في طريقه ليصبح ثاني أكثر أدوات البرمجة بالذكاء الاصطناعي إثارةً للنقاش بعد Claude Code. في كوريا، تسارع انتشاره بفضل Oh-my-opencode، ومجتمعات المطورين حول العالم تتابع باهتمام.

لكن القيمة الحقيقية لـ Opencode تتجاوز المساعدة في البرمجة. لأنه مفتوح المصدر، يمكنك فحص تصميم الوكيل بالتفصيل - من تسجيل الأدوات إلى تنسيق الوكلاء الفرعيين. المشاريع مفتوحة المصدر تستفيد من مساهمات المطورين في المجتمع، مما يعني أن الوثائق تعكس أحدث الأفكار في هندسة الوكلاء.

قسم Configure في وثائق Opencode يُقرأ وكأنه كتاب تمهيدي لتصميم الوكلاء. إليك اللبنات السبع الأساسية التي يكشفها، ولماذا كلٌّ منها مهم.

الأدوات (Tools): كيف يتفاعل الوكلاء مع العالم

الأدوات تحدد ما يستطيع الوكيل فعله. كل أداة هي قدرة منفصلة - قراءة ملف، كتابة ملف، تنفيذ أمر في الطرفية، البحث على الويب - مسجّلة كدالة قابلة للاستدعاء.

• مجموعة الأدوات التي تقدمها تحدد حدود قدرات الوكيل
• الأدوات هي الواجهة بين نموذج اللغة والبيئة الخارجية
• من تجربتي، إعطاء الوكيل أدوات كثيرة يأتي بنتائج عكسية: يقضي وقتاً أكبر في اختيار الأداة المناسبة بدلاً من التنفيذ الفعلي

مبدأ التصميم واضح: وكيل بدون أدوات هو مجرد روبوت محادثة. وكيل بالأدوات المناسبة يصبح عاملاً مستقلاً.

القواعد (AGENTS.md): المبادئ التوجيهية لسلوك الوكيل

AGENTS.md هو صيغة ملف توفر للوكيل السياق والقيود الخاصة بالمشروع. فكّر فيه كملف README مكتوب للذكاء الاصطناعي بدلاً من البشر.

• يتضمن توجيهات مثل “لا تعدّل الكود بدون اختبارات” أو “اتبع هيكل المجلدات هذا”
• معيار AGENTS.md مُعتمد بالفعل في أكثر من 60,000 مشروع مفتوح المصدر
• القواعد تشكّل عملية اتخاذ القرار لدى الوكيل دون تغيير النموذج الأساسي

بدون قواعد، يطبّق الوكيل تدريبه العام على مشروعك المحدد. مع القواعد، يطبّق اتفاقيات مشروعك وقيوده وتفضيلاته. الفرق كبير.

الوكلاء الفرعيون (Sub-agents): فرّق تسُد

المهام المعقدة تستفيد من تقسيمها على عدة وكلاء متخصصين بدلاً من تكليف وكيل عام واحد بها.

• يمكنك تعريف وكلاء حسب الدور: Build وPlan وReview وDebug وغيرها
• الوكيل الرئيسي يضع الخطة؛ والوكلاء الفرعيون ينفّذون الخطوات المنفردة
• كل وكيل فرعي يعمل بسياق مركّز، مما يقلل الضوضاء والانحراف الذي يصيب الجلسات الطويلة بوكيل واحد

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

بروتوكول سياق النموذج (MCP): معيار للاتصالات الخارجية

Model Context Protocol هو بروتوكول مفتوح أنشأته Anthropic يوحّد طريقة اتصال الوكلاء بمصادر البيانات والخدمات الخارجية.

• يوفر واجهة متسقة لقواعد البيانات وأنظمة الملفات وواجهات برمجة التطبيقات وغيرها من التكاملات
• بدلاً من كتابة محوّلات مخصصة لكل خدمة، يمنح MCP الوكلاء طريقة موحّدة للوصول إلى الخارج
• من المتوقع نمو منظومة من تطبيقات الخدمات المبنية على طبقة MCP

MCP يحل مشكلة حقيقية في التوافقية. سابقاً، كل إطار عمل للوكلاء اخترع طريقته الخاصة للاتصال بالأدوات الخارجية. MCP يجعل هذه الاتصالات قابلة للنقل والتركيب.

بروتوكول خادم اللغة (LSP): الأساس لفهم الكود

Language Server Protocol صُمّم أصلاً لبيئات التطوير المتكاملة، لكنه أثبت أنه بنفس القيمة لوكلاء الذكاء الاصطناعي الذين يحتاجون للتنقل في قواعد الكود.

• LSP يوفر الانتقال إلى التعريف، وإيجاد المراجع، والإكمال التلقائي، والتشخيصات
• في Opencode، تكامل LSP لا يزال تجريبياً، لكنه يحسّن دقة التنقل في الكود بشكل ملحوظ
• بدلاً من الاعتماد فقط على البحث النصي، يمكن للوكلاء استخدام LSP لفهم بنية الكود دلالياً

وكيل يستطيع تتبّع استدعاء دالة حتى تعريفها، وتتبّع جميع المراجع، وفهم التسلسلات الهرمية للأنواع - يعمل على مستوى مختلف جذرياً عن وكيل لا يفعل سوى مطابقة الأنماط في السلاسل النصية.

A2A وACP: معايير للتواصل بين الوكلاء

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

• A2A (Agent-to-Agent): أنشأته Google وتبرّعت به لمؤسسة Linux. يحدد كيف يكتشف الوكلاء بعضهم البعض، ويتفاوضون على القدرات، ويتبادلون الرسائل
• ACP (Agent Communication Protocol): بناه فريق BeeAI وانضم مؤخراً إلى مبادرة A2A

كلاهما في مراحل مبكرة، لكنهما يمثلان الأساس لأنظمة متعددة الوكلاء حيث تعمل وكلاء من موردين وأُطر عمل مختلفة معاً بسلاسة. التشبيه هو HTTP للويب - طبقة نقل مشتركة تجعل كل شيء قابلاً للتشغيل المتبادل.

المهارات (Skills): حزم قدرات قابلة لإعادة الاستخدام

Agent Skills تجمع الأدوات والقواعد والتعليمات في وحدة واحدة قابلة للتثبيت. هذه الصيغة التي قدّمتها Anthropic أولاً أصبحت الآن معيارية.

• يحمّل الوكيل مهارة عندما يحتاج قدرة محددة - كمراجعة الكود أو سير عمل TDD أو تحليل الأمان
• المهارات قابلة للمشاركة بين المشاريع والفرق، مما يخلق منظومة من سلوكيات الوكلاء القابلة لإعادة الاستخدام
• هذا يشير إلى تحوّل من استهلاك الوثائق إلى استهلاك المهارات: بدلاً من قراءة كيفية فعل شيء ما، تثبّت القدرة على فعله

المهارات بالنسبة للوكلاء كالحزم بالنسبة للتطبيقات. تجعل الخبرة وحدوية وقابلة للتوزيع.

الخلاصة

بناء وكلاء ذكاء اصطناعي فعّالين لا يتعلق بمعرفة كل أداة متاحة. يتعلق بفهم الهندسة المعمارية: كيف يفكر الوكلاء، وكيف يتصلون بالعالم الخارجي، وكيف يتعاونون مع بعضهم البعض.

هذه اللبنات السبع - الأدوات، القواعد، الوكلاء الفرعيون، MCP، LSP، A2A/ACP، والمهارات - تشكّل المفردات الهيكلية لتصميم الوكلاء. كلٌّ منها يعالج اهتماماً مستقلاً، ومعاً تحدد شكل نظام وكلاء مصمّم بإحكام.

لأن Opencode مفتوح المصدر، وثائقه تتطور مع مساهمات مجتمع المطورين. إذا كنت جاداً في فهم هندسة الوكلاء، فإن وثائق Opencode تستحق القراءة.