# الميزات المتقدمة (/ar/docs/verdent-for-vscode/advanced-features/overview)

> ميزات معقدة وتنسيق متعدد الوكلاء



### ما ستتعلمه [#ما-ستتعلمه]

يغطي هذا القسم إمكانيات المستخدم المتقدم في Verdent، بما في ذلك إدارة الوكلاء الفرعيين، وأنظمة القواعد، وتكامل الأدوات المخصصة، وخيارات القابلية للتوسيع المتقدمة.

***

## شرح الميزات المعقدة [#شرح-الميزات-المعقدة]

يقدّم Verdent for VS Code ميزات متطورة تُمكّن سير عمل تطوير متقدم يتجاوز توليد الكود الأساسي.

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

**وكلاء ذكاء اصطناعي متخصصون:**
يتضمن Verdent وكلاء فرعيين مدمجين (`@Verifier`، `@Explorer`، `@Code-reviewer`) يعملون بنوافذ سياق منعزلة وتوجيهات نظام مخصصة. كل وكيل فرعي متخصص في مهام معينة مثل استكشاف الكود، أو التحقق، أو مراجعة الجودة.

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

**وكلاء فرعيون مخصصون:**
أنشئ وكلاء فرعيين خاصين بالمشروع من خلال تعريف ملفات Markdown مزودة بترويسة YAML في `~/.verdent/subagents/`. يمكن للوكلاء الفرعيين المخصصين التخصص في خبرة مجال معين، أو سير عمل الفريق، أو تحسينات خاصة بتقنية معينة.

[اطّلع على مزيد من المعلومات حول إدارة الوكلاء الفرعيين](/docs/verdent-for-vscode/agents-rules/subagent-management)

### أنظمة القواعد [#أنظمة-القواعد]

**تخصيص السلوك:**
توجّه ملفات القواعد سلوك Verdent وتنسيق المخرجات وعملية اتخاذ القرار من خلال مستندات Markdown نصية بسيطة. تتحكم ثلاثة أنواع من القواعد في نطاقات مختلفة:

* **VERDENT.md** - تفضيلات شخصية عامة عبر جميع المشاريع
* **AGENTS.md** - معايير الفريق الخاصة بالمشروع (تخضع للتحكم بالإصدارات)
* **plan\_rules.md** - تخصيص تنسيق مخرجات Plan Mode

**أسبقية القواعد:**
عند حدوث تعارض، تتفوّق قواعد المشروع (`AGENTS.md`) على قواعد المستخدم، مما يضمن اتساق الفريق مع الحفاظ على التفضيلات الشخصية للمشاريع الفردية.

[اطّلع على مزيد من المعلومات حول أنظمة القواعد](/docs/verdent-for-vscode/agents-rules/rule-systems)

### نظام الأدوات وMCP [#نظام-الأدوات-وmcp]

**الأدوات المدمجة:**
يقدّم Verdent أدوات شاملة لعمليات الملفات، والبحث (`glob`/`grep`)، وتنفيذ الأوامر (`bash`)، والوصول إلى الويب، وتفويض الوكلاء. تُمكّن الأدوات جميع عمليات التعامل مع الكود والتنقل والتفاعل الخارجي.

**بروتوكول سياق النموذج (MCP):**
يوسّع MCP إمكانيات Verdent من خلال الاتصال بأدوات ومصادر بيانات وخدمات خارجية. اضبط خوادم MCP من خلال الإعدادات ← خوادم MCP لدمج APIs الخاصة بالمشروع والوظائف المخصصة.

[عرض مرجع الأدوات](/docs/verdent-for-vscode/advanced-features/tool-reference)
[تعرّف على تكامل MCP](/docs/verdent-for-vscode/advanced-features/mcp)

***

## تنسيق متعدد الوكلاء [#تنسيق-متعدد-الوكلاء]

تُمكّن بنية الوكلاء الفرعيين المتعددة في Verdent من تنفيذ المهام بالتوازي مع التوجيه والتنسيق التلقائي.

**الوكيل الرئيسي (المنسّق):**
يحلل الوكيل الأساسي الطلبات، ويقسّم المهام المعقدة، ويفوّض العمل المتخصص إلى الوكلاء الفرعيين مع الحفاظ على سياق المحادثة ودمج النتائج.

**التنفيذ المتوازي:**
تعمل عدة وكلاء فرعيين في آنٍ واحد للعمليات المعقدة. مثال: يبحث الوكيل الفرعي Explorer في قاعدة الكود بينما يحلّل Code-reviewer الأمان في الوقت نفسه، مما يوفّر نتائج أسرع.

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

