Mga field
{
"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" }
} | Field | Default | Kahulugan |
|---|---|---|
id | kailangan | Natatangi sa loob ng workflow. Ginagamit sa connections at sa mga data path. |
type | custom | Isang hakbang ng empleyado, o isa sa condition, loop, wait, http, command, decide. |
intent | wala | Kung ano ang dapat magawa ng empleyado. Kailangan ng hakbang ng empleyado ang intent o steps. |
steps | [] | Sunud-sunod na instruction, kapag hindi sapat ang isang pangungusap. |
label | wala | Pangalang ipinapakita sa may-ari. |
skills | [] | Mga skill na gagamitin. Ini-install kasama ng empleyado ang mga marketplace skill na nakalista rito. |
tools | [] | Kapag nakatakda, ang tanging mga tool na magagamit ng hakbang. |
requires_tools | [] | Mga tool na dapat magtagumpay para maituring na tapos ang hakbang. |
cmds | [] | Mga plugin command na pinangalanan para sa hakbang. |
mcps | [] | Mga MCP server na pinangalanan para sa hakbang. |
model | wala | Isang model id para sa hakbang na ito. |
params | wala | Mga parameter para sa mga typed activity, at maxIterations para sa mga hakbang ng empleyado. |
min_iterations | wala | Pinakakaunting model turn bago puwedeng matapos ang hakbang. |
token_budget | wala | {max}. Tantiya. |
on_error | {retry: 1, fallback: notify_owner} | Mga retry, saka ang fallback. Tinatapos ang run ng anumang pagpalya pagkatapos ng mga retry. |
Mga hakbang ng empleyado
Tumatakbo ang hakbang ng empleyado bilang isang turn ng empleyado: umiiral ang persona, memory at mga koneksyon nito, at puwede itong gumamit ng hanggang 50 model turn, o params.maxIterations. Ipinapasa ang mga resulta ng mga naunang hakbang bilang mga block na [Activity 'id' result]. Ang hakbang na nagtatapos sa workflow na may listahang emit ay sinasabihang tawagin ang emit_event gamit ang mga event na iyon. Laging available ang tool na exit para tapusin ang run.
Ang data context
Nagbabasa ang mga typed activity ng mga value ayon sa dotted path mula sa iisang object: hawak ng inputs ang mga input ng run, hawak ng nodes.<id> ang output ng bawat natapos na activity (pina-parse bilang JSON kapag JSON ito), at hawak ng item ang kasalukuyang item sa loob ng loop. Ang path na walang unahan ay tumitingin sa inputs, saka sa nodes.
condition
{ "id": "large", "type": "condition", "params": { "expression": "inputs.amount >= 500" } } Kailangan ang params.expression. May label na True at False ang mga palabas na koneksyon nito. Pinipili ng params.mode kung paano ito binabasa:
| Mode | Expression |
|---|---|
expression | Ang default. path op value gamit ang ==, !=, >=, <=, > o <, pinaghahambing bilang numero kapag numero ang magkabilang panig; o isang path lang, true kapag truthy ang value nito. |
exists | Isang path; true kapag truthy na value ang kinalalabasan nito. |
contains | path contains text, o text na itinutugma sa naunang output. |
regex | Isang pattern na itinutugma sa naunang output. |
loop
{ "id": "each-invoice", "type": "loop", "params": { "source": "nodes.fetch.invoices", "concurrency": 4 } } Ang params.source ay ang path ng isang listahan. Ang koneksyong may label na Each item ay papunta sa body, na tumatakbo nang isang beses bawat item nang nakatakda ang item; ang may label na Done ay tumatakbo pagkatapos ng lahat ng item. Sabay-sabay na nagsisimula ang mga iteration maliban kung itatakda mo ang concurrency. Tinatanggap din ang maxIterations at 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 at 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" } } | Uri | Kailangan | Gawi |
|---|---|---|
wait | params.duration | Humihinto nang isang tagal sa s, m o h. Walang wait-until; para ituloy sa isang event, mag-trigger ng ikalawang workflow dito. |
http | params.url | Ginagawa ang request. Opsyonal ang method, headers at body. |
command | params.command | Nagpapatakbo ng shell command. Ang stdout nito ang output ng activity. |
decide
Nagtatanong ang decide activity ng mga typed na tanong tungkol sa trabaho sa ngayon at nire-record ang mga structured na sagot na mapag-uugatan ng route ng isang 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 }
}
} | Uri ng tanong | criteria | Sagot |
|---|---|---|
choice | Object ng opsyon papunta sa description, 2 hanggang 255 opsyon. | choice, confidence at probabilities. |
score | Listahan ng 2 hanggang 10 nakaayos na antas. | score mula 0 (unang antas) pataas, at confidence. |
noul | Wala. | noul, ang probabilidad na totoo ang pahayag. |
Mag-route batay sa sagot gamit ang condition, gaya ng nodes.triage.urgency.score >= 1.5. Ibinibigay ng params.default ang ligtas na sagot para sa bawat tanong kapag walang maipapasyang desisyon; may confidence na 0 ang sagot na default. Ang tanong na walang default ay walang sagot, kaya dumadaan sa False na edge ang mga condition dito.
Mga error
Itinatakda ng on_error.retry kung ilang beses ire-retry ang pumalyang activity; 1 ang default. Pagkatapos ng huling retry, natatapos ang run, at sa default na fallback na notify_owner, sinasabihan ang may-ari. Sinusuri ng Nebo ang mga kailangang parameter ng bawat typed activity kapag nagsimula ang run, at tinatanggihan ang branch na tumuturo sa hindi kilalang activity.