أرسل وكيلك الأول

ما الذي ستبنيه

في نهاية هذا الدرس يكون لديك:

• وكيل أنشأته وهيّأته بنفسك
• مساحة تتحدث فيها أنت وذلك الوكيل
• تشغيل واحد مكتمل، فيه عمل مُودَع في شجرة عمل معزولة وصف في سجل تشغيل الوكيل

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

الخطوة 1: إنشاء وكيل

1. انتقل إلى الإعدادات ← مساحة العمل ← الوكلاء
2. انقر وكيل جديد. يُنشأ فورًا وكيل باسم «وكيل بلا اسم» ويُحدَّد في الكشف — لا حوار إنشاء ولا شيء لتأكيده. تهيّئه في مكانه.
3. في علامة تبويب الإعدادات، املأ:
   • الاسم: شيء قصير يسهل تذكّره، مثل alice. هذا ما تكتبه بعد @.
   • العنوان: ما يفعله، مثل «مهندس خلفية»
   • المحوّل: Control Center (built-in). اختره عمدًا — الإطار المضمّن وحده يمكن توجيهه في أثناء التشغيل وإيقافه مؤقتًا عند حد الجولة، ولا يحتاج سطر أوامر مثبّتًا على مضيف الخادم.
   • النموذج: اختر من القائمة التي يقدّمها المزوّد المربوط
   • المهارات: أرفق ما يناسب، مثل testing أو architecture
4. اضغط حفظ التغييرات

الوكيل بلا محوّل يعمل على الحلقة المضمّنة

حين لا يُضبط حقل المحوّل، يرجع الإرسال إلى Control Center (built-in) — حلقة الوكيل داخل الخادم، فلا شيء يلزم تثبيته على المضيف. ما زال يحتاج نموذجًا: إن غاب النموذج طلب من Anthropic افتراضه، وينجح ذلك إذا ربطت حساب Anthropic، وإلا يفشل مع No credential for provider "anthropic". اضبط الاثنين صراحة على أي حال، وإلا فستعمل على نموذج لم تختره.

نقطة التحقق. يعرض صف الكشف اسم وكيلك وحلقة حالة مجوّفة.

الخطوة 2: بدء مساحة

1. في الشريط الجانبي، اعثر على قسم المساحات وانقر زر +
2. أعطِ المساحة اسمًا
3. تحت إضافة وكلاء، اختر الوكيل الذي أنشأته للتو
4. إن وُجد في مساحة العمل أي مستودع، اختر ما يُفترض أن تعمل عليه هذه المساحة
5. انقر إنشاء

تُفتح المساحة. يجهّز Control Center في الخلفية شجرة عمل بالنسخ عند الكتابة للمستودعات المختارة لهذه المحادثة، على فرع خاص بها. لا تُعدَّل نسخة المصدر لديك أبدًا.

الخطوة 3: إرسال مهمة

اكتب مهمة واحدة صغيرة ومحددة على المستودع الذي سجّلته. الأفضل ما له نتيجة يمكن التحقق منها — أضف اختبارًا، أو أصلح مشكلة lint، أو أعد تسمية رمز.

اضغط Enter. لا حاجة إلى الإشارة إلى أحد بـ @: مع وكيل واحد في المساحة، توقظ الرسالة العادية الوكيل. في مساحة تضم عدة وكلاء، يختار @name واحدًا.

يجمّع Control Center المطالبة من تعليمات الوكيل وشخصيته ومهاراته وسياق المساحة، ثم يُرسِل التشغيل.

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

الخطوة 4: شاهد العمل

تعرض المحادثة التشغيل وهو يحدث:

• الاستدلال، يُعرَض في السطر بينما يفكّر الوكيل
• استدعاءات الأدوات: قراءات الملفات وكتاباتها، وعمليات البحث، وأوامر الصدفة، كل منها مع نتيجته
• النص: ملخصات وشروح وأسئلة لك

إن سألك الوكيل شيئًا، أجب في المحادثة فيستأنف.

لمقاييس التشغيل نفسه وأزرار إيقافه مؤقتًا واستئنافه وإيقافه، اعثر على الوكيل الذي يعمل في قسم الوكلاء من لوحة عام للمساحة واختر فتح النشاط.

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

ما يحدّ التشغيل: شجرة العمل الخاصة به بالنسخ عند الكتابة، وبيانات الاعتماد التي تُصدَر له عند الإطلاق وتُسحَب عند التفكيك، وبيئة معقّمة، وسطح الأدوات الذي يبيحه وضعه، وضوابط الإجراء. الآثار مثل دفع فرع أو فتح طلب سحب لها بوابة مستقلة — انظر الضوابط.

الخطوة 5: تحقق من النتيجة

1. افتح الإعدادات ← مساحة العمل ← الوكلاء واختر وكيلك
2. افتح علامة تبويب السجلات

نقطة التحقق. صف تشغيل واحد، يعرض حالته ومدته ووقتَي البدء والانتهاء والمحوّل الذي اشتغل عليه.

تُودَع تغييرات الوكيل على فرع المحادثة، في شجرة عمله. تُؤلَّف الإيداعات باسم الوكيل، وتُنسَب أنت في تذييل Co-Authored-By:.

الحصول على طلب سحب

لا شيء يفتح طلب سحب من تلقاء نفسه. إن أردت واحدًا، اطلبه في المحادثة نفسها:

ادفع هذا الفرع وافتح طلب سحب مقابل الفرع الافتراضي.

الدفع (gitPush) وإنشاء طلب السحب (prCreate) يطالبان بموافقتك افتراضيًا، فتوقع تأكيدًا قبل كل منهما. إن لم يكن معتمِد متصلًا حين يُطلَق السؤال، يُرفَض الإجراء ولا يُسمَح به — الضوابط مغلقة عند الفشل.

يُفتَح طلب السحب بهوية GitHub التي استخدم التشغيل رمزها — هويتك، إن خزّنت رمز وصول شخصي — لا باسم الوكيل. يظهر تأليف الوكيل على الإيداعات.

وتستطيع فتحه بنفسك أيضًا: في لوحة التحكم بالمصدر للمساحة زر إنشاء طلب سحب ينقل فرع المحادثة إلى شاشة الإنشاء، وطلبات السحب ← PR جديد يفتح الشاشة نفسها فارغة. من هناك يتابع الدرس التالي.

الخلاصة

أنشأت وكيلًا، وهيّأت محوّله ونموذجه، وأعطيته مساحة ومهمة، وشاهدت تشغيلًا حقيقيًا يكتمل في شجرة عمل معزولة من غير أن يمس نسخة عملك.

التالي: راجع أول طلب سحب لتتعرّف على مسار المراجعة.

للمزيد عن الوكلاء: نموذج الوكيل. لتفاصيل الإرسال: دورة حياة إرسال الوكيل.