فیلدها
{
"id": "draft-reply",
"label": "Draft the reply",
"intent": "Draft a reply to the customer message in _watch_payload using the reply-drafting skill.",
"skills": ["reply-drafting"],
"requires_tools": ["mail_message_send"],
"on_error": { "retry": 1, "fallback": "notify_owner" }
} | فیلد | پیشفرض | معنی |
|---|---|---|
id | الزامی | در گردشکار یکتا. در connections و مسیرهای داده استفاده میشود. |
type | custom | یک گام کارمند، یا یکی از condition، loop، wait، http، command، decide. |
intent | هیچ | آنچه کارمند باید انجام دهد. یک گام کارمند به intent یا steps نیاز دارد. |
steps | [] | دستورالعملهای مرتب، وقتی یک جمله کافی نیست. |
label | هیچ | نامی که به مالک نشان داده میشود. |
skills | [] | مهارتهایی که استفاده میشوند. مهارتهای فروشگاه فهرستشده در اینجا همراه کارمند نصب میشوند. |
tools | [] | در صورت تنظیم، تنها ابزارهایی که گام میتواند استفاده کند. |
requires_tools | [] | ابزارهایی که باید موفق شوند تا گام انجامشده به حساب آید. |
cmds | [] | فرمانهای افزونه نامبرده برای این گام. |
mcps | [] | سرورهای MCP نامبرده برای این گام. |
model | هیچ | شناسه یک مدل برای این گام. |
params | هیچ | پارامترها برای فعالیتهای تایپشده، و maxIterations برای گامهای کارمند. |
min_iterations | هیچ | حداقل نوبتهای مدل پیش از آنکه گام بتواند تمام شود. |
token_budget | هیچ | {max}. یک تخمین. |
on_error | {retry: 1, fallback: notify_owner} | تلاشهای دوباره، سپس جایگزین. هر شکستی پس از تلاشهای دوباره اجرا را پایان میدهد. |
گامهای کارمند
یک گام کارمند بهصورت یک نوبت از کارمند اجرا میشود: شخصیت، حافظه و اتصالهای او اعمال میشوند، و میتواند تا ۵۰ نوبت مدل، یا params.maxIterations، استفاده کند. نتایج گامهای قبلی به شکل بلوکهای [Activity 'id' result] داده میشوند. به گامی که یک گردشکار را با فهرست emit پایان میدهد گفته میشود emit_event را با آن رویدادها فراخوانی کند. ابزار exit برای پایان دادن به اجرا همیشه در دسترس است.
زمینه داده
فعالیتهای تایپشده مقادیر را با مسیر نقطهدار از یک شیء میخوانند: inputs ورودیهای اجرا را دارد، nodes.<id> خروجی هر فعالیت پایانیافته را دارد (اگر JSON باشد بهصورت JSON تجزیه میشود)، و item مورد فعلی درون یک حلقه را دارد. یک مسیر ساده ابتدا در inputs و سپس در nodes جستجو میکند.
condition
{ "id": "large", "type": "condition", "params": { "expression": "inputs.amount >= 500" } } params.expression الزامی است. اتصالهای خروجی آن با True و False برچسب میخورند. params.mode تعیین میکند چگونه خوانده شود:
| حالت | عبارت |
|---|---|
expression | پیشفرض. path op value با ==، !=، >=، <=، > یا <، که وقتی هر دو طرف عدد باشند بهصورت عددی مقایسه میشود؛ یا یک مسیر ساده، که وقتی مقدارش درستانگار باشد درست است. |
exists | یک مسیر؛ وقتی به مقداری درستانگار برسد درست است. |
contains | path contains text، یا متن سادهای که با خروجی قبلی تطبیق داده میشود. |
regex | الگویی که با خروجی قبلی تطبیق داده میشود. |
loop
{ "id": "each-invoice", "type": "loop", "params": { "source": "nodes.fetch.invoices", "concurrency": 4 } } params.source مسیر یک فهرست است. اتصالی با برچسب Each item به بدنه میرسد که برای هر مورد یک بار با تنظیم item اجرا میشود؛ اتصالی با برچسب Done پس از همه موارد اجرا میشود. تکرارها با هم شروع میشوند مگر اینکه concurrency را تنظیم کنید. maxIterations و batchSize هم پذیرفته میشوند.
"connections": [
{ "from": "__trigger__", "to": "fetch" },
{ "from": "fetch", "to": "each-invoice" },
{ "from": "each-invoice", "to": "check", "label": "Each item" },
{ "from": "each-invoice", "to": "report", "label": "Done" }
] wait، http و command
{ "id": "pause", "type": "wait", "params": { "duration": "5m" } }
{ "id": "status", "type": "http", "params": { "url": "https://status.example.com/api", "method": "GET" } }
{ "id": "export", "type": "command", "params": { "command": "date -u" } } | نوع | الزامی | رفتار |
|---|---|---|
wait | params.duration | به مدت یک بازه به s، m یا h مکث میکند. انتظار تا زمان مشخص وجود ندارد؛ برای ادامه با یک رویداد، گردشکار دومی را با آن تریگر کنید. |
http | params.url | درخواست را ارسال میکند. method، headers و body اختیاری هستند. |
command | params.command | یک فرمان پوسته اجرا میکند. stdout آن خروجی فعالیت است. |
decide
یک فعالیت decide پرسشهای تایپشدهای درباره کار انجامشده تا آن لحظه میپرسد و پاسخهای ساختاریافتهای ثبت میکند که یک condition میتواند بر اساسشان مسیریابی کند.
{
"id": "triage",
"type": "decide",
"params": {
"questions": {
"urgency": { "type": "score", "instructions": "How urgent is this request?", "criteria": ["low", "normal", "high"] },
"refund": { "type": "noul", "instructions": "The customer is asking for money back." }
},
"default": { "urgency": "normal", "refund": false }
}
} | نوع پرسش | criteria | پاسخ |
|---|---|---|
choice | شیئی از گزینه به توضیح، ۲ تا ۲۵۵ گزینه. | choice، confidence و probabilities. |
score | فهرستی از ۲ تا ۱۰ سطح مرتب. | score از ۰ (نخستین سطح) به بالا، و confidence. |
noul | هیچ. | noul، احتمال اینکه گزاره درست باشد. |
با یک condition بر اساس یک پاسخ مسیریابی کنید، مانند nodes.triage.urgency.score >= 1.5. params.default پاسخ امن را برای هر پرسش وقتی تصمیمی گرفته نشود تعیین میکند؛ پاسخ پیشفرض اطمینان ۰ دارد. پرسشی بدون پیشفرض پاسخی نمیگیرد، بنابراین conditionهای مربوط به آن یال False را دنبال میکنند.
خطاها
on_error.retry تعیین میکند یک فعالیت ناموفق چند بار دوباره تلاش شود؛ پیشفرض ۱ است. پس از آخرین تلاش، اجرا پایان مییابد و با fallback پیشفرض یعنی notify_owner به مالک اطلاع داده میشود. Nebo پارامترهای الزامی هر فعالیت تایپشده را هنگام شروع اجرا بررسی میکند و شاخهای را که به فعالیتی ناشناخته اشاره کند رد میکند.