# الجلسات

> ابدأ جلسة ذكاء اصطناعي في AI CodeOps: صف المهمة، واختر مشروعا وسير عمل، وشاهد الوكلاء يعملون مباشرة، وراجع الفروقات، وافتح طلب سحب.

المصدر: https://aicodeops.dev/ar/docs/sessions

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

## ابدأ جلسة

1. افتح **Develop → AI Sessions** واختر **New session** (جلسة جديدة).
2. املأ النموذج **Start an AI session** (الحقول أدناه).
3. اختر **Start session** (بدء الجلسة). توضع الجلسة في قائمة الانتظار وتظهر في القائمة.

حقول النموذج:

- حقل **What should the session do?** صف المهمة بكلمات بسيطة، مثل "Add rate limiting to the public API and write tests for it."
- حقل **Workflow:** الطريقة التي يعمل بها الوكلاء. والافتراضي، وهو **Plan, Build, Review & Test**، يناسب معظم التغييرات. راجع [الوكلاء ومسارات سير العمل](https://aicodeops.dev/ar/docs/agents).
- حقل **Project:** مطلوب. الكود الذي يولده الذكاء الاصطناعي يتبع دائما [مشروعا](https://aicodeops.dev/ar/docs/projects).
- حقل **Model tier** أو **Model:** النماذج التي تستخدم. راجع [النماذج والفئات](https://aicodeops.dev/ar/docs/models).
- حقل **File context (optional):** مسارات مفصولة بفواصل ينبغي أن يقرأها الوكلاء أولا.

ويمكنك أيضا بدء جلسة من صفحة المشروع بالزر **Run workflow**.

### ما أكبر حجم للتغيير

يجب أن يكون تغيير الجلسة صغيرا بما يكفي ليراجعه شخص:

- يمكن أن تبلغ فروقاته 60 KB؛
- ويمكن أن يغير حتى 25 ملفا، حجم كل منها حتى 64 KB.

التغيير الأكبر يرفض كله ولا يقتطع أبدا: تنتهي الجلسة بالرسالة "The change is too large to review"، وتسمي الملفات التي فيها معظم الحجم. قسّم المهمة إلى مهام أصغر.

تعيد الجلسة كتابة كل ملف تغيره كاملا، ولا يعرض عليها إلا بداية الملف الطويل. وإعادة الكتابة التي ستسقط أسطرا لم ترها الجلسة لا تكتب: تعطى الجلسة تلك الملفات كاملة وتحاول مرة أخرى، وإذا بقيت النتيجة تسقطها تنتهي الجلسة مع ذكر السبب. وعندها اطلب تغييرا أضيق، أو سم الجزء المراد تغييره من الملف.

## شاهدها مباشرة

تتحدث صفحة الجلسة أثناء عملها. ترى كل خطوة (أي وكيل، وماذا يفعل، وحالته)، وتكلفة الجلسة ورموزها وهي تتراكم. وتعرض القائمة في **AI Sessions** كل جلسة مع مشروعها ومدتها وتكلفتها وحالتها، وشارات للجلسات التي أنتجت تغييرات أو ملاحظات.

لإيقاف جلسة، اختر **Cancel session** (إلغاء الجلسة) واذكر سببا. يحفظ السبب على الجلسة ويعرض في صفحتها.

## راجع النتيجة

حين تنتهي الجلسة، تعرض صفحتها:

- قسم **Summary:** ما فعله الوكلاء، بكلمات الخطوة الأخيرة. وحين تكون في سير العمل خطوات تلي الكود، مثل Review و Test، يكتب بعد تشغيل اختباراتك. وإذا ناقض ما يقوله عن الاختبارات النتيجة المسجلة، يبين ذلك تحذير فوقه.
- قسم **Proposed changes:** الفروقات، مع تنزيل بصيغة `.patch`. وإذا سمى طلبك ملفات وترك التغيير بعضها دون مساس، تسردها ملاحظة.
- قسم **Quality gates:** نتائج الاختبار وهل التغيير جاهز للإصدار. راجع [بوابات الجودة](https://aicodeops.dev/ar/docs/quality-gates).
- قسم **Findings:** المشكلات التي وجدتها المراجعة، مع درجة الخطورة والملف.

كل جلسة تكتب كودا تسرد أيضا في **Develop → Changes**، حيث يمكنك متابعتها من الاقتراح عبر المراجعة والدمج إلى النشر.

## اطلب تغييرات

استخدم مربع **Follow-up prompt** (طلب المتابعة) في صفحة الجلسة لطلب تحسينات أو مهمة تالية تبني على هذه. اختر **Send follow-up** (إرسال المتابعة)؛ فتواصل من سياق الجلسة. وتعرض صفحة المتابعة المهمة الأصلية في **Task** وتحتها **Latest request (follow-up N)**. وما دامت الجلسة تعمل، تبدأ المتابعة جلسة جديدة مرتبطة بها؛ وتواصل الجلسة الجارية دون تغيير.

يبدأ **Re-run** (إعادة التشغيل) المهمة نفسها من البداية.

## وافق وافتح طلب سحب

الجلسة التي تغير الكود تفتح مراجعة في **Review & Gate → Approvals**. وفي صفحة الجلسة، اختر **Accept changes** (قبول التغييرات) أو **Reject** (رفض). ومن بدأ الجلسة لا يستطيع الموافقة عليها إذا كان في مساحة العمل شخص آخر يستطيع ذلك. راجع [الموافقات والسياسات](https://aicodeops.dev/ar/docs/approvals-and-policies).

متى جرت الموافقة على التغيير واجتاز بوابات الجودة الخاصة به، يفتح AI CodeOps طلب السحب لك: فرع جديد `codeops/run-<id>` في مستودع المشروع، إلى فرعه الافتراضي. ويمكنك أيضا اختيار **Create Pull Request** بنفسك. ويشرح الزر ما ينقص إذا كان مقفلا، مثل **Connect git to open PR** أو **Add a repository to open PR**.

لا يدمج شيء دون موافقتك.

## Terminal

تفتح صفحة **Develop → Terminal** (بيتا) واجهة أوامر (shell) عند جذر المشروع في بيئة معزولة خاصة بها، لتستخدمها حين تريد الاستطلاع أو تشغيل أمر بنفسك. ولا تعمل الأوامر أبدا على خوادم المنصة نفسها. والتوفر يعتمد على خطتك.

## الخطوات التالية

- [الوكلاء ومسارات سير العمل](https://aicodeops.dev/ar/docs/agents)
- [بوابات الجودة](https://aicodeops.dev/ar/docs/quality-gates)
- [ضوابط التكلفة](https://aicodeops.dev/ar/docs/cost-controls)

## الأسئلة الشائعة

### هل أحتاج إلى تثبيت أي شيء لتشغيل جلسة؟

لا. تعمل الجلسات في السحابة وتتابعها في المتصفح. ولا توجد واجهة سطر أوامر (CLI) ولا إعداد محلي.

### هل يمكنني تغيير نتيجة الجلسة قبل الموافقة عليها؟

يمكنك طلب تغييرات بطلب متابعة. وتعديل التغيير بعد الموافقة عليه يعيد موافقته إلى البداية، فيجب أن يوافق عليه من جديد.
