نخستین گردشکار
یک نگاشت workflows به agent.json اضافه کنید. هر کلید نام یک گردشکار است؛ هر مقدار یک تریگر و فعالیتها دارد.
{
"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." }
]
}
}
} این گردشکار در روزهای کاری ساعت ۰۸:۰۰ به وقت محلی ربات اجرا میشود. کارمند فعالیت را با شخصیت، مهارتها و اتصالهای خودش انجام میدهد.
فیلدهای گردشکار
| فیلد | معنی |
|---|---|
trigger | الزامی. گردشکار کی اجرا میشود. بخش تریگرها را ببینید. |
description | گردشکار برای چیست. |
activities | گامها. بخش فعالیتها را ببینید. |
connections | یالهای {from, to, label} که فعالیتها را به یک گراف تبدیل میکنند. __trigger__ آغاز و __emit__ پایان است. |
emit | رویدادهایی که این گردشکار هنگام پایان اعلام میکند: یک فهرست، یا یک رشته جداشده با ویرگول. بخش رویدادها را ببینید. |
inputs | مقادیری که به هر اجرا داده میشوند. |
budget | {total_per_run, cost_estimate}. در اجرای گرافی، total_per_run سقف توکنهای خروجی را تعیین میکند؛ در غیر این صورت هر دو تخمین هستند. |
case | گردشکار را به یک پرونده طولانیمدت برای هر شخص یا چیز تبدیل میکند. بخش پروندهها را ببینید. |
گردشکاری با یک تریگر و بدون فعالیت معتبر است. یک ناظر بدون فعالیت فقط رویدادهایش را به گردشکارهای دیگر میرساند.
یک اجرا چگونه انجام میشود
بدون 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 | یک تریگر event فعال شده. محمولههای ۸ کیلوبایت یا بیشتر به فیلدهای اسکالرشان کوتاه میشوند و سرآیندهای ایمیل و ارجاع پیوستها حفظ میشوند. |
_watch_payload | یک تریگر watch یا folder فعال شده. یک خط از خروجی ناظر، یا {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چیز دیگری بگوید. - در یک گراف، یک فعالیت حداکثر ۱۰٬۰۰۰ بار در یک اجرا میتواند اجرا شود.
- سقف هزینهای که مالک برای کارمند تعیین کرده، در صورت رسیدن، اجرا را متوقف میکند.
token_budgetیک فعالیت یک تخمین است. - اجرایی که با راهاندازی دوباره قطع شود، قطعشده علامت میخورد و یک بار ادامه داده میشود.
- کارمند میتواند با ابزار
exitاجرا را زودتر پایان دهد.
اجرا و مدیریت گردشکارها
مالک میتواند هر گردشکاری را دستی اجرا کند. کارمندان گردشکارها را با run_workflow، workflow_status، list_workflow_runs، set_workflow_enabled و دیگر ابزارهای گردشکار فهرستشده در دستیارها و تیمها مدیریت میکنند.