OpenCode: OpenCode Agent Mode
آخر تحديث: 2026-08-31
--- title: وكلاء OpenCode (Agent) description: تعرّف على نظام الوكلاء مع الوكلاء المدمجين والوكلاء المخصصين وتكوين الوكلاء الفرعيين order: 13 lang: ar
الوكلاء هم مساعدو AI المتخصصون في OpenCode، كل منهم قابل للتكوين بـ prompts ونماذج وأدوات وصلاحيات مستقلة.
1. ما ستتعلمه
- أنواع الوكلاء: أساسي وفرعي
- الوكلاء المدمجون
- تكوين وكلاء مخصصين
- استخدام الوكلاء
2. أنواع الوكلاء
| النوع | الوصف | التبديل |
|---|---|---|
| وكيل أساسي | المساعد الرئيسي | Tab |
| وكيل فرعي | مساعد متخصص يُستدعى | @اسم_الوكيل |
3. الوكلاء المدمجون
| الوكيل | النوع | الوصف |
|---|---|---|
| Build | أساسي | افتراضي، جميع الأدوات مفعّلة |
| Plan | أساسي | تحليل وتخطيط فقط |
| General | فرعي | أدوات كاملة، يمكنه التعديل |
| Explore | فرعي | قراءة فقط، لا يُعدّل |
وكلاء النظام (مخفون): Compaction، Title، Summary
4. تبديل واستدعاء الوكلاء
- تبديل أساسي: Tab / Shift+Tab
- استدعاء فرعي:
@explore ابحث عن كل استخدام Redis - تنقل: Leader+→ / Leader+← / Leader+↑
5. تكوين وكيل مخصص
JSON:
JSON
{
"agent": {
"code-reviewer": {
"description": "Reviews code for best practices",
"mode": "subagent",
"model": "anthropic/claude-sonnet-4-20250514",
"prompt": "You are a code reviewer. Focus on security and performance.",
"tools": { "write": false, "edit": false }
}
}
}
Markdown:
في ~/.config/opencode/agents/ أو .opencode/agents/. اسم الملف = اسم الوكيل.
6. خيارات التكوين
| الخيار | الوصف |
|---|---|
description |
وصف الوظيفة (مطلوب) |
mode |
primary / subagent / all |
model |
تحديد النموذج |
prompt |
prompt النظام |
temperature |
عشوائية المخرجات (0.0-1.0) |
tools |
صلاحيات الأدوات |
permission |
تحكم دقيق بالصلاحيات |
7. إنشاء سريع
BASH
opencode agent create
❓ الأسئلة الشائعة
س متى أستخدم Plan بدلاً من Build؟
ج عندما تريد تحليلاً ونصائح بدون تعديل ملفات. Plan صلاحياته ask.
س هل يمكن للوكيل الفرعي استدعاء وكيل فرعي؟
ج نعم عبر أداة Task. تجنب الاستدعاءات الدائرية.
📖 الخلاصة
- وكلاء: أساسي (Tab) وفرعي (@)
- 4 وكلاء مدمجين + 3 نظاميين
- تكوين عبر JSON أو Markdown
- إنشاء سريع بـ
opencode agent create
📝 التمارين
-
أساسي: بدّل بين Build و Plan بـ Tab.
-
متوسط: أنشئ وكيل مراجعة كود للقراءة فقط.
-
متقدم: صمّم نظام وكلاء كامل (أساسي + فرعيين).