الخطافات

يستجيب الـ hook لحدث ما يحدث في Coroid. يمكنك اختيار حدث، وكتابة التعليمات بلغة بسيطة، وسيتم تشغيل الـ hook عند وقوع الحدث.

يمكن العثور عليها في المصنع، ضمن قسم التلقيات.

لإنشاء عنصر في قسم العمل الجديد: اختر خيار الأتمتة، ثم حدد خيار عند حدوث شيء ما. يوفر قسم العمل الجديد أحداث GitHub وأحداث Coroid. اطلع على التلقيات.

الأحداث التي يمكن الاستجابة لها#

يتم تشغيل الـ hook فقط للحدث الذي ترسله جهة ما. ترسل Coroid معظم الأحداث المذكورة أدناه، بينما تُطلق بعضها أنظمةك الخاصة. أي حدث آخر محجوز؛ لا يعرضه المحرر، ويتم رفض إنشاء hook جديد له. إذا تم حفظ hook على حدث محجوز، فإن المحرر والقائمة يصنفانه على أنه لن يتم تشغيله، دون حذفه.

أحداث ترسلها Coroid

الأحداث التي تطلقها أنظمةك الخاصة

لا ترسل Coroid هذه الأحداث. تقوم خط أنابيب CI أو أداة مسح أو أي نظام آخر تابع لك بإطلاق الـ hook عبر معرفه: حيث يتم استدعاء POST /api/v1/organizations/hooks/:id/dispatch مع مفتاح حساب خدمة الذي يحمل hooks:dispatch النطاق. يتم تشغيل الـ hook للحدث الذي تم حفظه عليه. يعرض المحرر هذه الأحداث تحت عنوان «يطلقها أنظمةك الخاصة».

الأحداث المحجوزة

لم يتم إرسالها أو إطلاقها بعد، لذا لا يعرضها المحرر:

مواعيد بدء وانتهاء العمل#

ترسل الخطط والجداول الزمنية والتقارير وفحوصات الجودة والترويج والإصدارات حدثًا عند بدء العمل وحدثًا عند انتهائه. يمكن للـ hook الاستجابة لطريقة انتهاء العمل، ويمكن لنظامك قياس المدة التي استغرقها.

يسجل كل حدث من هذه الأحداث توقيت حدوثه في occurredAt. كما يسجل الحدث الذي يوضح كيف انتهى العمل توقيت بدء العمل في startedAt، والمدة التي استغرقها في durationMs. ذلك startedAt هو occurredAt من حدث البدء، لذا فإن الاثنين يتطابقان دائمًا. الوقت الذي تُقضى فيه العملية في حالة توقف يُحتسب ضمن المدة.

يتم إرسال كل حدث مرة واحدة عند حفظ التغيير. التغيير الذي يتم إلغاؤه لا يُرسل أي شيء، وإعادة المحاولة لا تُرسل شيئًا مرتين. أما الحدث النهائي فيتم إرساله فقط للعمل الذي بدأ: عملية تنفيذ الجدول الزمني التجريبية لا تُرسل شيئًا، وكذلك التقرير الذي تم إلغاؤه قبل بدءه.

ما يحمله كل حدث، بخلاف الأوقات:

الأحادث المتعلقة بالعمل في مشروع ما تحمل أيضًا projectId، لذا فإن الربط المحدود بمشروع واحد يُفعّل فقط لتلك المشاريع. إذا كان الربط هو من أنشأ العمل، فإن هذه الأحادث تُحتسب ضمن عمق سلسلة ذلك الربط.

المحفزات والوجهات#

لكل عملية أتمتة مصدر محفز، وهو مصدر الأحادث الخاصة بها، و وجهة تحدد ما يحدث عند تشغيلها. اثنتان من الوجهات تحول الحدث إلى عمل.

تحتاج أحداث GitHub إلى تطبيق GitHub. التعليق الذي يذكر Coroid لا يُحتسب إلا عندما يكون لدى كاتبه صلاحيات كتابة على المستودع. انظر GitHub.

