الأتمتة والجدولة

مهام Cron

جدوِل إيقاظ الوكلاء بتوقيت دقيق. تستمر مهام Cron عبر إعادة تشغيل البوابة وتدعم أنماط جدولة مرنة.

أنواع الجدولة

أهداف الجلسة

• الجلسة الرئيسية, إضافة إلى قائمة الانتظار كحدث نظام في المحادثة الرئيسية للوكيل
• الجلسة المعزولة, التشغيل في جلسة مخصصة (cron:<jobId>) لتجنب تلويث المحادثات الرئيسية

أوضاع التسليم

تذكيرات لمرة واحدة

اضبط تذكيراً لوقت محدد. يستيقظ الوكيل ويعالج التذكير ويحذف المهمة اختيارياً بعد التشغيل.

المهام المتكررة

جدوِل المهام المتكررة بتعبيرات cron ودعم المنطقة الزمنية. تتبع المهام سجل تنفيذها (نجاح، فشل، توقيت).

Webhooks

استقبال الأحداث من الخدمات الخارجية وتوجيهها إلى الوكلاء.

Gmail Pub/Sub

التكامل مع نظام الإشعارات الفورية لـ Gmail لتشغيل إجراءات الوكيل عند وصول رسائل بريد إلكتروني:

1. إعداد موضوع واشتراك GCP Pub/Sub
2. تكوين تصفية علامات Gmail
3. توجيه التسليم الفوري إلى عنوان URL الـ webhook الخاص بك
4. يستقبل Neotask الرسائل ويضيف أحداث الوكيل إلى قائمة الانتظار

Webhooks مخصصة

تسجيل نقاط نهاية HTTP التي تشغّل دورات الوكيل عند استدعائها. مفيد للتكامل مع خطوط أنابيب CI/CD وأنظمة المراقبة وأي خدمة يمكنها إرسال طلبات HTTP.

أحداث النظام

أحداث النظام هي إشارات تيقظ الوكيل للمعالجة:

• فوري, المعالجة في نبضة القلب التالية
• نبضة القلب التالية, إضافة إلى قائمة الانتظار لعملية تسجيل وصول مجدولة

استخدم أحداث النظام لسير العمل التفاعلي, يستيقظ الوكلاء عند حدوث شيء ما بدلاً من جدول زمني ثابت.

نبضة القلب

نبضة القلب إشارة دورية (الافتراضية ~15 ثانية) تمنح الوكلاء فرصة لمعالجة العمل المعلق:

• التحقق من أحداث النظام الجديدة
• معالجة الرسائل في قائمة الانتظار
• تشغيل عمليات الأتمتة المعلقة

يمكن تفعيل نبضة القلب أو تعطيلها أو تكوينها لكل وكيل على حدة.

الخطافات

أتمتة مدفوعة بالأحداث تشغّل أوامر الطرفية أو السكريبتات استجابةً لأحداث البوابة:

• عند استقبال رسالة, التنفيذ عند استقبال رسالة
• عند دور الوكيل, التنفيذ قبل أو بعد معالجة الوكيل للرسالة
• عند حدث قناة, التنفيذ عند أحداث خاصة بالقناة (الانضمام، المغادرة، رد الفعل)

تعمل الخطافات على مضيف البوابة ولها إمكانية الوصول إلى بيانات سياق الحدث.

حالات الاستخدام