Chan
{
"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" }
} | Chan | Pa defo | Siyifikasyon |
|---|---|---|
id | obligatwa | Inik nan pwosesis travay la. Yo sèvi ak li nan connections ak chemen done yo. |
type | custom | Yon etap anplwaye, oswa youn nan condition, loop, wait, http, command, decide. |
intent | okenn | Sa anplwaye a dwe akonpli. Yon etap anplwaye bezwen intent oswa steps. |
steps | [] | Enstriksyon an lòd, lè yon sèl fraz pa ase. |
label | okenn | Non ki parèt devan pwopriyetè a. |
skills | [] | Konpetans pou sèvi ak yo. Konpetans makètplas ki nan lis isit la enstale ansanm ak anplwaye a. |
tools | [] | Lè li defini, sèl zouti etap la ka sèvi ak yo. |
requires_tools | [] | Zouti ki dwe reyisi pou etap la konte kòm fini. |
cmds | [] | Kòmand plugin yo nonmen pou etap la. |
mcps | [] | Sèvè MCP yo nonmen pou etap la. |
model | okenn | Yon id modèl pou etap sa a. |
params | okenn | Paramèt pou aktivite tipe yo, ak maxIterations pou etap anplwaye. |
min_iterations | okenn | Kantite minimòm tou modèl anvan etap la ka fini. |
token_budget | okenn | {max}. Yon estimasyon. |
on_error | {retry: 1, fallback: notify_owner} | Nouvo esè, apre sa solisyon ranplasman an. Nenpòt echèk apre nouvo esè yo fini egzekisyon an. |
Etap anplwaye
Yon etap anplwaye mache kòm yon tou anplwaye a: pèsonalite l, memwa l ak koneksyon l aplike, e li ka sèvi ak jiska 50 tou modèl, oswa params.maxIterations. Rezilta etap anvan yo pase kòm blòk [Activity 'id' result]. Etap ki fini yon pwosesis travay ak yon lis emit resevwa lòd pou rele emit_event ak evènman sa yo. Zouti exit la toujou disponib pou fini egzekisyon an.
Kontèks done a
Aktivite tipe yo li valè pa chemen ak pwen nan yon sèl objè: inputs kenbe antre egzekisyon an, nodes.<id> kenbe rezilta chak aktivite ki fini (analize kòm JSON lè li an JSON), e item kenbe eleman aktyèl la andedan yon bouk. Yon chemen san prefiks chèche nan inputs, apre sa nan nodes.
condition
{ "id": "large", "type": "condition", "params": { "expression": "inputs.amount >= 500" } } params.expression obligatwa. Koneksyon k ap soti yo gen etikèt True ak False. params.mode chwazi kijan yo li l:
| Mòd | Ekspresyon |
|---|---|
expression | Pa defo. path op value ak ==, !=, >=, <=, > oswa <, yo konpare kòm chif lè toude bò se chif; oswa yon chemen san prefiks, vre lè valè li konsidere vre. |
exists | Yon chemen; vre lè li bay yon valè ki konsidere vre. |
contains | path contains text, oswa tèks san prefiks yo konpare ak rezilta anvan an. |
regex | Yon modèl yo konpare ak rezilta anvan an. |
loop
{ "id": "each-invoice", "type": "loop", "params": { "source": "nodes.fetch.invoices", "concurrency": 4 } } params.source se chemen yon lis. Koneksyon ki gen etikèt Each item la mennen nan kò a, ki mache yon fwa pou chak eleman ak item defini; sa ki gen etikèt Done la mache apre tout eleman yo. Iterasyon yo kòmanse ansanm sòf si ou defini concurrency. Yo aksepte maxIterations ak batchSize tou.
"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 ak 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" } } | Tip | Obligatwa | Konpòtman |
|---|---|---|
wait | params.duration | Pran yon poz pou yon dire an s, m oswa h. Pa gen tann-jiskaske; pou rekòmanse sou yon evènman, deklanche yon dezyèm pwosesis travay sou li. |
http | params.url | Fè demann lan. method, headers ak body opsyonèl. |
command | params.command | Lanse yon kòmand shell. Stdout li se rezilta aktivite a. |
decide
Yon aktivite decide poze kesyon tipe sou travay ki fèt deja epi li anrejistre repons estriktire yon condition ka sèvi pou chwazi wout.
{
"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 }
}
} | Tip kesyon | criteria | Repons |
|---|---|---|
choice | Objè opsyon vè deskripsyon, 2 a 255 opsyon. | choice, confidence ak probabilities. |
score | Lis 2 a 10 nivo an lòd. | score soti 0 (premye nivo) monte, ak confidence. |
noul | Okenn. | noul, pwobabilite deklarasyon an vre. |
Chwazi wout sou yon repons avèk yon condition, tankou nodes.triage.urgency.score >= 1.5. params.default bay repons san danje pou chak kesyon lè pa ka gen desizyon; yon repons pa defo gen konfyans 0. Yon kesyon san valè pa defo pa jwenn repons, kidonk condition sou li pran branch False yo.
Erè
on_error.retry fikse konbyen fwa yo reeseye yon aktivite ki echwe; pa defo se 1. Apre dènye esè a egzekisyon an fini, e avèk fallback pa defo notify_owner la, yo avèti pwopriyetè a. Nebo verifye paramèt obligatwa chak aktivite tipe lè egzekisyon an kòmanse, e li rejte yon branch ki pwente sou yon aktivite li pa konnen.