| ধরন | কখন চলে |
|---|---|
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}} পূরণ হয় কর্মীর ইনপুটগুলোতে মালিকের দেওয়া উত্তর থেকে। কোনো প্লেসহোল্ডারের উত্তর না থাকলে watch চালু হয় না।
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 কর্মীর উত্তর দেওয়া এমন প্রতিটি লাইনে প্রযোজ্য, যার জন্য আরও নির্দিষ্ট কোনো ট্রি নেই। একটি কল ট্রিতে ঠিক একটি অভিবাদন এবং অন্তত একটি নামযুক্ত ইনটেন্ট থাকতে হবে।
ওয়েবহুক
মালিক একজন কর্মীর জন্য একটি ওয়েবহুকও তৈরি করতে পারেন। কোনো ওয়ার্কফ্লোর সাথে যুক্ত ওয়েবহুক সেই ওয়ার্কফ্লো চালায়; ওয়ার্কফ্লো ছাড়া একটি ওয়েবহুক তার পেলোড কর্মীর চ্যাটে পৌঁছে দেয়।