الدردشة مع وكيل

يبيّن هذا الدليل كيف تعمل مع وكيل داخل مساحة.

إنشاء مساحة

1. انتقل إلى المساحات في الشريط الجانبي.
2. انقر زر + بجانب عنوان المساحات.
3. اكتب الاسم — وهو مطلوب. الاسم الفارغ يُرفَض، ويبقى الحوار مفتوحًا.
4. أضف وكلاء من مساحة العمل إن شئت.
5. إن وُجد في مساحة العمل أي مستودع، يظهر منتقي المستودعات. يبدأ وكل المستودعات محددة؛ ضيّق التحديد (بما في ذلك إلغاء تحديد مستودع واحد) إلى المستودعات التي تجهّز هذه المساحة أشجار عمل لها.
6. أكّد.

يفتح Control Center المساحة، ويبدأ في الخلفية تجهيز شجرة عمل بالنسخ عند الكتابة لكل مستودع محدد.

إرسال الرسالة الأولى

اكتب رسالتك في حقل الكتابة واضغط Enter. يُرسَل الوكيل ويبدأ بث جوابه.

إن كانت المساحة ما تزال قيد التجهيز، تُعلَّق رسالتك بدل أن تضيع — يحتفظ بها حقل الكتابة ويرسلها تلقائيًا ما إن تجهز أشجار العمل.

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

توجيه وكيل يعمل

ما دام الوكيل يعمل، النص الحواري العادي لا يضع جولة جديدة في الطابور. يصير بطاقة توجيه في الانتظار، في الشريط فوق حقل الكتابة، ويُحقَن في التشغيل الحي عند حد الجولة التالي. لا إشعار منبثق — البطاقة هي الإشارة.

ثلاثة أمور تغيّر هذا السلوك:

• الرسالة التي فيها إشارة @ تُرسَل دائمًا رسالةً، ولا تصير توجيهًا أبدًا
• الرسالة التي تبدأ بـ أمر الشرطة المائلة تُعالَج دائمًا على أنها ذلك الأمر
• الرسالة التي معها مرفق تُرسَل دائمًا رسالةً — طابور التوجيه نص فقط
• إن كانت كل التشغيلات الحيّة قد انتهت، يمر النص ويُرسَل رسالة عادية

التوجيه يحتاج الإطار المضمّن

لا يحقن التوجيه في منتصف التشغيل إلا إطار Control Center المضمّن. على محوّل Claude Code يبقى النص بطاقة توجيه في الانتظار؛ وحين ينتهي التشغيل يتحوّل ما بقي في الانتظار إلى رسالة عادية.

الموافقة على إجراء محظور

حين يبلغ الوكيل إجراءً تغلقه الضوابط — أمرًا مدمّرًا، أو أداة ذات امتياز — يحظر الخادم التشغيل وينشر طلب موافقة إلى كل عميل متصل. إن كانت تلك المحادثة مفتوحة، يظهر الطلب في الدردشة، فوق حقل الكتابة، ببطاقة الخيارات المرقّمة نفسها المستخدَمة مع ask_user (رفض، موافقة، واختياريًا الموافقة لمدة 8 ساعات). لا تخطّي: الوكيل المحظور ينتظر قرارًا.

إن كنت في موضع آخر من التطبيق، تظل لوحة في المقدمة داخل الواجهة تسرد ما ينتظر، فتستطيع رفع الحظر عن الوكيل من غير البحث عن المساحة. تخفي الطبقة العلوية الطلب لحظة ظهور محادثة تلك المساحة على الشاشة، فلا تجيب عن المطالبة نفسها مرتين.

لا مهلة: الوكيل المحظور ينتظر حتى يقرّر أحد. ويظهر الطلب نفسه في شريط «يحتاج إلى انتباهك» في الوارد، وعلى تطبيق الهاتف.

الإجابة عن سؤال الوكيل

الوكيل الذي يحتاج إلى تفضيل، أو إلى متطلب ناقص، أو إلى مفترق حقيقي يجب أن يستدعي ask_user. كتابة السؤال رسالة في الدردشة تُنهي الجولة، وعليك أن تعيد المطالبة. ترسم الأداة بطاقة مرقّمة في المحادثة — خيارات، أو نصًا حرًا اختياريًا، أو الاثنين — وينتظر التشغيل جوابك.

انقر خيارًا واحدًا لإرساله (يصير الرقم اللاحق سهمًا عند مرور المؤشر). الاختيار المتعدد والأجوبة المكتوبة يستعملان متابعة (⌘↵ / Ctrl↵). تخطي يطلب من الوكيل أن يختار افتراضيًا معقولًا وألا يسأل مرة أخرى.

