कोर ट्रिगर्स

कोर ट्रिगर्स सबसे सामान्य वर्क़्फ़्लो प्रवेश बिंदुओं को कवर करते हैं: मैनुअल आह्वान, शेड्यूल किए गए रन, आने वाले HTTP अनुरोध और फ़ाइल अपलोड।

मैनुअल इनपुट

किसी उपयोगकर्ता या बाहरी सिस्टम द्वारा स्पष्ट रूप से आह्वान किए जाने पर वर्क़्फ़्लो शुरू करता है। आप इसे कस्टम इनपुट फ़ील्ड्स के साथ कॉन्फ़िगर कर सकते हैं जिन्हें वर्क़्फ़्लो चलाने से पहले भरना होगा — इसे मांग-आधारित कार्यों के लिए आदर्श बनाता है जिन्हें उपयोगकर्ता-प्रदान संदर्भ की आवश्यकता होती है, जैसे अनुरोध सबमिट करना, रिपोर्ट शुरू करना, या EKB चैट इंटरफ़ेस से प्रक्रिया आरंभ करना।

कब उपयोग करें

• आप EKB UI से या API के माध्यम से मांग पर वर्क़्फ़्लो चलाना चाहते हैं।
• वर्क़्फ़्लो को निष्पादित करने से पहले उपयोगकर्ता-प्रदान इनपुट्स की आवश्यकता है।
• आप विशिष्ट मानों के साथ वर्क़्फ़्लो का परीक्षण या डीबग कर रहे हैं।

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

फ़ील्ड	प्रकार	विवरण
इनपुट फ़ील्ड्स	कोई भी	उपयोगकर्ता-परिभाषित पैरामीटर जो ट्रिगर सेटिंग्स में कॉन्फ़िगर किए जाते हैं। प्रत्येक फ़ील्ड में नाम, प्रकार और रनटाइम पर उपयोगकर्ता को दिखाया जाने वाला वैकल्पिक विवरण होता है।

आउटपुट वेरिएबल्स

वेरिएबल	विवरण
trigger.user_input	उपयोगकर्ता द्वारा सबमिट किया गया कच्चा पाठ।
trigger.inputs.<field>	प्रत्येक नामित इनपुट फ़ील्ड का मान। <field> को कॉन्फ़िगर किए गए फ़ील्ड नाम से बदलें (जैसे trigger.inputs.customer_name)।
trigger.chat_id	रन शुरू करने वाली चैट सत्र की ID।
trigger.message_id	जिस संदेश ने वर्क़्फ़्लो ट्रिगर किया उसकी ID।

Hello {{ trigger.inputs.customer_name }}, your request has been received.

नोट्स

• इनपुट फ़ील्ड्स वर्क़्फ़्लो शुरू होने से पहले उपयोगकर्ता को एक फ़ॉर्म के रूप में प्रस्तुत किए जाते हैं। फ़ील्ड नाम छोटे और वर्णनात्मक रखें।
• यदि कोई कस्टम इनपुट फ़ील्ड्स कॉन्फ़िगर नहीं किए गए हैं तो भी trigger.user_input उपलब्ध है।
• इस ट्रिगर को प्रोग्रामेटिक रूप से आह्वान करने के लिए, वर्क़्फ़्लो ID और आवश्यक इनपुट मानों के साथ EKB API को कॉल करें।

वेबहुक

आपके वर्क़्फ़्लो के लिए एक अद्वितीय HTTP एंडपॉइंट उजागर करता है। बाहरी सिस्टम — जैसे तीसरे पक्ष के एप्लिकेशंस, ऑटोमेशन प्लेटफ़ॉर्म, या कस्टम स्क्रिप्ट — वर्क़्फ़्लो शुरू करने के लिए उस URL को HTTP अनुरोध भेज सकते हैं। अनुरोध बॉडी, हेडर्स, क्वेरी पैरामीटर्स और HTTP विधि सभी डाउनस्ट्रीम नोड्स को पास की जाती हैं।

कब उपयोग करें

• किसी घटना होने पर बाहरी सिस्टम को EKB को सूचित करने की आवश्यकता है (जैसे फ़ॉर्म सबमिशन, भुगतान घटना, या किसी अन्य प्लेटफ़ॉर्म से अपडेट)।
• आप EKB को Automation Anywhere या किसी अन्य सिस्टम के साथ इंटीग्रेट कर रहे हैं जो HTTP एंडपॉइंट को कॉल कर सकता है।
• आप वर्क़्फ़्लो को एक API एंडपॉइंट के रूप में उजागर करना चाहते हैं जिसे अन्य डेवलपर्स या टूल्स कॉल कर सकें।

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

