BroadRouter
ابدأ الآن

الوكيل الفرعي (Subagent)

آخر تحديث

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

يُسمّى أيضًا: وكيل فرعي، الوكلاء الفرعيون، الوكيل الابن، subagent، sub-agent، child agent

الوكيل الفرعي هو التفويض في عالم الوكلاء: تسلّم مهمة واحدة إلى عامل جديد، ولا تستلم منه إلا الإجابة.

كيف يعمل

يقرر الوكيل الرئيسي أن مهمةً ما قائمة بذاتها، مثل «اعثر على كل من يستدعي هذه الدالة» أو «شغّل مجموعة الاختبارات وأبلغ عن الإخفاقات». فيشغّل وكيلًا فرعيًا بوصف للمهمة. ويدير الوكيل الفرعي حلقة الوكيل الخاصة به ويُرجع نتيجة.

يصوغ توثيق Claude Code الفكرة هكذا: “Each subagent runs in its own context window with a custom system prompt, specific tool access, and independent permissions.” (ترجمة: يعمل كل وكيل فرعي في نافذة سياق خاصة به، بأمر نظام مخصص، وصلاحيات محددة للأدوات، وأذونات مستقلة.) ويُعرَّف الوكيل الفرعي في ملف Markdown بترويسة YAML، على مستوى المشروع في .claude/agents/:

---
name: code-reviewer
description: Reviews code for quality and best practices
tools: Read, Glob, Grep
model: sonnet
---

You are a code reviewer. When invoked, analyze the code and provide
specific, actionable feedback on quality, security, and best practices.

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

ولأطر العمل الأخرى أفكار مشابهة. يقول OpenAI Agents SDK إن “Handoffs allow an agent to delegate tasks to another agent,” (ترجمة: يتيح التسليم لوكيل أن يفوّض المهام إلى وكيل آخر) ويعرض كل تسليم على النموذج في صورة أداة.

ويصف مقال Anthropic عن هندسة السياق النمط من زاوية السياق: يعمل كل وكيل فرعي في نافذة سياق نظيفة و”returns only a condensed, distilled summary of its work,” (ترجمة: لا يُرجع إلا ملخصًا مكثفًا ومقطّرًا لعمله)، وغالبًا ما يكون بين 1,000 و2,000 رمز.

لماذا يهم

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

في BroadNet Inference

تقدّم BroadNet النماذج؛ أما منطق الوكلاء الفرعيين فموجود في أداة الوكيل لديك. وأي أداة تقبل عنوان URL أساسيًا متوافقًا مع OpenAI يمكنها توجيه وكيلها الرئيسي ووكلائها الفرعيين إلى BroadNet، واستخدام نماذج مختلفة لكل منهم.

في الدفع حسب الاستخدام، يسمح المفتاح بـ 4 طلب قيد التنفيذ. وفي الخطط بسعر ثابت لنموذج DeepSeek V4.1 Flash، تشغّل كل جلسة طلبًا واحدًا في المرة، فاحسب طلبات النموذج التي قد تكون قيد التنفيذ في اللحظة نفسها: ثلاثة وكلاء فرعيين يعملون معًا يحتاجون إلى ثلاث جلسات، وأربع إذا كان المنسّق يستدعي النموذج أيضًا أثناء عملهم. ويشرح مقال تشغيل وكلاء برمجة متوازيين على API بسعر ثابت حساب الجلسات بالتفصيل.

أسئلة شائعة

هل يوفّر الوكيل الفرعي الرموز؟

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

هل يستطيع الوكيل الفرعي تشغيل وكلاء فرعيين خاصين به؟

يعتمد ذلك على الأداة. يقول توثيق Claude Code إن الوكيل الفرعي يستطيع افتراضيًا تشغيل وكلاء فرعيين خاصين به، حتى ثلاث طبقات تحت المحادثة الرئيسية، وإن هذا يمكن تقييده.

ما الفرق بين الوكيل الفرعي والتسليم (handoff)؟

الوكيل الفرعي يعمل على مهمة ثم يرفع تقريره إلى الوكيل الذي استدعاه. أما في OpenAI Agents SDK، فالتسليم يتيح لوكيل أن يفوّض العمل إلى وكيل آخر، والدالة المساعدة handoff() تنقل التحكم إلى ذلك الوكيل.

اقرأها بصيغة Markdownاسأل ChatGPTاسأل Claudeاسأل Perplexity