هي آلية منفصلة عن بطاقة الموافقة أعلاه: الموافقة «أأفعل هذا؟»، والسؤال «أي هذه قصدت؟». السؤال متاح على الإطار المضمّن في كل وضع، بما فيها أوضاع القراءة فقط (لا يغيّر شيئًا)، وهو عمدًا غير ملفوف بمطالبة موافقة — فحوار أمام حوار يفشل مغلقًا إذا لم يكن هناك معتمِد متصل. والتشغيل الذي لا محادثة يُرسَم فيها لا يحصل على الأداة أصلًا.

إيقاف وكيل

ما دامت التشغيلات حيّة، يصير زر الإرسال في حقل الكتابة زر إيقاف. أفرغ حقل الكتابة واضغطه — يوقف ذلك كل وكيل يعمل في تلك المحادثة.

لا عنصر إيقاف في ترويسة المساحة، ولا اختصار لوحة مفاتيح له. لإيقاف تشغيل واحد حين تكون عدة تشغيلات حيّة، افتح لسان نشاط الوكيل لذلك التشغيل — تحمل ترويسته إيقاف الوكيل مؤقتًا واستئناف الوكيل وإيقاف التشغيل (والإيقاف يطلب منك التأكيد). قابلية الملاحظة ← مباشر يسرد كل وكيل يعمل في مساحة العمل، وبالتحكم نفسه.

يُعلَّم التشغيل المتوقف بـ«متوقف». أرسل رسالة جديدة ليُرسَل من جديد.

استخدام أوامر الشرطة المائلة

اكتب / في حقل الكتابة لتظهر قائمة الأوامر. هذه التي تغيّر سلوك المحادثة:

الأمر	ما يفعله
/plan	ينقل المساحة إلى وضع التخطيط. /plan وحده يضبط الوضع؛ و/plan <request> يضبطه ويرسل الباقي على أنه رسالتك
/goal <text>	يسجّل هدف العمل الجاري لهذه المحادثة
/loop <text>	يكرّر العمل على مهمة حتى تكتمل
/compact	يطوي السجل الأقدم في ملخص مثبَّت ويتابع على السياق المضغوط
/todo …	يعرض قائمة المهام المحفوظة لهذه المحادثة ويحرّرها

تظهر المهارات في القائمة نفسها تحت نطاق skill: الخاص بها، فلا تتصادم مع الأوامر أعلاه — وتبقى مهارة اسمها plan أو compact في المتناول:

الأمر	ما يشغّله
/skill:<name>	مهارة مثبّتة في مساحة العمل، أو مرفقة بالوكيل
/skill:<repo>:<name>	مهارة يشحنها أحد المستودعات المُخرَجة في هذه المساحة

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

لا يحمل الوكيل إلا مهارات المستودع الذي يعمل فيه الآن — انظر مهارات على نطاق المستودع. حقل الكتابة ليس محصورًا كذلك: تستطيع استدعاء مهارة أي مستودع بتسميتها.

/compact و/todo يعترضهما العميل ولا يُحفظان رسائل — فسطر /compact في نص المحادثة كان سيؤخّر حد الضغط التالي جولة. /plan يقلب وضع المساحة المخزَّن بدل أن يسافر نصًا. فليس أي من الثلاثة «رسالة ترسلها إلى الوكيل»؛ لا تتوقع أن تراها في السجل.

اطلب خطة أولًا

قبل تغيير معقّد، انقل المساحة إلى وضع التخطيط بـ /plan، أو بقائمة الوضع في شريط أدوات حقل الكتابة، أو بـ Shift+Tab. يبحث الوكيل عندها للقراءة فقط، ويسلّم خطة مُنمَّطة توافق عليها قبل أن يبدأ أي عمل. انظر استخدام وضع الخطة.

الوصول إلى وكيل من غير مساحة مخصّصة له

لست بحاجة إلى مساحة لكل وكيل. في أي مساحة:

@alice can you look at the failing tests in src/auth_test.dart?

يُضاف الوكيل المشار إليه إلى المساحة ويُرسَل مع سياقها. انظر الإشارة إلى الوكلاء بـ @ لكيفية مطابقة الأسماء.

أدلة ذات صلة

• استخدام المساحات
• الإشارة إلى الوكلاء بـ @
• استخدام وضع الخطة
• إعداد تكامل Slack لتعمل الشيء نفسه من Slack

مفاهيم ذات صلة

• الأوضاع