# الوكلاء

## ما هي الوكلاء؟

الوكلاء هم مساعدون ذكاء اصطناعي معزولون يفكرون في المشكلات وينفذون المهام ويتواصلون عبر منصات متعددة. لكل وكيل مساحة عمل خاصة به وسجل جلسات وإعداد نموذج وارتباطات قنوات.

## عزل الوكلاء

يحصل كل وكيل على:

- **مساحة العمل**, دليل مخصص للملفات والملاحظات والبيانات الخاصة بالوكيل
- **الجلسات**, سجل محادثات مستقل ونصوص جلسات
- **الإعداد**, اختيار النموذج وأذونات الأدوات وحدود الإنفاق
- **الهوية**, شخصية فريدة محددة في ملف `AGENTS.md` الخاص بالوكيل
- **ملفات تعريف المصادقة**, إعدادات مفتاح API والمصادقة لكل وكيل

## شخصيات الوكلاء

تحتوي مساحة عمل كل وكيل على ملف `AGENTS.md` يحدد الشخصية والتعليمات وإرشادات السلوك. تشكّل هذه المطالبة الثابتة للنظام طريقة استجابة الوكيل, النبرة وخبرة المجال والتنسيق واستخدام الأدوات وسياسات الأمان.

## توجيه الوكلاء المتعددين

عند تشغيل وكلاء متعددين، يتم توجيه الرسائل الواردة تلقائياً بناءً على **الارتباطات**:

- **ارتباط القناة**, توجيه جميع رسائل منصة ما (مثلاً، جميع رسائل Telegram ← الوكيل الشخصي)
- **ارتباط الخادم/مساحة العمل**, توجيه خادم Discord أو مساحة عمل Slack محددة إلى وكيل مخصص
- **ارتباط نوع الدردشة**, توجيه الرسائل الخاصة إلى وكيل وجماعة الرسائل إلى آخر
- **ارتباط جهة الاتصال/النظير**, توجيه رسائل جهات اتصال محددة إلى وكلاء محددين

يتم تقييم الارتباطات بترتيب الأولوية. أول تطابق يفوز. الرسائل غير المتطابقة تذهب إلى الوكيل الافتراضي.

## الوكلاء الفرعيون والتفويض

يمكن للوكلاء إنشاء وكلاء فرعيين للمهام المتخصصة:

- **تفويض المهام**, تقسيم المهام المعقدة وتفويض أجزاء منها إلى وكلاء فرعيين متخصصين
- **التنفيذ المعزول**, يعمل الوكلاء الفرعيون في سياق جلسة خاص بهم
- **محادثات ذهاباً وإياباً**, يمكن للوكلاء إجراء تبادلات متبادلة (حتى 5 جولات) للتعاون
- **الإعلان عن النتائج**, يمكن نشر نتائج الوكلاء الفرعيين في القناة الأصلية

## الفرق والتنسيق

تتيح فرق الوكلاء المتعددين سير عمل منسق:

- **التنفيذ المتوازي**, تشغيل وكلاء متعددين في آنٍ واحد على جوانب مختلفة من مهمة ما
- **خطوط الأنابيب المتسلسلة**, ربط الوكلاء بحيث يبني كل منهم على مخرجات السابق
- **الوضع الهجين**, الجمع بين التنفيذ المتوازي والمتسلسل
- **تتبع المهام**, مراقبة حالة عمل كل وكيل (في الانتظار، قيد التشغيل، منتهٍ، خطأ، ملغى)

## ملفات تعريف الأدوات

تحكم في ما يمكن لكل وكيل فعله:

| الملف التعريفي | الأدوات المتاحة |
|---------|----------------|
| **minimal** | حالة الجلسة فقط |
| **coding** | إدخال/إخراج الملفات والتنفيذ والجلسات والذاكرة والصور |
| **messaging** | إرسال الرسائل وسجل الجلسات |
| **full** | جميع الأدوات (الافتراضي) |

يمكن تعيين قوائم السماح/الرفض المخصصة لكل وكيل ولكل موفر نموذج.

## الوضع الآمن

يوفر الوضع الآمن بيئة تنفيذ محمية:

- **التبديل الرئيسي**, التفعيل أو التعطيل عالمياً
- **عناصر التحكم لكل وكيل**, التعطيل للوكلاء الموثوقين والإبقاء عليه للآخرين
- **الموافقة على التنفيذ**, العمليات الحساسة تتطلب موافقة صريحة من المستخدم
- **مزامنة السياسة**, الإعدادات مزامنة عبر جميع العملاء المتصلين في الوقت الفعلي

## ذاكرة الوكيل

كل وكيل لديه وصول إلى نظام ذاكرة:

- **MEMORY.md**, ملاحظات ومعلومات مستمرة عبر الجلسات
- **ملفات الذاكرة**, معرفة منظمة إضافية في مجلد `memory/`
- **البحث المتجهي**, البحث في الذاكرة باستخدام استعلامات اللغة الطبيعية

راجع [الجلسات والذاكرة](sessions-memory.md) للتفاصيل.