প্রথম ওয়ার্কফ্লো
agent.json-এ একটি workflows ম্যাপ যোগ করুন। প্রতিটি কী একটি ওয়ার্কফ্লোর নাম দেয়; প্রতিটি মানে একটি ট্রিগার ও কার্যক্রম থাকে।
{
"workflows": {
"morning-summary": {
"trigger": { "type": "schedule", "cron": "0 8 * * 1-5" },
"description": "Summarize yesterday's open conversations every weekday morning.",
"activities": [
{ "id": "summarize", "intent": "Summarize yesterday's open customer conversations and what each one is waiting on." }
]
}
}
} এই ওয়ার্কফ্লোটি কর্মদিবসে বটের স্থানীয় সময় 08:00-এ চলে। কর্মী নিজের পারসোনা, দক্ষতা ও সংযোগ দিয়ে কার্যক্রমটি সম্পন্ন করে।
ওয়ার্কফ্লোর ফিল্ড
| ফিল্ড | অর্থ |
|---|---|
trigger | আবশ্যক। ওয়ার্কফ্লোটি কখন চলে। ট্রিগার দেখুন। |
description | ওয়ার্কফ্লোটি কীসের জন্য। |
activities | ধাপগুলো। কার্যক্রম দেখুন। |
connections | {from, to, label} এজ, যা কার্যক্রমগুলোকে একটি গ্রাফে পরিণত করে। __trigger__ হলো শুরু এবং __emit__ হলো শেষ। |
emit | এই ওয়ার্কফ্লো শেষ হলে যে ইভেন্টগুলো ঘোষণা করে: একটি তালিকা, অথবা কমা দিয়ে আলাদা করা একটি স্ট্রিং। ইভেন্ট দেখুন। |
inputs | প্রতিটি রানে পাঠানো মান। |
budget | {total_per_run, cost_estimate}। গ্রাফ রানে total_per_run আউটপুট টোকেন সীমিত করে; অন্যথায় দুটোই অনুমান। |
case | ওয়ার্কফ্লোটিকে প্রতি ব্যক্তি বা বিষয়ের জন্য একটি দীর্ঘমেয়াদি কেস বানায়। কেস দেখুন। |
ট্রিগার আছে কিন্তু কোনো কার্যক্রম নেই এমন ওয়ার্কফ্লোও বৈধ। কার্যক্রম ছাড়া একটি watch কেবল তার ইভেন্টগুলো অন্য ওয়ার্কফ্লোতে পাঠিয়ে দেয়।
একটি রান কীভাবে চলে
connections না থাকলে কার্যক্রমগুলো ক্রমানুসারে চলে এবং কর্মী প্রতিটি সম্পন্ন করে। প্রতিটি কার্যক্রমের ফলাফল পরেরটিতে পাঠানো হয়। আউটপুট নেই এমন কার্যক্রম রানটি শেষ করে দেয়।
connections থাকলে কার্যক্রমগুলো একটি গ্রাফ তৈরি করে। শাখাগুলো সমান্তরালে চলে, এবং ছয় ধরনের কার্যক্রম মডেল ছাড়াই চলে: condition, loop, wait, http, command এবং decide। রাউটিং যখন একদম নির্ভুল হতে হবে, তখন গ্রাফ ব্যবহার করুন।
{
"trigger": { "type": "watch", "plugin": "mail", "event": "email.new" },
"activities": [
{ "id": "classify", "type": "decide",
"params": {
"questions": {
"kind": {
"type": "choice",
"instructions": "What kind of message is this?",
"criteria": { "invoice": "A bill from a vendor", "other": "Anything else" }
}
},
"default": { "kind": "other" }
} },
{ "id": "is-invoice", "type": "condition", "params": { "expression": "nodes.classify.kind.choice == invoice" } },
{ "id": "record", "intent": "Record the invoice in _watch_payload as a bill and note the due date." }
],
"connections": [
{ "from": "__trigger__", "to": "classify" },
{ "from": "classify", "to": "is-invoice" },
{ "from": "is-invoice", "to": "record", "label": "True" },
{ "from": "record", "to": "__emit__" }
],
"emit": ["invoice.recorded"]
} একটি রান কী পায়
কর্মীর কাছে সবসময় তার পারসোনা এবং তার inputs প্রশ্নগুলোর উত্তরে মালিকের দেওয়া জবাব থাকে। ট্রিগারের উপর নির্ভর করে একটি রান এই মানগুলোও পায়।
| ইনপুট | কখন থাকে |
|---|---|
_event_source, _event_payload, _event_origin | একটি ইভেন্ট ট্রিগার চালু হলে। 8 KB বা তার বেশি পেলোড ছোট করে কেবল স্কেলার ফিল্ডগুলো রাখা হয়, ইমেইলের হেডার ও অ্যাটাচমেন্টের রেফারেন্স রেখে। |
_watch_payload | একটি watch বা ফোল্ডার ট্রিগার চালু হলে। ওয়াচারের আউটপুটের একটি লাইন, অথবা ফোল্ডারের ক্ষেত্রে {files}। |
inputs | সবসময়। ওয়ার্কফ্লোর নিজস্ব inputs মান। |
কেস
কিছু কাজ কয়েক দিন ধরে চলে: একটি লিড যার ফলো-আপ দরকার, একটি অনুরোধ যা ডকুমেন্টের অপেক্ষায় আছে। case যোগ করুন, তাহলে ওয়ার্কফ্লো প্রতিবার নতুন করে শুরু না করে প্রতি ব্যক্তি বা বিষয়ের জন্য একটি খোলা কেস রাখবে।
| ফিল্ড | অর্থ |
|---|---|
key | আবশ্যক। ট্রিগার ডেটার ভেতরে কমা দিয়ে আলাদা করা ডটেড পাথ, যা বিষয়টিকে শনাক্ত করে, যেমন contactEmail,email,phone। |
type | কেসের ধরন, যেমন lead। একই ধরনের ওয়ার্কফ্লোগুলো কেস ভাগাভাগি করে। ডিফল্ট হলো ওয়ার্কফ্লোর নাম। |
default_wait | কোনো টার্নে অপেক্ষার সময় বলা না থাকলে কতক্ষণ অপেক্ষা করবে: 3d, 12h, 45m। ডিফল্ট তিন দিন। |
একটি কেসের প্রতিটি টার্ন অবশ্যই একটি JSON অবজেক্ট দিয়ে শেষ হতে হবে, এবং তার পরে আর কিছু থাকবে না। result হলো ব্যবসায়িক অবস্থা; next ইঞ্জিনকে wait বা close করতে বলে। ডেডলাইন RFC 3339 বা আপেক্ষিক সময়কাল হতে পারে। এর বাইরে যেকোনো কিছু অবৈধ টার্ন।
{"result": {"status": "awaiting_documents", "summary": "Requested two bank statements"},
"next": {"action": "wait", "on": "signal", "deadline": "3d", "reason": "documents"}} সীমা ও পুনরুদ্ধার
params.maxIterationsঅন্য কিছু না বললে প্রতিটি কার্যক্রম সর্বোচ্চ 50টি মডেল টার্ন নিতে পারে।- একটি গ্রাফে একটি কার্যক্রম এক রানে সর্বোচ্চ 10,000 বার চলতে পারে।
- কর্মীর জন্য মালিকের খরচের সীমায় পৌঁছালে রান থেমে যায়। একটি কার্যক্রমের
token_budgetএকটি অনুমান মাত্র। - রিস্টার্টের কারণে থেমে যাওয়া একটি রানকে বাধাপ্রাপ্ত হিসেবে চিহ্নিত করা হয় এবং একবার আবার চালু করা হয়।
- কর্মী
exitটুল দিয়ে রান আগেভাগে শেষ করতে পারে।
ওয়ার্কফ্লো চালান ও পরিচালনা করুন
মালিক যেকোনো ওয়ার্কফ্লো নিজে হাতে চালাতে পারেন। কর্মীরা run_workflow, workflow_status, list_workflow_runs, set_workflow_enabled এবং সহায়ক ও দল-এ তালিকাভুক্ত অন্যান্য ওয়ার্কফ্লো টুল দিয়ে ওয়ার্কফ্লো পরিচালনা করে।