सेटिंग	प्रकार	विवरण
http_method	स्ट्रिंग	एंडपॉइंट द्वारा स्वीकार की जाने वाली HTTP विधि: GET, POST, PUT, PATCH, या DELETE।
auth_type	स्ट्रिंग	आने वाले अनुरोध कैसे प्रमाणित होते हैं: none, basic, या header।
response_mode	स्ट्रिंग	onReceived अनुरोध आने पर तुरंत HTTP 200 लौटाता है। lastNode वर्क़्फ़्लो पूरा होने की प्रतीक्षा करता है और अंतिम आउटपुट को HTTP प्रतिक्रिया के रूप में लौटाता है।

आउटपुट वेरिएबल्स

वेरिएबल	विवरण
trigger.body	आने वाले अनुरोध की JSON बॉडी।
trigger.headers	अनुरोध के साथ भेजे गए HTTP हेडर्स।
trigger.query	अनुरोध से URL क्वेरी पैरामीटर्स।
trigger.method	कॉलर द्वारा उपयोग की जाने वाली HTTP विधि।
trigger.webhook_url	वेबहुक एंडपॉइंट का पूर्ण URL। इसे उस बाहरी सिस्टम के साथ साझा करें जो वर्क़्फ़्लो को कॉल करेगा।

प्रतिक्रिया मोड

मोड	व्यवहार
onReceived	अनुरोध आते ही अपूर्ण HTTP 200 OK तुरंत लौटाता है, वर्क़्फ़्लो पूरा होने से पहले। फ़ायर-एंड-फ़ोर्गेट परिदृश्यों के लिए उपयोग करें।
lastNode	वर्क़्फ़्लो पूरा होने तक HTTP कनेक्शन खुला रखता है, फिर अंतिम नोड आउटपुट को प्रतिक्रिया बॉडी के रूप में लौटाता है। तब उपयोग करें जब कॉलर समकालीन पेलोड की अपेक्षा करता है।

नोट्स

• header प्रमाणीकरण का उपयोग करते समय, ट्रिगर सेटिंग्स में अपेक्षित हेडर नाम और मान कॉन्फ़िगर करें।
• trigger.webhook_url इंटीग्रेशन पार्टनर को भेजे जाने वाले सेटअप दस्तावेज़ में एंडपॉइंट URL शामिल करने के लिए उपयोगी है।
• यदि आप Automation Anywhere से इस वेबहुक को कॉल कर रहे हैं, तो वेबहुक URL पर पोस्ट करने के लिए अपने बॉट में HTTP Task क्रिया का उपयोग करें।

शेड्यूल

क्रॉन एक्सप्रेशन द्वारा परिभाषित पुनरावृत्ति करने वाले शेड्यूल पर स्वचालित रूप से वर्क़्फ़्लो फ़ायर करता है। समय-आधारित कार्यों जैसे दैनिक रिपोर्ट, आवधिक डेटा सिंक, या पुनरावृत्ति करने वाली सूचनाओं को स्वचालित करने के लिए इसका उपयोग करें — बिना किसी मैनुअल हस्तक्षेप के।

कब उपयोग करें

• आपको हर दिन, सप्ताह या माह एक निश्चित समय पर वर्क़्फ़्लो चलाने की आवश्यकता है।
• आप एक पुनरावृत्ति करने वाली व्यापार प्रक्रिया स्वचालित कर रहे हैं (जैसे हर सुबह डेटा खींचना, साप्ताहिक सारांश भेजना)।
• आप नियमित अंतराल पर बाहरी सिस्टम को पोल करना चाहते हैं।

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

सेटिंग	प्रकार	विवरण
schedule	स्ट्रिंग	वर्क़्फ़्लो कब चलता है, यह परिभाषित करने वाला क्रॉन एक्सप्रेशन।
timezone	स्ट्रिंग	वह टाइमज़ोन जिसमें क्रॉन एक्सप्रेशन मूल्यांकित होता है। UTC या America/New_York जैसे मानक टाइमज़ोन नाम स्वीकार करता है।

warning

हमेशा timezone फ़ील्ड को स्पष्ट रूप से सेट करें। यदि सेट नहीं किया गया, तो शेड्यूल UTC में चलता है, जो क्षेत्र-विशिष्ट वर्क़्फ़्लोज़ के लिए अप्रत्याशित टाइमिंग का कारण बन सकता है।

क्रॉन एक्सप्रेशन संदर्भ

क्रॉन एक्सप्रेशन में पाँच फ़ील्ड्स होते हैं: मिनट · घंटा · माह का दिन · माह · सप्ताह का दिन।

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

