Codex: وكلاء Codex الفرعيون
آخر تحديث: 2026-08-31
Subagents تتيح لـ Codex تفكيك المهام المعقدة وتفويضها إلى وكلاء متخصصين للتنفيذ المتوازي، مما يحسن الكفاءة بشكل كبير.
📋 المتطلبات المسبقة: فهم أوضاع سير عمل Codex و Agent Skills
1. ما ستتعلمه
- مفاهيم Subagents ومبادئ عملها
- استراتيجيات تفويض المهام
- التنفيذ المتوازي والتنسيق
- مقارنة بين Subagent والوكيل الواحد
2. ما هم Subagents
Subagents هم وكلاء مساعدون ينشئهم وكيل Codex الرئيسي، كل مسؤول عن مهمة فرعية.
graph TB
A[Main Agent] --> B[Subagent 1: Frontend]
A --> C[Subagent 2: Backend]
A --> D[Subagent 3: Testing]
B --> B1[Modify UI Components]
C --> C1[Add API Endpoints]
D --> D1[Write Test Cases]
B1 --> E[Main Agent Aggregates]
C1 --> E
D1 --> E
| الميزة | الوصف |
|---|---|
| تنفيذ مستقل | كل subagent لديه sandbox خاص به |
| تنفيذ متوازٍ | وكلاء فرعيون متعددون يعملون في نفس الوقت |
| تنسيق تلقائي | الوكيل الرئيسي يجمع النتائج |
| تقسيم متخصص | كل subagent يمكنه استخدام Skill مختلف |
3. حالات الاستخدام
(1) تطوير متوازي متعدد الوحدات
TEXT
📖 للعرض فقط
> Add product review functionality to the e-commerce site:
> - Frontend: review component + review list + star ratings
> - Backend: review API + rating aggregation
> - Testing: frontend and backend tests
# Codex automatically decomposes into subagents:
# Subagent 1: Frontend component development
# Subagent 2: Backend API development
# Subagent 3: Test writing
# Three subagents execute in parallel
(2) ترجمة متعددة اللغات
TEXT
📖 للعرض فقط
> Translate README.md into Japanese, Portuguese, and Arabic
# Codex creates three subagents for parallel translation
# Subagent 1: en → ja
# Subagent 2: en → pt-br
# Subagent 3: en → ar
▶ مثال 1: تطوير متعدد الوحدات لأليس
TEXT
📖 للعرض فقط
# Alice adds a complete payment feature
> Add Stripe payments:
> 1. Payment page UI
> 2. Payment API endpoint
> 3. Webhook handling
> 4. Order management
> 5. Tests for all modules
# Codex decomposes into 4 subagents:
🔄 Subagent 1: Payment page UI + order management page
🔄 Subagent 2: Payment API + Webhook endpoint
🔄 Subagent 3: Order model + database migration
🔄 Subagent 4: Integration tests
# Parallel execution, total ~15 minutes
# Serial execution would take ~50 minutes
4. استراتيجية تفويض المهام
(1) شروط التوازي
| الشرط | الوصف |
|---|---|
| تعديل ملفات مختلفة | لا يتعامل الوكلاء الفرعيون على نفس الملف |
| لا تبعيات بيانات | لا يحتاج الوكلاء الفرعيون لمشاركة الحالة |
| قابل للتحقق بشكل مستقل | كل مهمة فرعية يمكن التحقق منها بشكل مستقل |
(2) متى لا توازي
| الموقف | الوصف |
|---|---|
| تعديل نفس الملف | قد يسبب تعارضات |
| تبعيات تسلسلية | الخطوات اللاحقة تحتاج نتائج السابقة |
| قاعدة بيانات مشتركة | قد يسبب ظروف سباق |
(3) مبادئ التفكيك
TEXT
📖 للعرض فقط
1. Decompose by functional module (frontend / backend / testing)
2. Decompose by file directory (src/auth/ / src/api/ / src/utils/)
3. Decompose by task type (implementation / testing / documentation)
4. Ensure clear boundaries for each subtask
5. تنسيق Subagents
(1) التنسيق التلقائي
يدير الوكيل الرئيسي دورة حياة الوكلاء الفرعيين تلقائيًا:
TEXT
📖 للعرض فقط
1. Analyze task, decompose into subtasks
2. Create subagent for each subtask
3. Assign independent sandbox environments
4. Monitor execution progress
5. Aggregate results, handle conflicts
6. Execute integration verification
(2) دمج النتائج
TEXT
📖 للعرض فقط
# After subagents complete, Main Agent merges results:
✅ Subagent 1: Frontend components done (3 files)
✅ Subagent 2: Backend API done (2 files)
✅ Subagent 3: Testing done (4 files)
# Main Agent runs integration tests
→ Running integration tests...
→ All 15 tests passed ✓
# Handle conflicts (if any)
→ No conflicts detected
→ Ready for review
6. مقارنة بين Subagents والوكيل الواحد
| البُعد | Subagents | وكيل واحد |
|---|---|---|
| سرعة التنفيذ | سريع (متوازي) | بطيء (تسلسلي) |
| استهلاك الموارد | عالي (sandbox متعددة) | منخفض (sandbox واحدة) |
| تعقيد التنسيق | عالي | منخفض |
| مخاطر التعارض | موجودة | معدومة |
| الأفضل لـ | مهام فرعية مستقلة | مهام ذات تبعيات |
❓ أسئلة شائعة
س هل يُنشأ الوكلاء الفرعيون تلقائيًا؟
ج في نسخ App/Web، ينشئ Codex الوكلاء الفرعيين تلقائيًا بناءً على تعقيد المهمة. في CLI، تحتاج للتحديد صراحةً أو التشغيل عبر Skills.
س هل هناك حد لعدد الوكلاء الفرعيين؟
ج يعتمد على خطة اشتراكك. مجاني: حد أقصى 1، Plus: حد أقصى 3، Pro: حد أقصى 10، Business: حد أقصى 20.
س كيف يتواصل الوكلاء الفرعيون مع بعضهم؟
ج ينسق الوكلاء الفرعيون عبر الوكيل الرئيسي، وليس مباشرة. يجمع الوكيل الرئيسي النتائج ويقرر الخطوات التالية.
س هل يؤثر فشل وكيل فرعي على الآخرين؟
ج لا. كل وكيل فرعي يعمل بشكل مستقل. الفشل الفردي لا يؤثر على الآخرين. يتعامل الوكيل الرئيسي مع المهام الفرعية الفاشلة.
س كيف أنشئ وكلاء فرعيين يدويًا؟
ج فكّك المهمة صراحةً في الـ Prompt، وسيتعرف Codex عليها وينشئ الوكلاء الفرعيين. يمكنك أيضًا استخدام Skills لتعريف سير عمل الوكلاء الفرعيين.
📖 ملخص
- Subagents هم وكلاء مساعدون ينشئهم الوكيل الرئيسي، يعملون بشكل مستقل
- حالات الاستخدام: توازي متعدد الوحدات، ترجمة متعددة اللغات، معالجة دفعية
- مبادئ التفكيك: حسب الوحدة/الدليل/النوع، ضمان حدود واضحة
- الوكيل الرئيسي ينسق تلقائيًا، يجمع النتائج، يعالج التعارضات
- التوازي يسرّع لكن يزيد استهلاك الموارد ومخاطر التعارض
📝 تمارين
- أساسي (⭐): اجعل Codex يفكك مهمة متوسطة التعقيد تلقائيًا إلى وكلاء فرعيين للتنفيذ.
- متوسط (⭐⭐): صمم ميزة متعددة الوحدات مع ضمان إمكانية تطوير كل وحدة بالتوازي، لاحظ تنفيذ الوكلاء الفرعيين.
- متقدم (⭐⭐⭐): قارن نفس المهمة باستخدام تنفيذ تسلسلي بوكيل واحد مقابل تنفيذ متوازي بوكلاء فرعيين، اكتب تقرير أداء.