إنشاء وكيل وتهيئته
يبيّن هذا الدليل كيف تضيف وكيلًا إلى مساحة عمل وتهيّئه إلى أن يستطيع العمل فعلًا.
تُبذَر كل مساحة عمل بخمسة وكلاء: وكيل CEO، وqa، وarchitect، وengineer، وlibrarian. لذلك تجد وكلاء في الغالب قبل أن تهيّئ أيًا منهم. الخطوات أدناه تنطبق على الوكيل المبذور وعلى الوكيل الجديد.
قبل أن تبدأ
قسم بعنوان “قبل أن تبدأ”- أنت داخل مساحة عمل. السطح كله في الإعدادات ← مساحة العمل ← الوكلاء (
/settings/workspace/agents). - يحتاج الوكيل إلى خلفية. إما أن تربط مزوّدًا للإطار المضمّن تحت الإعدادات ← الخادم ← مزوّدو النماذج، أو تثبّت سطر أوامر Claude Code على الجهاز الذي يستضيف
cc_server. - إن أردت أن يحمل الوكيل مهارات، ثبّتها أولًا تحت الإعدادات ← مساحة العمل ← المهارات. نموذج الوكيل لا يبدّل إلا المهارات الموجودة أصلًا في مساحة العمل.
إضافة الوكيل
قسم بعنوان “إضافة الوكيل”- افتح الإعدادات ← مساحة العمل ← الوكلاء.
- انقر وكيل جديد.
لا حوار ولا منتقي دور. يُنشأ فورًا وكيل باسم «وكيل بلا اسم»، ويُحدَّد في لوحة التفاصيل على اليسار.
يفترض أن ترى الآن «وكيل بلا اسم» في الكشف على اليمين، وعلامة تبويب الإعدادات في لوحة التفاصيل مفتوحة، وحقل الاسم يحوي «وكيل بلا اسم».
تسميته
قسم بعنوان “تسميته”- الاسم — المعرّف القصير المستخدم في الإشارة بـ @، مثل
alice. تحليل الإشارة يطابق@تليها محارف كلمة، فالاسم الذي فيه واصلة أو نقطة أو مسافة لا يمكن الإشارة إليه. - العنوان — التسمية التي يقرأها الإنسان، مثل «مطوّر أول».
- موجّه النظام — تعليمات إضافية اختيارية، تُحقن قسمًا بعنوان “Agent instructions”، ولا تستبدل بقية المطالبة المجمّعة.
انقر حفظ التغييرات أسفل النموذج. كل حقل في هذه الصفحة يُحفظ بهذا الزر الواحد.
تعيين المحوّل والنموذج
قسم بعنوان “تعيين المحوّل والنموذج”قائمة المحوّل المنسدلة تعرض المشغّلات الموجودة فعلًا على مضيف الخادم. المحوّل المضمّن موجود دائمًا، فهو الخادم نفسه. لا يظهر Claude Code إلا إذا اكتُشف سطر أوامره على ذلك المضيف:
| المحوّل | الخلفية |
|---|---|
| Control Center (built-in) | حلقة الوكيل داخل العملية، بلا سطر أوامر خارجي |
| Claude Code | claude -p --output-format stream-json |
الإطار المضمّن وحده يفرض الأوضاع، والتوجيه، والإيقاف المؤقت والاستئناف، وعقود الإكمال، والوكلاء الفرعيين. Claude Code لا يمنحك شيئًا من ذلك. Cursor وCodex وبقية مزوّدي النماذج تتصل بالمحوّل المضمّن كمزوّدين عليه.
قائمة النموذج المنسدلة تتبع المحوّل الذي اخترته. مع المحوّل المضمّن تأتي القائمة مباشرة من المزوّدين الذين ربطتهم تحت الإعدادات ← الخادم ← مزوّدو النماذج، فالمزوّد الذي بلا بيانات اعتماد مخزّنة لا يساهم بأي نموذج.
إضافة المهارات
قسم بعنوان “إضافة المهارات”المهارات منتقي شرائح لحزم المهارات المثبّتة في مساحة العمل هذه. انقر الشريحة لتبديلها، وعلامة الصح تميّز المختارة. إن خلت مساحة العمل من المهارات، يقرأ الحقل: «لا توجد مهارات متاحة. أنشئ المهارات في الإعدادات ← المهارات أولًا.»
لا تختار هنا مهارات المستودع نفسه. المستودع الذي يشحنها (في .agents/skills/ أو .claude/skills/ أو .opencode/skills/) يضيفها تلقائيًا إلى الوكيل الذي يعمل في ذلك المستودع، وتتبدل حين ينتقل إلى مستودع آخر. انظر مهارات على نطاق المستودع.
خط التبعية والشخصية
قسم بعنوان “خط التبعية والشخصية”- يتبع لـ — اختر وكيلًا آخر باسمه. هذا يبني شجرة التبعية التي يظهرها زر الهيكل التنظيمي في ترويسة الصفحة. قائمة التفويض التي يستخدمها قائد الفريق تأتي من أعضاء الفريق ومهاراتهم.
- الشخصية — نص حر يشكّل النبرة والسلوك، مثل: «يفضّل الحلول البسيطة المقروءة. يكتب اختبارات لكل شفرة جديدة.»
ضبط التشغيل
قسم بعنوان “ضبط التشغيل”- جهد الاستدلال — الخيارات هي المستويات التي ينشرها النموذج المختار نفسه: منخفض / متوسط / مرتفع، ويُضاف مرتفع جدًا في نماذج أسلوب OpenAI، ومرتفع جدًا + أقصى في نماذج أسلوب Claude. يختفي الحقل تمامًا إذا لم يصرّح النموذج المختار بمستويات تفكير، وقيمته تعود إلى افتراضي النموذج نفسه.
- حجم نافذة السياق — يُملأ مسبقًا من نافذة سياق النموذج كلما غيّرت النموذج، مع شرائح بنقرة واحدة لافتراضي النموذج و200k و500k و1M. القيمة التي تكتبها بعد اختيار النموذج تبقى هي المعتمدة حتى تغيير النموذج التالي.
- مهلة الصمت (بالدقائق) — تُنهي التشغيل بعد هذه المدة من غير مخرج. اتركها فارغة لاستخدام افتراضي الوضع.
منح الأذونات
قسم بعنوان “منح الأذونات”ليس للوكيل مبدّلات أذونات خاصة به. ما يستطيع دفعه أو فتحه أو دمجه أو الوصول إليه تقرره قواعد الإجراء في الإعدادات ← مساحة العمل ← أذونات الوكلاء، حيث يمكنك حصر قاعدة بهذا الوكيل. افتراضيًا، يُسأل عن الدفع وطلبات السحب والمراجعة أو الدمج والكتابة إلى المتتبع في كل مرة، والوصول إلى الشبكة مسموح.
رمز GitHub لدى الوكيل للقراءة فقط دائمًا. يمر الدفع عبر Control Center، الذي يسأل قاعدة الدفع إلى مستودع بعيد قبل تمريره. انظر تهيئة سياسات البيئة المعزولة لكيفية بلوغ كل قاعدة التشغيل.
التحقق من أنه يعمل
قسم بعنوان “التحقق من أنه يعمل”- افتح الإعدادات ← الخادم ← مزوّدو النماذج وتأكد أن المحوّل الذي اخترته يبلّغ بإصدار مثبّت لا «غير موجود». انقر تحديث لإعادة الفحص. يجري الفحص على الجهاز الذي يستضيف
cc_server، لا على الجهاز الذي تنظر إليه. - افتح مساحة تضم الوكيل وأرسل إليه رسالة، أو أشر إليه بـ @ في مساحة قائمة.
- عد إلى الإعدادات ← مساحة العمل ← الوكلاء، واختر الوكيل، وافتح علامة تبويب السجلات. يفترض أن يظهر تشغيل معه شارة حالة، ومدة، ووقت بدء، والمحوّل الذي استخدمه. عرض يفتح تيار أحداث ذلك التشغيل.
إن لم يظهر أي تشغيل، اتبع تشخيص وكيل.
حذف وكيل
قسم بعنوان “حذف وكيل”اختره في الكشف. في علامة تبويب الإعدادات، انزل إلى منطقة الخطر أسفل النموذج وانقر حذف.