ပထမဆုံး လုပ်ငန်းစဉ်
agent.json သို့ workflows map တစ်ခု ထည့်ပါ။ Key တစ်ခုစီက လုပ်ငန်းစဉ်တစ်ခုကို အမည်ပေးပြီး value တစ်ခုစီတွင် trigger နှင့် activity များ ပါသည်။
{
"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 တွင် run သည်။ ဝန်ထမ်းသည် ၎င်း၏ ကိုယ်ပိုင် persona၊ ကျွမ်းကျင်မှုများနှင့် ချိတ်ဆက်မှုများဖြင့် activity ကို ဆောင်ရွက်သည်။
လုပ်ငန်းစဉ် field များ
| Field | အဓိပ္ပာယ် |
|---|---|
trigger | မဖြစ်မနေ လိုအပ်သည်။ လုပ်ငန်းစဉ် run မည့်အချိန်။ Trigger များကို ကြည့်ပါ။ |
description | လုပ်ငန်းစဉ်၏ ရည်ရွယ်ချက်။ |
activities | အဆင့်များ။ Activity များကို ကြည့်ပါ။ |
connections | Activity များကို graph ဖြစ်စေသော edge {from, to, label} များ။ __trigger__ သည် အစ ဖြစ်ပြီး __emit__ သည် အဆုံး ဖြစ်သည်။ |
emit | ဤလုပ်ငန်းစဉ် ပြီးဆုံးသောအခါ ကြေညာသော event များ- စာရင်း သို့မဟုတ် ကော်မာခြားထားသော string တစ်ခု။ Event များကို ကြည့်ပါ။ |
inputs | Run တိုင်းသို့ ပေးပို့သော တန်ဖိုးများ။ |
budget | {total_per_run, cost_estimate}။ Graph run တွင် total_per_run သည် output token များကို ကန့်သတ်သည်။ မဟုတ်ပါက နှစ်ခုလုံးသည် ခန့်မှန်းချက်များ ဖြစ်သည်။ |
case | လုပ်ငန်းစဉ်ကို လူ သို့မဟုတ် အရာတစ်ခုလျှင် ကြာရှည်သော case တစ်ခု ဖြစ်စေသည်။ Case များကို ကြည့်ပါ။ |
Trigger ပါပြီး activity မပါသော လုပ်ငန်းစဉ်သည် မှန်ကန်သည်။ Activity မပါသော watch သည် ၎င်း၏ event များကို အခြားလုပ်ငန်းစဉ်များထံ ဆင့်ပို့ရုံသာ ဖြစ်သည်။
Run တစ်ခု လုပ်ဆောင်ပုံ
connections မပါပါက activity များသည် အစဉ်လိုက် run ပြီး ဝန်ထမ်းက တစ်ခုစီကို ဆောင်ရွက်သည်။ Activity တစ်ခုစီ၏ ရလဒ်ကို နောက်တစ်ခုသို့ ပေးပို့သည်။ Output မရှိသော activity သည် run ကို အဆုံးသတ်သည်။
connections ပါပါက activity များသည် graph တစ်ခု ဖြစ်လာသည်။ အကိုင်းအခက်များ ပြိုင်တူ run ပြီး activity အမျိုးအစား ခြောက်ခုသည် model မပါဘဲ run သည်- condition၊ loop၊ wait၊ http၊ command နှင့် decide။ လမ်းကြောင်းပေးမှု တိကျရမည့်အခါ graph ကို သုံးပါ။
{
"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"]
} Run တစ်ခု လက်ခံရရှိသည့်အရာ
ဝန်ထမ်းတွင် ၎င်း၏ persona နှင့် ၎င်း၏ inputs မေးခွန်းများအတွက် ပိုင်ရှင်၏ အဖြေများ အမြဲ ရှိသည်။ Run တစ်ခုသည် ၎င်း၏ trigger ပေါ်မူတည်၍ ဤတန်ဖိုးများကိုလည်း လက်ခံရရှိသည်။
| Input | ပါရှိသည့်အခါ |
|---|---|
_event_source, _event_payload, _event_origin | Event trigger အလုပ်လုပ်သည့်အခါ။ 8 KB နှင့်အထက် payload များကို ၎င်းတို့၏ scalar field များအထိ အတိုချုံ့ပြီး email header များနှင့် attachment ရည်ညွှန်းချက်များကို ထားရှိသည်။ |
_watch_payload | Watch သို့မဟုတ် folder trigger အလုပ်လုပ်သည့်အခါ။ Watcher ၏ output စာကြောင်းတစ်ကြောင်း သို့မဟုတ် folder အတွက် {files}။ |
inputs | အမြဲ။ လုပ်ငန်းစဉ်၏ ကိုယ်ပိုင် inputs တန်ဖိုးများ။ |
Case များ
အချို့အလုပ်များသည် ရက်ပေါင်းများစွာ ကြာသည်- နောက်ဆက်တွဲ ဆက်သွယ်ရမည့် lead၊ စာရွက်စာတမ်းများကို စောင့်နေသော တောင်းဆိုချက်။ case ကို ထည့်ပါက လုပ်ငန်းစဉ်သည် အကြိမ်တိုင်း အသစ်မစဘဲ လူ သို့မဟုတ် အရာတစ်ခုလျှင် ဖွင့်ထားသော case တစ်ခု ထားရှိသည်။
| Field | အဓိပ္ပာယ် |
|---|---|
key | မဖြစ်မနေ လိုအပ်သည်။ contactEmail,email,phone ကဲ့သို့ အကြောင်းအရာကို ခွဲခြားသတ်မှတ်သော trigger ဒေတာထဲသို့ ကော်မာခြားထားသည့် အစက်ပါ path များ။ |
type | lead ကဲ့သို့ case အမျိုးအစား။ Type တူသော လုပ်ငန်းစဉ်များသည် case များကို မျှဝေသည်။ မူလတန်ဖိုးမှာ လုပ်ငန်းစဉ်အမည် ဖြစ်သည်။ |
default_wait | အလှည့်တစ်ခုက စောင့်ချိန် မဖော်ပြသည့်အခါ စောင့်ရမည့်ကာလ- 3d၊ 12h၊ 45m။ မူလတန်ဖိုး သုံးရက်။ |
Case တစ်ခု၏ အလှည့်တိုင်းသည် JSON object တစ်ခုဖြင့် အဆုံးသတ်ရမည်ဖြစ်ပြီး ၎င်းနောက်တွင် ဘာမှ မပါရ။ result သည် လုပ်ငန်းအခြေအနေ ဖြစ်ပြီး next က engine ကို wait သို့မဟုတ် close လုပ်ရန် ပြောသည်။ နောက်ဆုံးရက်သည် RFC 3339 သို့မဟုတ် နှိုင်းယှဉ်ကာလ ဖြစ်သည်။ အခြားမည်သည့်အရာမဆို မမှန်ကန်သော အလှည့် ဖြစ်သည်။
{"result": {"status": "awaiting_documents", "summary": "Requested two bank statements"},
"next": {"action": "wait", "on": "signal", "deadline": "3d", "reason": "documents"}} ကန့်သတ်ချက်များနှင့် ပြန်လည်ကောင်းမွန်ခြင်း
params.maxIterationsက အခြားတစ်မျိုး မပြောပါက activity တစ်ခုစီသည် model အလှည့် 50 အထိ ယူနိုင်သည်။- Graph တစ်ခုတွင် activity တစ်ခုသည် run တစ်ခုအတွင်း အများဆုံး 10,000 ကြိမ် run နိုင်သည်။
- ဝန်ထမ်းအတွက် ပိုင်ရှင်၏ သုံးစွဲမှုကန့်သတ်ချက် ပြည့်သောအခါ run ကို ရပ်တန့်သည်။ Activity တစ်ခု၏
token_budgetသည် ခန့်မှန်းချက် ဖြစ်သည်။ - Restart ကြောင့် ကြားဖြတ်ခံရသော run ကို interrupted ဟု မှတ်သားပြီး တစ်ကြိမ် ပြန်ဆက်သည်။
- ဝန်ထမ်းက
exittool ဖြင့် run ကို စောစီးစွာ အဆုံးသတ်နိုင်သည်။
လုပ်ငန်းစဉ်များကို run ပြီး စီမံပါ
ပိုင်ရှင်က မည်သည့်လုပ်ငန်းစဉ်ကိုမဆို ကိုယ်တိုင် run နိုင်သည်။ ဝန်ထမ်းများသည် run_workflow၊ workflow_status၊ list_workflow_runs၊ set_workflow_enabled နှင့် Helper များနှင့် အဖွဲ့များ တွင် ဖော်ပြထားသော အခြား လုပ်ငန်းစဉ် tool များဖြင့် လုပ်ငန်းစဉ်များကို စီမံသည်။