تبدأ مهمة من عملية تأهيل العمل بمفردها فقط عندما يكون مؤلف الحدث موثوقًا به: مؤلف GitHub pull request، المسألة أو التعليق الذي لديه صلاحيات كتابة على المستودع. مؤلفي Slack وTelegram وJira غير موثوق بهم، لذا تنتظر مهامهم من يبدأها. انظر متى يبدأ العمل.

تصل المسائل الجديدة في Jira إلى Coroid فقط عبر ويبهوك Jira الخاص به. يقبل الويبهوك فقط التسليمات الموقعة بسرّ الويبهوك المُعدّ لـ Coroid، وفقط للمسائل الجديدة، وعندما يتطابق مفتاح مشروع Jira مع مشروع Coroid. على coroid.ai لم يتم إعداد ويبهوك Jira بعد، لذا لا يتلقى مشغّل Jira أي أحداث؛ يمكنك استيراد مسائل Jira بدلاً من ذلك. حيثما يتم إعداد الويبهوك، تذهب المسألة الجديدة إلى عمليات الأتمتة في مشغّل Jira، مثل مصدر طلب Jira في قسم ضبط الجودة، الذي يُنشئ مسائل من الأنواع والأولويات التي تختارها للتأهيل. بدون وجود أتمتة في المشغّل، لا تُنشئ المسألة الجديدة أي شيء. لا تبدأ العمليات من Jira تلقائيًا. انظر أدوات تتبع المسائل.

للقراءة فقط بشكل افتراضي#

تحلل الوصلات وتقدم تقارير عنها. يمكنها إنشاء أعمال تابعة؛ لكنها لا تعدّل كودك مباشرة.

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

كتابة تعليمات جيدة#

تُعالج تعليمات الوصلات بواسطة نموذج، لذا تبدو كتعليمات موجهة لزميل بدلاً من كونها كودًا. معيار الجودة مماثل لما هو مطلوب لـ مواصفة: حدد ما يجب مراقبته، وما هو المهم، وما يجب فعله.

كن دقيقًا بشأن حالة «عدم فعل أي شيء». بدون ذلك، ستجد الوصلة دائمًا ما تقوله كلما تم تشغيلها، والوصلات التي تعمل باستمرار هي وصلات يتوقف الناس عن قراءتها.

ضوابط أمان#

توجد ثلاث حمايات لأن الأتمتة القائمة على الأحداث تفشل بطرق متوقعة:

حدود معدل التنفيذ. لكل دقيقة، وكل ساعة، وكل يوم، ويمكن تهيئتها لكل وصلة. وإلا، قد تُشغّل الوصلة المرتبطة بحدث ذي تردد عالٍ مئات المرات خلال عملية دمج نشطة.

عمق السلسلة. يمكن للوصلات تشغيل أحداث تؤدي إلى تشغيل وصلات أخرى. يوقف الحد الأقصى لعمق السلسلة حدوث حلقة لا نهائية.

أذونات الأداة. ما يمكن للوصلة الوصول إليه يتم التحكم فيه — الوصول للقراءة فقط، ومكالمات MCP، وإنشاء المهام تخضع جميعها لقواعد منفصلة.

أذونات#

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

مراقبتها#

تُدرج صفحة كل وصلة في المنصة عمليات التشغيل التي قامت بها وما فعلته خلال آخر 30 يومًا: عمليات التشغيل، والإخفاقات، والتكلفة. كما توجد كل عمليات الأتمتة في قسم إعدادات → نشاط، مع تصفية النتائج حسب فئة الأتمتة. تحقق من عمليات التشغيل بعد تفعيل وصلة جديدة — فوضع الإخفاق ليس خطأً، بل هو التشغيل المستمر دون إنتاج أي نتيجة تستدعي تدخلاً من أحد.

الوصلات والجداول الزمنية#

كلاهما أتمتة، وتُدرج معًا في المنصة. انظر عمليات الأتمتة.

ذات صلة#

• نظرة عامة على التكاملات