«الوكيل» من أكثر الكلمات تحميلًا بالمعاني في الذكاء الاصطناعي حاليًا. تعني شيئًا مختلفًا بحسب من يستخدمها. في OpenCode لها معنى محدد: الوكيل مساعد متخصص مضبوط لمهمة أو سير عمل معيّن — بتعليماته وأدواته وصلاحياته الخاصة.
يأتي OpenCode بوكيلين مدمجين: Plan وBuild.
وكيل Plan
Plan وكيل حواري للقراءة فقط. يمكنه قراءة ملفاتك ومناقشة مشروعك، لكنه لن يجري أي تغييرات. لا ملفات تُكتب، ولا أوامر تُشغَّل، ولا شيء يُعدَّل.
سبق أن ضبطت "default_agent": "plan" في إعداداتك العامة في درس الإعدادات، لذا كل جلسة جديدة تبدأ هنا. هذا مقصود — تفكّر أولًا، ثم تفعل.
ومع ذلك، وضع Plan تعليمات للنموذج، وليس sandbox صارمًا. قد يجري الوكيل أحيانًا استدعاءات API أو يشغّل أوامر لها آثار جانبية، لذا فهو ليس حماية مضمونة ضد التغييرات غير المقصودة.
استخدم Plan عندما تريد:
- التفكير في مقاربة قبل الالتزام بها
- استكشاف الخيارات والمفاضلات
- طرح الأسئلة وإجراء البحث
- الوصول إلى خطة واضحة قبل لمس أي شيء
ما زال Plan المكان المناسب للتفكير في الأمور — فقط لا تعاملْه كضمان حديدي بأن شيئًا لن يتغير.
وكيل Build
Build هو وكيل التنفيذ. لديه وصول كامل — يمكنه قراءة الملفات وكتابتها وتشغيل أوامر الصدفة وإجراء التغييرات. بعد أن فكّرت في الأمور في Plan وعرفت ما تريد فعله، انتقل إلى Build لتنفيذه.
كيف تنتقل
في OpenCode Desktop: استخدم القائمة المنسدلة أسفل حقل الإدخال للتنقل بين Plan وBuild.
في الـ TUI: اضغط Tab للتبديل بين Plan وBuild.
سير العمل الموصى به
بما أن Plan هو افتراضيك، فكل جلسة تبدأ بأمان أصلًا. للمهام السريعة والمباشرة يمكنك الانتقال مباشرة إلى Build. أما لأي شيء معقد أو غير مألوف، فالبقاء في Plan أولًا عادة جيدة. يمنحك فرصة للتفكير بصوت عالٍ مع الوكيل، واكتشاف المشكلات مبكرًا، والوصول إلى Build باتجاه واضح.
نمط مفيد:
- ابدأ في Plan. صف ما تريد إنجازه. (أنت هنا أصلًا.)
- استكشف معًا. اطرح أسئلة، وازن الخيارات، نقّح المقاربة.
- انتقل إلى Build. اطلب منه تنفيذ ما خططت له.
وكلاء مخصصون
إلى جانب Plan وBuild، يمكنك تعريف وكلاءك الخاصين في opencode.json — بتعليمات مخصصة، وأدوات محددة مفعّلة أو معطّلة، ونموذج مفضّل، والمزيد. الوكلاء المخصصون مفيدون لسير العمل المتكرر مثل مراجعة التعليمات البرمجية أو الكتابة أو العمل على جزء محدد من قاعدة التعليمات البرمجية.
للمرجع الكامل، راجع وثائق الوكلاء.