एक्सप्रेशन	शेड्यूल
0 9 * * *	हर दिन सुबह 9:00 बजे
0 9 * * 1	हर सोमवार सुबह 9:00 बजे
0 */6 * * *	हर 6 घंटे
0 8 1 * *	हर माह की पहली तिथि सुबह 8:00 बजे
*/15 * * * *	हर 15 मिनट

आउटपुट वेरिएबल्स

वेरिएबल	विवरण
trigger.trigger_time	शेड्यूल फ़ायर होने का ISO 8601 टाइमस्टैम्प।
trigger.schedule_expression	इस रन के लिए उपयोग किया गया क्रॉन एक्सप्रेशन।
trigger.trigger_type	हमेशा "schedule"।

नोट्स

• शेड्यूल ट्रिगर उपयोगकर्ता इनपुट पास नहीं करता। यदि आपके वर्क़्फ़्लो को गतिशील डेटा की आवश्यकता है, तो API नोड या टूलकिट टूल का उपयोग करके वर्क़्फ़्लो के अंदर उसे फ़ेच करें।
• शेड्यूल किए गए रन कब हुआ, यह टाइमस्टैम्प करने के लिए डाउनस्ट्रीम नोड्स में trigger.trigger_time का उपयोग करें।

फ़ाइल अपलोड

एक या अधिक फ़ाइलें अपलोड होने पर वर्क़्फ़्लो शुरू करता है। यह प्रत्येक फ़ाइल की सामग्री, नाम, आकार और MIME प्रकार डाउनस्ट्रीम नोड्स को प्रदान करता है — इसे दस्तावेज़ प्रसंस्करण वर्क़्फ़्लो के लिए आदर्श बनाता है जैसे अपलोड की गई रिपोर्ट पार्स करना, स्प्रेडशीट से डेटा निकालना, या विश्लेषण के लिए AI मॉडल को फ़ाइल रूट करना।

कब उपयोग करें

• आप चाहते हैं कि उपयोगकर्ता वर्क़्फ़्लो द्वारा संसाधित करने के लिए फ़ाइलें सबमिट करें (जैसे चालान, अनुबंध, CSV एक्सपोर्ट)।
• आपको अपलोड किए गए दस्तावेज़ों से सामग्री निकालनी है और उसे LLM या डेटा प्रसंस्करण नोड को पास करना है।
• आप बहु-फ़ाइल इनजेस्शन पाइपलाइन बना रहे हैं।

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

इस ट्रिगर को कोई आवश्यक कॉन्फ़िगरेशन फ़ील्ड्स की आवश्यकता नहीं है। जब वर्क़्फ़्लो के संबंधित चैट या इंटरफ़ेस में फ़ाइल अपलोड की जाती है तो यह स्वचालित रूप से सक्रिय हो जाता है।

आउटपुट वेरिएबल्स

एकल फ़ाइल

वेरिएबल	विवरण
trigger.file.content	अपलोड की गई फ़ाइल का पूर्ण निकाला गया पाठ सामग्री।
trigger.file.name	मूल फ़ाइलनाम।
trigger.file.size	फ़ाइल का आकार बाइट्स में।
trigger.file.type	MIME प्रकार (जैसे application/pdf, text/csv)।
trigger.file_count	अपलोड किए गए कुल फ़ाइलों की संख्या। एकल फ़ाइल के लिए 1 लौटाता है।

बहु फ़ाइलें

वेरिएबल	विवरण
trigger.files	सभी अपलोड की गई फ़ाइलों का एरे। प्रत्येक आइटम में content, name, size और type शामिल है।
trigger.file_count	अपलोड किए गए कुल फ़ाइलों की संख्या।

एकल रन में कई अपलोड को संसाधित करते समय trigger.files पर इटरेट करने के लिए लूप नोड का उपयोग करें।

नोट

फ़ाइल सामग्री को सादे पाठ के रूप में निकाला जाता है। PDF और Word दस्तावेज़ जैसे बाइनरी प्रारूप स्वचालित रूप से पार्स होते हैं — निकाला गया पाठ ही trigger.file.content में दिखाई देता है।

नोट्स

• trigger.file हमेशा पहली (या एकमात्र) अपलोड की गई फ़ाइल को संदर्भित करता है। बहु-फ़ाइल वर्क़्फ़्लोज़ के लिए, लूप नोड के साथ trigger.files का उपयोग करें।
• अलग-अलग फ़ाइल प्रकारों को अलग-अलग प्रसंस्करण शाखाओं में रूट करने के लिए कंडीशनल नोड में trigger.file.type का उपयोग करें।