Polia
{
"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" }
} | Pole | Predvolené | Význam |
|---|---|---|
id | povinné | Jedinečné v rámci pracovného postupu. Používa sa v connections a v dátových cestách. |
type | custom | Krok zamestnanca alebo jeden z typov condition, loop, wait, http, command, decide. |
intent | žiadne | Čo má zamestnanec dosiahnuť. Krok zamestnanca potrebuje intent alebo steps. |
steps | [] | Pokyny v poradí, keď jedna veta nestačí. |
label | žiadne | Názov zobrazený vlastníkovi. |
skills | [] | Zručnosti na použitie. Zručnosti z obchodu uvedené tu sa nainštalujú spolu so zamestnancom. |
tools | [] | Ak sú nastavené, jediné nástroje, ktoré krok smie použiť. |
requires_tools | [] | Nástroje, ktoré musia uspieť, aby sa krok považoval za hotový. |
cmds | [] | Príkazy doplnkov určené pre krok. |
mcps | [] | Servery MCP určené pre krok. |
model | žiadne | Id modelu pre tento krok. |
params | žiadne | Parametre pre typové aktivity a maxIterations pre kroky zamestnanca. |
min_iterations | žiadne | Minimálny počet ťahov modelu, kým sa krok môže dokončiť. |
token_budget | žiadne | {max}. Odhad. |
on_error | {retry: 1, fallback: notify_owner} | Opakovania a potom záložný postup. Každé zlyhanie po opakovaniach ukončí beh. |
Kroky zamestnanca
Krok zamestnanca beží ako ťah zamestnanca: uplatňuje sa jeho osobnosť, pamäť a pripojenia a môže použiť najviac 50 ťahov modelu alebo params.maxIterations. Výsledky predchádzajúcich krokov sa odovzdávajú ako bloky [Activity 'id' result]. Krok, ktorý ukončuje pracovný postup so zoznamom emit, dostane pokyn zavolať emit_event s týmito udalosťami. Nástroj exit je vždy k dispozícii na ukončenie behu.
Dátový kontext
Typové aktivity čítajú hodnoty podľa cesty s bodkami z jedného objektu: inputs obsahuje vstupy behu, nodes.<id> obsahuje výstup každej dokončenej aktivity (spracovaný ako JSON, ak ide o JSON) a item obsahuje aktuálnu položku v cykle. Holá cesta sa hľadá v inputs, potom v nodes.
condition
{ "id": "large", "type": "condition", "params": { "expression": "inputs.amount >= 500" } } params.expression je povinné. Jeho odchádzajúce spojenia sú označené True a False. params.mode určuje, ako sa výraz číta:
| Režim | Výraz |
|---|---|
expression | Predvolené. path op value s ==, !=, >=, <=, > alebo <, porovnávané ako čísla, keď sú obe strany čísla; alebo holá cesta, pravda, keď je jej hodnota pravdivá. |
exists | Cesta; pravda, keď sa vyhodnotí na pravdivú hodnotu. |
contains | path contains text alebo holý text porovnávaný s predchádzajúcim výstupom. |
regex | Vzor porovnávaný s predchádzajúcim výstupom. |
loop
{ "id": "each-invoice", "type": "loop", "params": { "source": "nodes.fetch.invoices", "concurrency": 4 } } params.source je cesta k zoznamu. Spojenie označené Each item vedie k telu, ktoré sa spustí raz pre každú položku s nastaveným item; spojenie označené Done sa spustí po všetkých položkách. Iterácie sa začnú naraz, pokiaľ nenastavíte concurrency. Prijímajú sa aj maxIterations a 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 a 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" } } | Typ | Povinné | Správanie |
|---|---|---|
wait | params.duration | Pozastaví sa na úsek v s, m alebo h. Čakanie do určitého času neexistuje; ak chcete pokračovať po udalosti, spustite na ňu druhý pracovný postup. |
http | params.url | Odošle požiadavku. method, headers a body sú voliteľné. |
command | params.command | Spustí príkaz shellu. Jeho stdout je výstupom aktivity. |
decide
Aktivita decide kladie typové otázky o doterajšej práci a zaznamenáva štruktúrované odpovede, podľa ktorých môže smerovať podmienka.
{
"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 }
}
} | Typ otázky | criteria | Odpoveď |
|---|---|---|
choice | Objekt možností s popismi, 2 až 255 možností. | choice, confidence a probabilities. |
score | Zoznam 2 až 10 zoradených úrovní. | score od 0 (prvá úroveň) vyššie a confidence. |
noul | Žiadne. | noul, pravdepodobnosť, že tvrdenie platí. |
Smerujte podľa odpovede pomocou podmienky, napríklad nodes.triage.urgency.score >= 1.5. params.default určuje bezpečnú odpoveď na každú otázku, keď sa nedá rozhodnúť; predvolená odpoveď má istotu 0. Otázka bez predvolenej hodnoty nedostane odpoveď, takže podmienky na nej idú po hrane False.
Chyby
on_error.retry určuje, koľkokrát sa zlyhaná aktivita zopakuje; predvolene je to 1. Po poslednom opakovaní sa beh ukončí a pri predvolenom fallback s hodnotou notify_owner dostane vlastník správu. Nebo pri spustení behu skontroluje povinné parametre každej typovej aktivity a odmietne vetvu, ktorá ukazuje na neznámu aktivitu.