# الوكلاء الفرعيون (/ar/docs/verdent-manager/configuration/subagents)

> وكلاء متخصصون يمكن للوكيل الرئيسي استدعاؤهم عند الحاجة



الوكيل الفرعي هو "خبير" متخصص يمكن للوكيل الرئيسي (Worker) استدعاؤه في أي وقت خلال تنفيذ المهمة. يمتلك كل وكيل فرعي خبرته الخاصة، وموجّهًا (prompt) مخصصًا، ويمكن أن يعمل حتى على نموذج مختلف. في المحادثة، اكتب فقط `@SubagentName` وسينضم للمساعدة—تمامًا كما تُشير إلى زميل في محادثة جماعية.

***

## الوكلاء الفرعيون المدمجون [#الوكلاء-الفرعيون-المدمجون]

يأتي Verdent مزودًا بـ 6 وكلاء فرعيين جاهزين، تغطي أكثر الاحتياجات شيوعًا في تطوير البرمجيات:

| الاسم                   | النموذج الافتراضي                 | ما يتميز به                                                                                             |
| ----------------------- | --------------------------------- | ------------------------------------------------------------------------------------------------------- |
| **General**             | يتبع الوكيل الرئيسي               | وكيل بحث عام للمشكلات المعقدة، والبحث في الكود، والمهام متعددة الخطوات—يمكنه المساعدة في أي شيء تقريبًا |
| **Fast Context**        | Gemini 3 Flash                    | تحديد موقع الكود وجمع الأدلة السياقية بسرعة؛ متخصص في فهرسة قاعدة الكود وسريع للغاية                    |
| **Verifier**            | Sonnet 4.6                        | مراجعة سريعة للكود—بعد إجراء تغييراتك، أشِر إليه لاكتشاف المشكلات الواضحة                               |
| **مساعد Verdent**       | Haiku 4.5                         | مساعد استخدام Verdent؛ اسأله أي شيء عن طريقة عمل Verdent                                                |
| **Multi-Model Planner** | Gemini 3.1 Pro؛ Opus 4.6؛ GPT-5.4 | يُنشئ خططًا باستخدام نماذج متعددة (Claude، GPT، Gemini) ويدمج نتائجها                                   |
| **Reviewer**            | Gemini 3.1 Pro؛ Opus 4.6؛ GPT-5.4 | مراجعة كود كاملة: أخطاء منطقية، حالات حدّية، مخاطر خفية                                                 |

<Note>
  هناك وكيلان فرعيان مميزان: **Multi-Model Planner** و **Reviewer** يشغّلان 2-3 نماذج بالتوازي. يفكّر كل نموذج بشكل مستقل، ويُنتج مخرجاته الخاصة، ثم تُدمج النتائج معًا. جميع الوكلاء الفرعيين الآخرين يعتمدون على نموذج واحد.
</Note>

***

## كيفية استخدام الوكلاء الفرعيين [#كيفية-استخدام-الوكلاء-الفرعيين]

في أي محادثة، اكتب `@` لفتح قائمة اختيار الوكيل الفرعي (مع دعم البحث التقريبي). حدد الوكيل الفرعي الذي تريده وسيتولى السياق الحالي.

**أمثلة:**

* بعد كتابة منطق مصادقة معقد: `@Reviewer please review this` → يفحصه Reviewer من زوايا الأمان والمنطق والحالات الحدّية.
* لقرار معماري صعب: `@Multi-Model Planner` → تقترح نماذج متعددة حلولًا وتختار الأفضل بينها.
* بعد كتابة الكود، شغّل بسرعة `@Verifier` → أسرع من تشغيل مجموعات الاختبار الكاملة للتحقق الأساسي.

***

## الوكلاء الفرعيون المخصصون [#الوكلاء-الفرعيون-المخصصون]

يغطي الوكلاء الفرعيون المدمجون معظم الاحتياجات، ولكن أحيانًا تحتاج إلى خبير مصمم خصيصًا لمشروعك. يمكنك إنشاء وكلاء خاصين بك.

### أين يتم تخزينها [#أين-يتم-تخزينها]

يتم تخزين الوكلاء الفرعيين المخصصين كملفات Markdown في:

```
~/.verdent/subagents/
```

يُدعم تنظيمها في مجلدات فرعية بعمق يصل إلى 5 مستويات.

### تنسيق الملف [#تنسيق-الملف]

كل وكيل فرعي هو ملف Markdown مع بيانات تعريفية (frontmatter) بصيغة YAML:

