Câmpuri
{
"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" }
} | Câmp | Implicit | Semnificație |
|---|---|---|
id | obligatoriu | Unic în cadrul fluxului de lucru. Folosit în connections și în căile de date. |
type | custom | Un pas al angajatului sau unul dintre condition, loop, wait, http, command, decide. |
intent | niciuna | Ce ar trebui să realizeze angajatul. Un pas al angajatului are nevoie de intent sau steps. |
steps | [] | Instrucțiuni ordonate, când o singură propoziție nu este suficientă. |
label | niciuna | Numele afișat proprietarului. |
skills | [] | Abilitățile de folosit. Abilitățile din magazin listate aici sunt instalate odată cu angajatul. |
tools | [] | Când este setat, singurele instrumente pe care pasul le poate folosi. |
requires_tools | [] | Instrumente care trebuie să reușească pentru ca pasul să fie considerat încheiat. |
cmds | [] | Comenzi de plugin numite pentru pas. |
mcps | [] | Servere MCP numite pentru pas. |
model | niciuna | Un id de model pentru acest pas. |
params | niciuna | Parametri pentru activitățile tipizate și maxIterations pentru pașii angajatului. |
min_iterations | niciuna | Numărul minim de ture de model înainte ca pasul să se poată încheia. |
token_budget | niciuna | {max}. O estimare. |
on_error | {retry: 1, fallback: notify_owner} | Reîncercări, apoi varianta de rezervă. Orice eșec după reîncercări încheie rularea. |
Pașii angajatului
Un pas al angajatului rulează ca o tură a angajatului: se aplică persona, memoria și conexiunile sale și poate folosi până la 50 de ture de model sau params.maxIterations. Rezultatele pașilor anteriori sunt transmise ca blocuri [Activity 'id' result]. Pasului care încheie un flux de lucru cu o listă emit i se spune să apeleze emit_event cu acele evenimente. Instrumentul exit este întotdeauna disponibil pentru a încheia rularea.
Contextul de date
Activitățile tipizate citesc valori după căi cu puncte dintr-un singur obiect: inputs conține intrările rulării, nodes.<id> conține rezultatul fiecărei activități încheiate (interpretat ca JSON când este JSON), iar item conține elementul curent din interiorul unei bucle. O cale simplă caută în inputs, apoi în nodes.
condition
{ "id": "large", "type": "condition", "params": { "expression": "inputs.amount >= 500" } } params.expression este obligatoriu. Conexiunile de ieșire sunt etichetate True și False. params.mode alege cum este interpretată:
| Mod | Expresie |
|---|---|
expression | Implicit. path op value cu ==, !=, >=, <=, > sau <, comparate ca numere când ambele părți sunt numere; sau o cale simplă, adevărată când valoarea ei este considerată adevărată. |
exists | O cale; adevărată când se rezolvă la o valoare considerată adevărată. |
contains | path contains text sau text simplu căutat în rezultatul anterior. |
regex | Un model căutat în rezultatul anterior. |
loop
{ "id": "each-invoice", "type": "loop", "params": { "source": "nodes.fetch.invoices", "concurrency": 4 } } params.source este calea unei liste. Conexiunea etichetată Each item duce la corp, care rulează o dată pentru fiecare element cu item setat; cea etichetată Done rulează după toate elementele. Iterațiile pornesc împreună, dacă nu setezi concurrency. Sunt acceptate și maxIterations și 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 și 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 | Obligatoriu | Comportament |
|---|---|---|
wait | params.duration | Face o pauză pe un interval în s, m sau h. Nu există așteptare până la un moment anume; ca să reiei la un eveniment, declanșează un al doilea flux de lucru pe acel eveniment. |
http | params.url | Face cererea. method, headers și body sunt opționale. |
command | params.command | Rulează o comandă de shell. Stdout-ul ei este rezultatul activității. |
decide
O activitate decide pune întrebări tipizate despre munca făcută până acum și înregistrează răspunsuri structurate după care o condiție poate direcționa.
{
"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 }
}
} | Tipul întrebării | criteria | Răspuns |
|---|---|---|
choice | Obiect de tip opțiune către descriere, între 2 și 255 de opțiuni. | choice, confidence și probabilities. |
score | Listă de 2 până la 10 niveluri ordonate. | score de la 0 (primul nivel) în sus și confidence. |
noul | Niciunul. | noul, probabilitatea ca afirmația să fie adevărată. |
Direcționează după un răspuns cu o condiție, de exemplu nodes.triage.urgency.score >= 1.5. params.default dă răspunsul sigur pentru fiecare întrebare când nu se poate lua o decizie; un răspuns implicit are încrederea 0. O întrebare fără valoare implicită nu primește niciun răspuns, așa că condițiile bazate pe ea iau muchia False.
Erori
on_error.retry setează de câte ori este reîncercată o activitate eșuată; valoarea implicită este 1. După ultima reîncercare, rularea se încheie, iar cu fallback implicit notify_owner proprietarul este anunțat. Nebo verifică parametrii obligatorii ai fiecărei activități tipizate la pornirea rulării și respinge o ramură care trimite la o activitate necunoscută.