الدرس 22: تفويض الوكلاء الفرعيين

هذا جزء من سلسلة الدروس الرسمية لـ Hermes Agent. عرض جميع الدروس

تخيّل أنك قائد فريق في مشروع ما. يمكنك أن تفعل كل شيء بنفسك، لكن ذلك بطيء. بدلاً من ذلك، توزّع مهام محددة على زملائك في الفريق، وتعطيهم التفاصيل التي يحتاجونها، وتنتظر حتى يعودوا إليك بالنتائج. هذا بالضبط ما يفعله تفويض الوكلاء الفرعيين (Subagent Delegation) في Hermes Agent — فهو يتيح لوكلتك الرئيسي تعيين “عمّال” مؤقتين للتعامل مع المهام في الخلفية.

---

الخطوة 1: افهم الفكرة الأساسية

عندما تستدعي delegate_task، يقوم Hermes بإنشاء وكيل فرعي واحد أو أكثر (subagents). كل وكيل فرعي:

• يحصل على محادثة جديدة تماماً — لا يعرف شيئاً عن سجل محادثاتك.
• لديه access إلى نفس الأدوات التي يمتلكها الوكيل الأصلي.
• يعمل في جلسة طرفية (terminal) معزولة خاصة به.
• يعيد فقط ملخصاً نهائياً إلى الوكيل الأصلي.

اعتبرها مثل إرسال زميل للبحث في موضوع ما. هو لا يجلس معك طوال اجتماعك — فقط تعطيه ملاحظة فيها المهمة والسياق، ويعود إليك بتقرير.

---

الخطوة 2: تفويض مهمة واحدة

أبسط حالة استخدام: مهمة واحدة، وكيل فرعي واحد.

delegate_task(
    goal="Debug why tests fail",
    context="Error: assertion in test_foo.py line 42"
)

الحقل goal يخبر الوكيل الفرعي ماذا يفعل. الحقل context يعطيه كل ما يحتاجه للقيام بذلك.

---

الخطوة 3: تفويض مهام متعددة بالتوازي

تحتاج إنجاز عدة أشياء في نفس الوقت؟ مرّر قائمة من المهام. بشكل افتراضي، يشغّل Hermes حتى 3 وكلاء فرعيين في وقت واحد (يمكنك تغيير هذا — لا يوجد حد أقصى صارم).

delegate_task(tasks=[
    {"goal": "Research topic A", "context": "Focus on recent primary sources"},
    {"goal": "Research topic B", "context": "Compare the leading explanations"},
    {"goal": "Fix the build", "context": "Project root: /home/user/project"}
])

كل وكيل فرعي يعمل بشكل مستقل. الوكيل الأصلي ينتظر حتى ينتهي جميعهم، ثم يدمج النتائج.

---

الخطوة 4: القاعدة الذهبية — الوكلاء الفرعيون لا يعرفون شيئاً

هذه هي النقطة الأهم، لذا انتبه جيداً:

الوكلاء الفرعيون يبدأون بمعرفة صفرية عن محادثتك.

إذا قلت “أصلح الخطأ” دون أن توضح ما هو “الخطأ”، فسيضيع الوكيل الفرعي. يجب عليك تمرير كل السياق اللازم في حقلي goal و context.

إليك مثال سيء:

# BAD - subagent has no idea what "the error" is
delegate_task(goal="Fix the error")

والنسخة الجيدة:

# GOOD - subagent has all context it needs
delegate_task(
    goal="Fix the TypeError in api/handlers.py",
    context="""The file api/handlers.py has a TypeError on line 47:
    'NoneType' object has no attribute 'get'.
    The function process_request() receives a dict from parse_body(),
    but parse_body() returns None when Content-Type is missing.
    The project is at /home/user/myproject and uses Python 3.11."""
)

اعتبر context بمثابة وثيقة إحاطة. كلما كنت أكثر تحديداً، كان عمل الوكيل الفرعي أفضل.

---

الخطوة 5: استخدمه في سير عمل واقعي

بحث متوازٍ

اجمع المعلومات حول مواضيع متعددة في وقت واحد:

delegate_task(tasks=[
    {
        "goal": "Research the current state of WebAssembly in 2025",
        "context": "Focus on: browser support, non-browser runtimes, language support"
    },
    {
        "goal": "Research the current state of RISC-V adoption in 2025",
        "context": "Focus on: server chips, embedded systems, software ecosystem"
    },
    {
        "goal": "Research quantum computing progress in 2025",
        "context": "Focus on: error correction breakthroughs, practical applications, key players"
    }
])

مراجعة الكود + إصلاحه

فوّض مهمة مراجعة وإصلاح كاملة إلى سياق جديد تماماً:

delegate_task(
    goal="Review the authentication module for security issues and fix any found",
    context="""Project at /home/user/webapp.
    Auth module files: src/auth/login.py, src/auth/jwt.py, src/auth/middleware.py.
    The project uses Flask, PyJWT, and bcrypt.
    Focus on: SQL injection, JWT validation, password handling, session management.
    Fix any issues found and run the test suite (pytest tests/auth/)."""
)

---

الخلاصة

تفويض الوكلاء الفرعيين هو طريقتك لتوزيع العمل بالتوازي في Hermes Agent. تذكر هذه النقاط الرئيسية:

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

الأمر وكأن لديك فريقاً من المساعدين الذين لا يعرفون سوى ما تخبرهم به — لذا أخبرهم بكل ما يحتاجونه.

---

التالي: الدرس 23 — كانبان: لوحة مشتركة ودائمة للتعاون بين عدة وكلاء.