```markdown
---
name: SQL-Expert
description: Specializes in SQL optimization and database design, good at analyzing slow queries and indexing strategies
color: blue
model: claude-sonnet-4-6
---

You are a senior database expert focused on PostgreSQL performance optimization.
When users provide SQL queries, you should:
1. Analyze the query execution plan
2. Identify performance bottlenecks (full table scans, missing indexes, etc.)
3. Provide concrete optimization suggestions and rewritten SQL
...
```

### تفاصيل رئيسية [#تفاصيل-رئيسية]

* **الاسم:** يجب أن يتضمن فقط أحرفًا وأرقامًا وشرطات (مثل `SQL-Expert`، `MyAgent123`). لا مسافات ولا أحرف غير ASCII.
* **اللون:** أحد `dark-green`، `light-green`، `red-orange`، `amber`، `cyan`، `blue`، `pink`، `purple`، `verdent`—لتسهيل التمييز البصري.
* **إعادة التحميل الفوري:** حفظ ملف `.md` يصبح فعالًا فورًا—بلا حاجة لإعادة تشغيل Verdent.

***

## إدارة الوكلاء الفرعيين في الإعدادات [#إدارة-الوكلاء-الفرعيين-في-الإعدادات]

تتم كل إدارة الوكلاء الفرعيين ضمن **الإعدادات ← الوكلاء الفرعيون**.

| الإجراء           | الوصف                                                                                                                                             |
| ----------------- | ------------------------------------------------------------------------------------------------------------------------------------------------- |
| **عرض القائمة**   | تُعرض جميع الوكلاء الفرعيين كبطاقات. الوكلاء المدمجون موسومون بـ "مدمج"؛ الوكلاء المستندون إلى الإضافات (plugins) تظهر أسماء الإضافات الخاصة بهم. |
| **تفعيل / تعطيل** | بدّل تفعيل أو تعطيل كل وكيل فرعي دون التأثير على غيره.                                                                                            |
| **إنشاء جديد**    | حدد &#x2A;*إضافة وكيل فرعي (Add Subagent)** واملأ المُعرّف (اسم فريد)، النموذج، الوصف، والموجّه (Prompt).                                         |
| **تعديل**         | مرّر المؤشر فوق البطاقة للتعديل. الوكلاء المدمجون يسمحون فقط بتغيير النموذج والوصف.                                                               |
| **تكرار**         | نسخ أي وكيل فرعي مخصص (النسخ المكررة تكون معطّلة افتراضيًا حتى يتم تفعيلها).                                                                      |
| **حذف**           | يمكن إزالة الوكلاء الفرعيين المخصصين (مع طلب تأكيد). لا يمكن حذف الوكلاء المدمجين.                                                                |

### اختلافات اختيار النموذج [#اختلافات-اختيار-النموذج]

* **Multi-Model Planner** و **Reviewer** يدعمان اختيار نماذج متعددة (2-3 في المرة الواحدة).
* الوكلاء الفرعيون الآخرون يستخدمون اختيار نموذج واحد.
* **General** يمتلك خيارًا خاصًا: يمكنه اتباع نموذج الوكيل الرئيسي تلقائيًا، مما يجنّبك صيانة تهيئة منفصلة.

***

## حالات الاستخدام [#حالات-الاستخدام]

### مراجعة الكود [#مراجعة-الكود]

بعد تنفيذ منطق معقد، أشِر إلى `@Reviewer`. يفحص الصحة والحالات الحدّية والأخطاء المحتملة—فيوفر عليك الفحص اليدوي سطرًا بسطر.

### تصميم معماري متعدد المنظورات [#تصميم-معماري-متعدد-المنظورات]

للقرارات الكبرى (مثل تبني الخدمات الصغيرة، أو اختيار قاعدة البيانات)، استخدم `@Multi-Model Planner` للحصول على مقترحات مستقلة من عدة نماذج متقدمة وتقليل مخاطر القرار.

### التحقق السريع [#التحقق-السريع]

بعد تغييرات الكود، `@Verifier` يفحص بسرعة القواعد النحوية، والأنواع، والمشكلات الأساسية—أسرع من مجموعات الاختبار الكاملة، وأكثر موثوقية من عدم إجراء أي فحص.

### خبراء مجال مخصصون [#خبراء-مجال-مخصصون]

أنشئ وكلاء فرعيين مصمّمين لمشروعك:

* خبير تحسين SQL على دراية بمخطط قاعدة بياناتك وأنماط استعلاماتك
* حارس معايير كود الواجهة الأمامية يطبّق قواعد ESLint ونظام التصميم الخاصين بك
* مساعد وثائق يُحوّل المحتوى التقني إلى كتابة واضحة وسهلة القراءة للقارئ

***

## ملاحظات [#ملاحظات]

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