| प्रकार | कब चलता है |
|---|---|
schedule | कोई cron एक्सप्रेशन मेल खाता है। |
heartbeat | एक अंतराल बीतता है, चाहें तो रोज़ की एक समय-खिड़की के अंदर। |
event | मेल खाते स्रोत वाला कोई इवेंट भेजा जाता है। |
watch | कोई प्लगइन वॉचर आउटपुट की एक लाइन लिखता है। |
folder | किसी फ़ोल्डर में फ़ाइलें बदलती हैं। |
manual | मालिक या कोई कर्मचारी इसे चलाता है। |
call | कोई फ़ोन लाइन बजती है। केवल फ़ोन कॉल ट्री में। |
schedule
{ "type": "schedule", "cron": "0 8 * * 1-5", "schedule": "Weekdays at 8:00" } cron पाँच फ़ील्ड वाला cron एक्सप्रेशन है: मिनट, घंटा, महीने का दिन, महीना, हफ़्ते का दिन। schedule लोगों के लिए एक वैकल्पिक विवरण है। शेड्यूल बॉट के स्थानीय टाइम ज़ोन में चलते हैं। Nebo हर पाँच सेकंड में शेड्यूल जाँचता है। बॉट बंद रहने के दौरान छूटा रन, अगर एक घंटे से कम देर हुई हो, तो एक बार पूरा कर लिया जाता है। पिछला रन चल रहा हो तो नया रन छोड़ दिया जाता है।
heartbeat
{ "type": "heartbeat", "interval": "30m", "window": "08:00-18:00" } interval एक अवधि है, जैसे 30m, 1h या 2h30m। window, HH:MM-HH:MM, रन को कामकाजी घंटों के अंदर रखता है। अगला रन पिछले रन के समय में अंतराल जोड़कर, खिड़की के अंदर खिसकाकर तय होता है; पहला रन वर्कफ़्लो लोड होने के एक अंतराल बाद होता है। टाइमर रीस्टार्ट के बाद भी बने रहते हैं। पिछला रन चल रहा हो तो नया रन छोड़ दिया जाता है, और अमान्य अंतराल कभी नहीं चलता।
event
{ "type": "event", "sources": ["support-coordinator.summary.ready", "assignment.*"] } sources उन इवेंट नामों की सूची है जिनका पूरा मेल हो, या अंत में .* वाइल्डकार्ड के साथ। खाली सूची एक त्रुटि है जो पूरी agent.json को अस्वीकार कर देती है। रन को _event_source, _event_payload और _event_origin मिलते हैं। नाम कैसे बनते हैं, यह जानने के लिए इवेंट देखें।
watch
{ "type": "watch", "plugin": "mail", "event": "email.new" } watch एक प्लगइन प्रोसेस को चलता रखता है और उसकी लिखी हर लाइन के लिए एक रन शुरू करता है। हर लाइन _watch_payload के रूप में आती है। दस मिनट के अंदर एक जैसी लाइनें छोड़ दी जाती हैं।
| फ़ील्ड | डिफ़ॉल्ट | अर्थ |
|---|---|---|
plugin | ज़रूरी | एक क्षमता, जैसे mail, या प्लगइन का slug। जब भी कोई क्षमता फ़िट हो, उसी का नाम लिखें। |
event | कोई नहीं | प्लगइन की events सूची का एक इवेंट। Nebo उस इवेंट की कमांड इस्तेमाल करता है और हर लाइन को <plugin>.<event> के रूप में भी भेजता है। |
command | कोई नहीं | वॉचर शुरू करने वाले आर्ग्युमेंट। सेट होने पर इस्तेमाल होते हैं; वरना event से लिए जाते हैं। |
restart_delay_secs | 5 | बंद होने वाले वॉचर को फिर से शुरू करने से पहले रुकें। |
क्षमता उस इंस्टॉल किए गए प्लगइन पर पहुँचती है जो उसे देता है, और उसे प्राथमिकता मिलती है जिस पर इस कर्मचारी का अकाउंट हो। ऐसा कोई प्लगइन न हो, तो वर्कफ़्लो अधूरा चिह्नित होता है और मालिक को बताया जाता है कि क्या कनेक्ट करना है। बार-बार क्रैश होने वाला वॉचर ऐसी देरी के साथ फिर से शुरू होता है जो 300 सेकंड तक दोगुनी होती जाती है और 30 सेकंड चलने के बाद रीसेट हो जाती है।
{ "type": "watch", "plugin": "notes-sync", "command": "watch --notebook {{notebook}} --format ndjson" } command में {{key}}, कर्मचारी के इनपुट पर मालिक के जवाबों से भरा जाता है। अगर किसी प्लेसहोल्डर का जवाब नहीं है, तो वॉच शुरू नहीं होता।
folder
{ "type": "folder", "path": "{{inbox_folder}}", "extensions": ["pdf"], "recursive": false } | फ़ील्ड | डिफ़ॉल्ट | अर्थ |
|---|---|---|
path | ज़रूरी | फ़ोल्डर का पूरा पाथ। {{key}} इनपुट से भरा जाता है। |
extensions | सभी फ़ाइलें | मिलाने के लिए फ़ाइल एक्सटेंशन, डॉट के बिना। |
recursive | true | सबफ़ोल्डर शामिल करें। |
debounce_secs | 2 | इस समय-खिड़की के अंदर के बदलाव एक रन बन जाते हैं। |
रन को बदले हुए पाथ _watch_payload.files में मिलते हैं।
manual
{ "type": "manual" } manual वर्कफ़्लो तभी चलता है जब मालिक उसे चलाए या कोई कर्मचारी run_workflow कॉल करे। हर वर्कफ़्लो, उसका ट्रिगर जो भी हो, इस तरह भी चलाया जा सकता है।
call
{"type": "call", "line": "..."} सिर्फ़ "type": "call_tree" वाले वर्कफ़्लो में मान्य है, जो यह कॉन्फ़िगर करता है कि कर्मचारी किसी फ़ोन लाइन का जवाब कैसे देता है। खाली line उन सभी लाइनों पर लागू होती है जिनका कर्मचारी जवाब देता है और जिनके लिए कोई ज़्यादा विशिष्ट ट्री नहीं है। कॉल ट्री में ठीक एक अभिवादन और कम से कम एक नाम वाला इंटेंट होना चाहिए।
वेबहुक
मालिक किसी कर्मचारी के लिए वेबहुक भी बना सकता है। वर्कफ़्लो से जुड़ा वेबहुक उस वर्कफ़्लो को चलाता है; बिना वर्कफ़्लो वाला वेबहुक अपना पेलोड कर्मचारी की चैट में पहुँचाता है।