ट्रिगर

ट्रिगर परिभाषित करते हैं कि ADK Studio में वर्कफ़्लो कैसे शुरू होते हैं। प्रत्येक वर्कफ़्लो एक Trigger नोड से शुरू होता है जो प्रवेश बिंदु निर्धारित करता है — चाहे वह उपयोगकर्ता इनपुट से हो, एक HTTP webhook से हो, एक cron schedule से हो, या किसी बाहरी घटना से हो।

ट्रिगर प्रकार

---

मैनुअल ट्रिगर

यह डिफ़ॉल्ट ट्रिगर प्रकार है। जब किसी वर्कफ़्लो में मैनुअल ट्रिगर होता है, तो चैट इनपुट को एक कॉन्फ़िगर करने योग्य लेबल और प्लेसहोल्डर के साथ दिखाया जाता है।

कॉन्फ़िगरेशन:

इनपुट लेबल चैट इनपुट फ़ील्ड के ऊपर दिखाई देता है, और डिफ़ॉल्ट प्रॉम्प्ट प्लेसहोल्डर टेक्स्ट के रूप में उपयोग किया जाता है।

---

वेबहुक ट्रिगर्स

एक HTTP एंडपॉइंट उजागर करें जो कॉल किए जाने पर वर्कफ़्लो शुरू करता है। बाहरी सेवाओं, CI/CD पाइपलाइनों, या अन्य अनुप्रयोगों के साथ एकीकृत करने के लिए उपयोगी।

कॉन्फ़िगरेशन:

एंडपॉइंट्स

प्रत्येक वेबहुक ट्रिगर दो एंडपॉइंट बनाता है:

GET वेबहुक भी काम करते हैं:

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

प्रमाणीकरण

बियरर टोकन:

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"}'

वेबहुक इवेंट सूचनाएं

SSE के माध्यम से रीयल-टाइम वेबहुक निष्पादन इवेंट्स की सदस्यता लें:

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

यह स्ट्रीम वेबहुक प्राप्त होने और संसाधित होने पर इवेंट्स उत्सर्जित करती है।

---

शेड्यूल ट्रिगर

क्रॉन एक्सप्रेशन का उपयोग करके वर्कफ़्लो को आवर्ती शेड्यूल पर चलाएं।

कॉन्फ़िगरेशन:

क्रॉन सिंटैक्स

मानक 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 फ़िल्टर

इवेंट्स को फ़िल्टर करें ताकि वर्कफ़्लो तभी ट्रिगर हो जब विशिष्ट शर्तें पूरी हों:

फ़िल्टर से मेल न खाने वाली घटनाओं को चुपचाप अनदेखा कर दिया जाता है।

---

ट्रिगर-जागरूक रन बटन

स्टूडियो UI सक्रिय ट्रिगर प्रकार के आधार पर अनुकूलित होता है:

• मैनुअल — कॉन्फ़िगर किए गए लेबल और प्लेसहोल्डर के साथ मानक चैट इनपुट
• Webhook — रन बटन एक सिम्युलेटेड वेबहुक पेलोड भेजता है
• शेड्यूल — रन बटन कॉन्फ़िगर किया गया डिफ़ॉल्ट प्रॉम्प्ट भेजता है
• इवेंट — रन बटन एक सिम्युलेटेड इवेंट पेलोड भेजता है

जब अंतिम बिल्ड के बाद से किसी वर्कफ़्लो में बदलाव हुआ हो, तो रीकंपाइलेशन को प्रॉम्प्ट करने के लिए सेंड बटन बिल्ड बटन में बदल जाता है।

---

API संदर्भ

पिछला: ← Action Nodes | अगला: विकास दिशानिर्देश →