تحوّل هذه المرحلة قواعد مستند الاكتشاف إلى إعدادات. اعمل عبر المجالات أدناه بالترتيب. بالنسبة لكل مجال، قرّر مع العميل ثم قم بضبط الإعدادات.
سجّل كل قرار وسببه أثناء العملية. مذكرة تسليم يتم بناؤه من هذه الملاحظات.
مشاريع
قرّر مع العميل:
- أي المستودعات ستتحول إلى مشاريع. استخدم مشروعًا واحدًا لكل مستودع.
- الفرع الذي يفتح فيه CoRoid طلبات السحب الخاصة به.
- ما إذا كان مسموحًا لـ CoRoid بدفع التغييرات إلى المستودع (متزامن) أو يقتصر على القراءة فقط (محلي فقط).
- الأوامر التي تُستخدم لتثبيت الكود وبنائه واختباره، بالإضافة إلى الخدمات التي تحتاجها الاختبارات.
- ما الذي يجب أن تعرفه الوكلات ولا يظهر في الكود.
أنشئ كل مشروع من مشاريع. ثم افتح إعدادات المشروع:
مستودع للفروع ووضع التشغيل، متغيرات البيئة، و
المعرفة ← السياق لما تقرأه الوكلات. تحقق من أوامر البناء والاختبار التي اكتشفها CoRoid. اكتب ما يجب أن تعرفه الوكلات في AGENTS.md، في
المستودع.
اطلع على أنشئ مشروعك الأول، إعدادات المستودع والفرع، إعدادات البناء والاختبار و اكتب AGENTS.md.
ضبط الجودة
قرّر مع العميل:
- ما الذي يجب أن تمر به كل تغييرة، وما هي حالات الفشل التي تمنع التنفيذ أو تقدم مجرد توصية.
- مدى دقة عمليات ضبط الجودة، وأين تتم عمليات التحقق.
- ما الذي يحدث لطلبات السحب التي يفتحها المستخدمون: ضبط جودة CoRoid، ومراجعة CoRoid كخطوة استشارية أو حاسمة.
- أي المصادر التي يمكنها تقديم الطلبات، مثل Slack أو Telegram أو Jira.
- ما الذي يحدث عند حدوث خلل، مثل فشل مهمة أو عملية نشر.
اضبطه في ضبط الجودة. اضبط القيمة الافتراضية للمؤسسة لتضمين عمليات التحقق التي تحتاجها معظم المشاريع. قم بإعداد إعدادات خاصة بالمشروع فقط عند وجود اختلاف. اطلع على سياسات وقيود الجودة و عمليات التحقق من المحتوى غير المناسب.
لا يتم دمج تغييرات pull request من CoRoid إلا بعد موافقة شخص ما. بالنسبة للكود الذي يحتاج إلى مصرّح محدد، مثل كود الدفع، استخدم حماية الفروع في مضيف Git.
الهدف
يسمح الهدف لـ CoRoid ببدء العمل حتى في غياب تدخل بشري، مثل البيانات القادمة من أداة تتبع الأخطاء. لكنه لا يسمح لـ CoRoid بالدمج أو النشر أبدًا.
قرّر مع العميل:
- أي الأعمال يمكن لـ CoRoid بدءها بشكل مستقل، وعلى أي المشاريع.
- مقدار الإنفاق المسموح به أسبوعيًا أو شهريًا.
- متى سيتفقد العميل الهدف مرة أخرى.
اضبط الأهداف في ضبط الجودة: اختر القيمة الافتراضية للمؤسسة، ثم الأهداف في التسليم مجموعة. إذا أراد العميل عدم تنفيذ أي عمل دون تدخل بشري، فلا تقم بضبط أي هدف. اطلع على الأهداف.
ملفات تعريف AI
قرّر مع العميل:
- أي الملفات التعريفية التي ستستخدمها المؤسسة بشكل افتراضي.
- ما إذا كان يجب أن تبقى مكالمات النماذج داخل الاتحاد الأوروبي. في هذه الحالة، استخدم الاتحاد الأوروبي فقط.
- ما إذا كان الدفع مقابل النماذج سيتم عبر ائتمانات النماذج الخاصة بـ CoRoid أو عبر مفاتيح مزود الخدمة الخاصة بالعميل.
- أي المزودين والنماذج التي لا يُسمح للوكلات باستخدامها أبدًا.
اضبط الملفات التعريفية في إعدادات → AI profile، والمفاتيح في إعدادات → مفاتيح المزود. قيّد المزودين والنماذج في إعدادات → هوية الوصول → سياسة المنظمة. اطلع على ملفات تعريف AI، مفاتيح المزود و ائتمانات النماذج.
الأتمتة
قرّر مع العميل:
- أي الأعمال تبدأ وفق جدول زمني، وأيها يبدأ عند حدوث حدث معين.
- ما الذي تقوم به كل عملية أتمتة، وفي أي المشاريع.
- ما إذا كانت عملية الأتمتة تقرأ وتبلغ فقط، أم تفتح مهامًا أيضًا.
أنشئ عمليات الأتمتة في عمل جديد، واعثر عليها جميعًا في مصنع → الأتمتة. توجد المفاتيح تحت عند حدوث خلل في ضبط الجودة، حيث تُشغّل كل عملية أتمتة مرة واحدة. اطلع على الأتمتة، جداول زمنية و الخطافات.
سير العمل
تغطي سير العمل عملية تجارية، مثل صندوق بريد الدعم. تقوم الوكلات بتنفيذ خطواتها، ويقرر البشر متى يتدخلون حسب ما تحدده سير العمل. لم تُفعَل ميزة سير العمل بعد في جميع المؤسسات. اطلب من CoRoid لتفعيله.
قرّر مع العميل:
- أي عملية سيتم تغطيتها أولاً. اختر عملية تحتوي على العديد من الحالات المتشابهة وقواعد واضحة.
- كيف تبدأ الحالة: عبر بريد إلكتروني، أو نموذج على موقع العميل الإلكتروني، أو شخص، أو سير عمل آخر.
- الخطوات، وما ينتظره كل خطوة: لا شيء، أو المال فقط، أو كل التغييرات والرسائل.
- مسارات كل خطوة: طلب رأي العميل، الانتقال إلى خطوة أخرى، اتباع جدول قواعد، تسليم الحالة لشخص، أو إغلاقها.
- جداول القواعد، على شكل صفوف من "عند حدوث هذا، فعل ذلك".
- العنوان الذي تُرسل منه الردود، والتوقيع، وسطر الكشف عن AI.
بنِه في سير العمل. يحتوي كل سير عمل على حالات، خطوات و إعدادات، وجداول القواعد مشتركة تحت جداول القواعد. شغّله جرّبه على الخطوات قبل النشر: يرسل جرّبه ولا يغير أي شيء. ثم نشر و تفعيل. اطلع على سير عمل عبر MCP.
مراجعة القواعد
قرّر مع العميل ما يجب أن يبحث عنه مراجع CoRoid في كود هذا العميل، بخلاف قواعد CoRoid الخاصة.
اكتب القواعد في كل مستودع: ملف REVIEW.md في المسار الجذري، وملفات القواعد في مجلد review-rules يقرأها CoRoid من الفرع الأساسي، لذا لا يمكن لـ pull request تغيير القواعد التي يتم مراجعتها بناءً عليها. حدد ما ينشره مراجع CoRoid في ضبط الجودة، تحت طلبات السحب. اطلع على
طلبات السحب.
مهارات
المهارة هي إجراء تحمّله الوكلات فقط عند الحاجة إليه، مثل "كيفية كتابة عملية ترحيل قاعدة بيانات". قرّر مع العميل أي من إجراءاته الخاصة يجب أن تتبعها الوكلات.
اكتب كل مهارة في المستودع، على شكل skills/<name>/SKILL.mdيبدأ الملف ببيانات تمهيدية تحتوي على name و description. تقرأ الوكلات المهارات من المستودع المدمج فقط. اطلع على
مهارات تدريجية و
اكتب AGENTS.md.
ما يمكن تغييره دون كود
لا يحصل العملاء ومنفذو التنفيذ على كود مصدر CoRoid. كل ما يمكن للعميل تغييره موجود في هذا الجدول: إعداد في البوابة، أو ملف في مستودع العميل الخاص. بعض الصفحات تظهر فقط عند تفعيل الميزة في CoRoid، مثل سير العمل.
| ما | أين |
|---|---|
| اسم المنظمة | إعدادات → عام |
| الأعضاء وأدوارهم | إعدادات → أعضاء |
| ملفات تعريف AI | إعدادات → AI profile |
| مفاتيح المزود | إعدادات → مفاتيح المزود |
| حسابات الخدمة لاستقبال الأعمال في API | إعدادات → حسابات الخدمة |
| اتصال مضيف Git | إعدادات → اتصالات → التحكم في المصدر |
| برامج Slack وTelegram الآلية | إعدادات → اتصالات → قنوات |
| خوادم MCP الخارجية، والأدوات التي يمكن للوكلات استدعاؤها | إعدادات → اتصالات → MCP الخارجي |
| رموز الوصول، وموافقات، وسياسات الأتمتة لخادم MCP الخاص بـ CoRoid | إعدادات → اتصالات → خادم MCP الخاص بـ CoRoid |
| SSO، النطاقات الموثوقة ومزامنة الدليل | إعدادات → هوية الوصول → هوية المؤسسة |
| النماذج المسموح بها، ومزودو الخدمات، والأوامر والأدوات | إعدادات → هوية الوصول → سياسة المنظمة |
| جلسات تسجيل الدخول | إعدادات ← هوية الوصول ← الجلسات النشطة |
| سجل التدقيق وتصديره | إعدادات → هوية الوصول → سجل التدقيق |
| التخطيط، وفترات توفر الوكلات، وائتمانات النماذج | إعدادات → الفوترة واستخدام الخدمات |
| التخزين، واحتفاظ البيانات، وتصدير الإعدادات | إعدادات → البيانات والقانونية |
| اسم المشروع، والمستودع، والفروع، والوضع | مشروع إعدادات → عام و المستودع |
| متغيرات بيئة المشروع | مشروع إعدادات ← متغيرات البيئة |
| ما تقرأه الوكلات عن المشروع | مشروع إعدادات ← معرفة ← سياق |
| مراجعة الأدلة من أدوات العميل | مشروع إعدادات ← تكاملات |
| فحوصات، وضبط جودة، ومصادر الطلبات، وطلبات السحب، و"عند حدوث خلل" | ضبط الجودة |
| قواعد مكافحة المحتوى غير المرغوب فيه وتنظيف الديون الأسبوعي | ضبط الجودة |
| الأهداف | ضبط جودة ← الإعداد الافتراضي للمؤسسة ← التسليم |
| حمايات الأمان، ونماذج التهديدات، وسطح الهجوم | أمان → مشاريع |
| اللغات، وفحوصات الترجمة، والمساهمون | العولمة |
| بيئات الإصدار، وقواعد الموافقة، وسلسلة النشر، وإصدار النسخ | إصدارات ← إعدادات الإصدار |
| أتمتة الأحداث والجداول الزمنية | مصنع ← أتمتة، تم إنشاؤه في عمل جديد |
| تقارير مجدولة | مصنع → تقارير |
| سير العمل وجداول القواعد | سير العمل |
| تعليمات الوكلات | AGENTS.md وملفات الذاكرة الأخرى في المستودع |
| مراجعة القواعد | REVIEW.md و review-rules مجلد في المستودع |
| المهارات | skills/<name>/SKILL.md في المستودع |
الـ خادم MCP الخاص بـ CoRoid يمكن تغيير العديد من هذه الإعدادات عبر مساعد، ضمن الأدوات المفعلة.
حاجة لا تغطيها أي أداة أخرى
إذا لم تتطابق أي صفوف في الجدول مع القاعدة، فلا داعي لبناء حل حول المنتج. أرسل الحاجة إلى CoRoid كطلب عبر صفحة الاتصال. اكتب:
- وضع العميل، دون بيانات خاصة به.
- ما جربته مع الإعدادات المذكورة أعلاه.
- ما يحتاجه العميل وسبب ذلك.
أي تغيير يقوم به CoRoid يصل إلى جميع العملاء في إصدار واحد.
عند الانتهاء
- لكل قاعدة في مستند الاكتشاف إعداد، أو طلب موجه إلى CoRoid.
- كل قرار له سبب مسجل في ملاحظاتك.
- مهمة واحدة في كل مشروع تصل إلى pull request بعد إجراء الفحوصات.
ذات صلة
- نظرة عامة على الإعدادات
- تجريبي، المرحلة التالية