المشغلات

تحدد المشغلات كيفية بدء سير العمل في ADK Studio. يبدأ كل سير عمل بعقدة Trigger تحدد نقطة الدخول — سواء من إدخال المستخدم، أو HTTP webhook، أو جدول زمني cron، أو حدث خارجي.

أنواع المشغلات

---

المشغلات اليدوية

نوع المشغل الافتراضي. عندما يحتوي سير العمل على مشغل يدوي، يتم عرض إدخال الدردشة مع تسمية وعنصر نائب قابلين للتكوين.

التكوين:

يظهر تسمية الإدخال فوق حقل إدخال الدردشة، ويُستخدم الموجه الافتراضي كنص نائب.

---

مشغلات الويب هوك

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

التكوين:

نقاط النهاية

ينشئ كل مشغل webhook نقطتي نهاية:

تعمل خطافات الويب (webhooks) من نوع GET أيضًا:

GET /api/projects/:id/webhook/my-path?message=Hello

المصادقة

رمز المالك (Bearer token):

curl -X POST "http://localhost:3000/api/projects/{id}/webhook/my-path" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"message": "Process this"}'

مفتاح API:

curl -X POST "http://localhost:3000/api/projects/{id}/webhook/my-path" \
  -H "X-API-Key: $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"message": "Process this"}'

إشعارات أحداث خطاف الويب

اشترك في أحداث تنفيذ خطاف الويب (webhook) في الوقت الفعلي عبر SSE:

GET /api/projects/:id/webhook-events

يبث هذا التدفق الأحداث عند استلام خطافات الويب (webhooks) ومعالجتها.

---

مشغلات الجدولة

قم بتشغيل سير العمل (workflows) بجدول زمني متكرر باستخدام تعبيرات cron.

التكوين:

صيغة Cron

تعبيرات cron القياسية المكونة من 5 حقول:

┌───────────── minute (0-59)
│ ┌───────────── hour (0-23)
│ │ ┌───────────── day of month (1-31)
│ │ │ ┌───────────── month (1-12)
│ │ │ │ ┌───────────── day of week (0-6, Sun=0)
│ │ │ │ │
* * * * *

أمثلة:

تتبع خدمة الجدولة last_executed طوابع زمنية لمنع التشغيل المكرر.

---

مشغلات الأحداث

ابدأ سير العمل استجابةً لأحداث النظام الخارجية. تتم مطابقة الأحداث بواسطة source و eventType، مع تصفية JSONPath اختيارية على بيانات الحدث.

التكوين:

إرسال الأحداث

curl -X POST "http://localhost:3000/api/projects/{id}/events" \
  -H "Content-Type: application/json" \
  -d '{
    "source": "payment-service",
    "eventType": "payment.completed",
    "data": {
      "orderId": "12345",
      "amount": 99.00,
      "status": "active"
    }
  }'

مرشحات JSONPath

قم بتصفية الأحداث بحيث يتم تشغيل سير العمل فقط عند استيفاء شروط محددة:

يتم تجاهل الأحداث التي لا تتطابق مع الفلتر بصمت.

---

زر التشغيل المتكيف مع المشغل

تتكيف واجهة مستخدم Studio بناءً على نوع المشغل النشط:

• يدوي — إدخال دردشة قياسي مع التسمية والعنصر النائب المكونين
• خطاف الويب — يرسل زر التشغيل حمولة خطاف ويب محاكاة
• جدول زمني — يرسل زر التشغيل المطالبة الافتراضية المكونة
• حدث — يرسل زر التشغيل حمولة حدث محاكاة

عندما يتغير سير العمل منذ آخر بناء، يتحول زر الإرسال إلى زر بناء للمطالبة بإعادة الترجمة.

---

API مرجع

السابق: ← عقد الإجراءات | التالي: إرشادات التطوير →