**توجيه المهام:**
يوجّه الاكتشاف التلقائي المهام بناءً على الأنماط:

* أسئلة قاعدة الكود ← الوكيل الفرعي `@Explorer`
* مراجعات الأمان ← الوكيل الفرعي `@Code-reviewer`
* فحوصات التحقق ← الوكيل الفرعي `@Verifier`

***

## إنشاء سير عمل مخصص [#إنشاء-سير-عمل-مخصص]

يمكن للمستخدمين المتقدمين تخصيص سلوك Verdent لمواءمة عمليات الفريق ومتطلبات المشروع.

**سير عمل وكلاء فرعيين مخصصين:**
أنشئ وكلاء فرعيين متخصصين لتلبية احتياجات خاصة بمجال معين:

* **مولّدات وثائق API** - استخراج نقاط النهاية والمعاملات من الكود
* **مراجعو ترحيل قواعد البيانات** - التحقق من أمان تغييرات المخطط
* **مدققو إمكانية الوصول** - فحص كود الواجهة الأمامية لضمان التوافق مع معايير WCAG

**التخصيص القائم على القواعد:**
حدّد معايير الترميز ومتطلبات الاختبار وتفضيلات المخرجات من خلال ملفات القواعد:

* تطبيق قواعد الفريق (المسافات البادئة، التسمية، الأنماط)
* تحديد أساليب التوثيق ومستويات تفصيل التعليقات
* التحكم في بنية مخرجات Plan Mode ومستوى التفصيل بها

**قابلية التوسيع من خلال MCP:**
دمج الأدوات والخدمات الخارجية:

* أدوات استعلام قواعد البيانات
* APIs الخدمات السحابية (AWS، وAzure، وGCP)
* تكاملات إدارة المشاريع (Jira، وLinear)
* اتصالات خطوط أنابيب CI/CD

[تعرّف على الوكلاء الفرعيين المخصصين](/docs/verdent-for-vscode/agents-rules/subagent-management)
[استكشف خيارات قابلية التوسيع](/docs/verdent-for-vscode/advanced-features/extensibility)

***

## تقنيات إدارة السياق المتقدمة [#تقنيات-إدارة-السياق-المتقدمة]

تُعد إدارة السياق الفعّالة أمرًا بالغ الأهمية للمشاريع المعقدة وجلسات الترميز الطويلة.

**قراءة استراتيجية للملفات:**
استخدم `file_read` مع نطاقات الأسطر للملفات الكبيرة لتجنب زيادة الحمل على السياق. اقرأ فقط الأقسام اللازمة للمهمة بدلًا من الملفات كاملة.

**تفويض الوكلاء الفرعيين للبحث:**
فوّض المهام الاستكشافية إلى الوكيل الفرعي `@Explorer` للحفاظ على نظافة سياق المحادثة الرئيسية. تستهلك نتائج بحث الوكيل الفرعي مساحة قليلة من السياق الرئيسي.

**البحث قبل القراءة:**
استخدم `grep_file` لتحديد الملفات ذات الصلة قبل قراءة المحتويات كاملة. اجمع بين أنماط `glob` و`grep_content` للحصول على عمليات بحث دقيقة تُقلّل من عمليات الملفات غير الضرورية.

**اختيار الأدوات المدرك للسياق:**

* **قواعد الكود الكبيرة:** الوكيل الفرعي `@Explorer` لفهم البنية
* **التحقق المنعزل:** الوكيل الفرعي `@Verifier` للفحوصات السريعة
* **مراجعات الأمان:** الوكيل الفرعي `@Code-reviewer` لتقييم الجودة

**مراقبة استخدام السياق:**
تابع الوكلاء الفرعيين الجاري تنفيذهم من خلال مؤشرات عرض المحادثة. تظهر عمليات الوكلاء الفرعيين في سجل المحادثة مع مؤشرات التقدّم وإسناد النتائج.

***

## انظر أيضًا [#انظر-أيضًا]

<CardGroup cols="2">
  <Card title="مرجع الأدوات" icon="wrench" href="/docs/verdent-for-vscode/advanced-features/tool-reference">
    دليل شامل لإمكانيات الأدوات
  </Card>

  <Card title="قابلية التوسيع" icon="puzzle-piece" href="/docs/verdent-for-vscode/advanced-features/extensibility">
    وكلاء فرعيون مخصصون، وقواعد، وتكامل MCP
  </Card>
</CardGroup>