الوثائقالعمل اليومي
Helpi Agents
وكلاء برمجة يأخذون تذكرة ويفتحون pull request: ما يحتاجونه، وكيف تبدأ تشغيلًا وتتابعه وتراجع نتيجته.
آخر تحديث 22 نوفمبر 2026
Helpi Agents هم وكلاء البرمجة في Octopora. أعطِ أحدهم تذكرة فيخطط للتغيير، ويكتبه في مستودعك على فرع خاص به، ويشغّل فحوصاتك، ويفتح pull request لتراجعها. ولا يدمج أبدًا الـ pull request الخاصة به.
الوكلاء وأدوارهم
يبدأ كل مشروع بوكيل واحد اسمه Helpi Engineer، وهو معطّل. والدور يغيّر طريقة عمل الوكيل:
| الدور | ما يفعله |
|---|---|
| Engineer | ينفّذ التذكرة ويفتح pull request ليراجعها شخص. |
| Reviewer | يقرأ الـ pull request المفتوحة أصلًا لتذكرة وينشر ملاحظاته عليها. ولا يعدّل ولا يدفع أي شيء. |
| Designer | يعمل على الواجهة ويلتزم بنظام التصميم القائم. |
| Tester | يكتب الاختبارات دون تغيير الشيفرة المختبَرة. |
| Docs | يكتب التوثيق والتعليقات فقط، ولا يغيّر السلوك أبدًا. |
من يملك Manage Helpi Agent يضبط ذلك من Settings > Helpi Agent في المشروع: Add agent، ومفتاح تشغيل وإيقاف لكل وكيل، وRetire. وفي Skills يستطيع كتابة قواعد داخلية يقرؤها الوكيل عند انطباقها، وإسناد ما يصل إلى 16 مهارة لكل وكيل.
ما يحتاجه التشغيل
- خطة Business أو Enterprise. ويستطيع مالك مساحة العمل طلبها من
Settings > Plan & billing. - مستودع مربوط بالمشروع بصلاحية كتابة. راجع ربط مستودع.
- وكيل مفعَّل.
- الدور المناسب. يتيح لك
Use Helpi Agentإسناد تذكرة وبدء التشغيلات وإلغاءها والرد على الوكيل. ويتيحApprove Helpi Plansالموافقة على خططه. ويتيحManage Helpi Agentضبطه. ولدى دورَي Owner وAdmin الثلاثة كلها، أما Manager فيستطيع بدء التشغيلات.
لا تظهر صفحة Helpi Agent في المشروع إلا للأدوار التي تملك واحدة على الأقل من هذه الصلاحيات.
ماذا يفعل التشغيل
- ينسخ الوكيل مستودعك إلى بيئة معزولة.
- يقرأ التذكرة ويقدّم خطة.
- توافق على الخطة أو تطلب تعديلات.
- يكتب التغيير ويشغّل أوامر التحقق لديك.
- يدفع فرعًا اسمه
helpi/<ticket key>-<title>ويفتح pull request.
إذا شغّلت وكيلًا مرة أخرى على التذكرة نفسها أضاف commits إلى ذلك الفرع ما دام موجودًا. ويقطع Start a fresh branch instead فرعًا منفصلًا ويفتح pull request ثانية.
بدء تشغيل
- افتح التذكرة.
- اختر
Assign to Helpi Agentوحدد الوكيل. لا تُعرض إلا الوكلاء المفعّلون. - في بطاقة
Helpi Agentالخاصة بالتذكرة انقرStart run. أضف تعليمات إن لم تقل التذكرة كل شيء.
Start LR-13 with the engineer agent
يجد Helpi التذكرة، ويختار الوكيل الذي له هذا الدور (وإلا وكيل التذكرة نفسها، وإلا الوكيل الافتراضي للمشروع)، ويسنده ويبدأ التشغيل بصلاحياتك. ويبدأ فورًا بلا تأكيد، ولا يستهلك أي طلب من طلبات Helpi. وإذا تعذّر ذلك أخبرك بالسبب: دورك، أو عدم وجود وكيل، أو الخطة، أو عدم وجود مستودع أو وجود مستودع لا يمكن الدفع إليه، أو نفاد تشغيلات الشهر.
متابعة تشغيل
تعرض بطاقة Helpi Agent في التذكرة الحالة وTimeline وLogs وPrevious runs. وفي صفحة Helpi Agent للمشروع يعرض Overview التشغيل الحالي وتشغيلات الشهر، ويسردها Runs جميعًا. يمر التشغيل بالحالات Queued وProvisioning وCloning وAnalyzing وAwaiting plan approval وImplementing وValidating وPushing، ثم Pull request opened وCompleted. وقد ينتهي أيضًا بـ Cancelled أو Failed أو Timed out.
الموافقة على الخطة والرد على أسئلته
- عندما تكون الحالة
Awaiting plan approvalانقرView plan. - اقرأ الملفات التي ينوي إنشاءها أو تعديلها أو حذفها، وسبب ذلك.
- انقر
Approve plan، أوRequest changesوقل ما يجب فعله بشكل مختلف. يراجع الوكيل خطته عددًا محدودًا من المرات.
إذا تغيّرت التذكرة بعد كتابة الخطة، فاطلب تعديلات ليعيد الوكيل التخطيط. وعندما يتوقف تشغيل ليسأل شيئًا، تعرض التذكرة Helpi Agent needs your input: انقر Continue لإكمال العمل من الفرع والملفات المكتوبة أصلًا، أو Stop run. وتتطلب الموافقة Approve Helpi Plans، ويتطلب الرد Use Helpi Agent.
مراجعة الـ pull request
افتح الـ pull request من التذكرة وراجعها كأي أخرى. وأنت من يدمجها: فالوكيل لا يفعل ذلك أبدًا.
- في بطاقة
Pull request commentsبالتذكرة، يحمّلCheck PR commentsتعليقات المراجعين، عندما تطلب ذلك فقط. ويبدأMake the fixعلى تعليق تشغيلReview comment fixيدفع إصلاحًا له. - للحصول على رأي ثانٍ، أسند التذكرة إلى وكيل Reviewer وابدأ تشغيلًا. يقرأ الـ pull request المفتوحة وينشر ملاحظاته عليها. شغّل وكيل Engineer أولًا: فبلا pull request لا شيء يُراجَع. ثم يطلب
Fix the review findingsتطبيقها.
الحدود
وكلاء البرمجة غير مضمّنين في Starter وTeam. وتشملهم Business وEnterprise، مع الموافقة على الخطط وسجلات التشغيل. ولا يعمل على التذكرة إلا تشغيل واحد في كل مرة. ومن يملك Manage Helpi Agent يضبط حدود كل وكيل تحت Helpi Agent policy:
| الإعداد | المدى | الافتراضي |
|---|---|---|
Require plan approval | تشغيل أو إيقاف | تشغيل |
Maximum run length (minutes) | من 5 إلى 240 | 45 |
Runs per month | من 0 إلى 100 | 20 |
Concurrent runs | من 1 إلى 3 | 1 |
Validation commands | حتى 10، أمر في كل سطر | لا شيء |
عندما تنفد تشغيلات الشهر تعرض الصفحة Monthly run limit reached ويبدأ العدّ من جديد في الشهر التالي.
أسئلة شائعة
لا أرى Helpi Agent في الشريط الجانبي.
ليس لدور حسابك أي من الصلاحيات Manage Helpi Agent وUse Helpi Agent وApprove Helpi Plans. اطلب من Owner المشروع أو من Admin.
يقول إن رمز المستودع لا يستطيع الدفع.
رمز المستودع لا يستطيع الكتابة. أعد ربطه بصلاحية كتابة: راجع ربط مستودع.
هل يكتب الوكيل الشيفرة قبل موافقتي؟
لا، ما دام Require plan approval مفعّلًا، وهو الوضع الافتراضي. ينتظر الوكيل موافقتك على خطته.