Velden
{
"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" }
} | Veld | Standaard | Betekenis |
|---|---|---|
id | verplicht | Uniek binnen de workflow. Gebruikt in connections en gegevenspaden. |
type | custom | Een stap van een medewerker, of een van condition, loop, wait, http, command, decide. |
intent | geen | Wat de medewerker moet bereiken. Een stap van een medewerker heeft intent of steps nodig. |
steps | [] | Geordende instructies, als één zin niet genoeg is. |
label | geen | Naam die aan de eigenaar wordt getoond. |
skills | [] | Skills om te gebruiken. Marktplaatsskills die hier staan, worden met de medewerker geïnstalleerd. |
tools | [] | Indien ingesteld de enige tools die de stap mag gebruiken. |
requires_tools | [] | Tools die moeten slagen voordat de stap als klaar telt. |
cmds | [] | Pluginopdrachten die voor de stap worden genoemd. |
mcps | [] | MCP-servers die voor de stap worden genoemd. |
model | geen | Een model-id voor deze stap. |
params | geen | Parameters voor de getypeerde activiteiten, en maxIterations voor stappen van medewerkers. |
min_iterations | geen | Minimaal aantal modelbeurten voordat de stap mag eindigen. |
token_budget | geen | {max}. Een schatting. |
on_error | {retry: 1, fallback: notify_owner} | Herhaalpogingen, daarna de fallback. Elke fout na de herhaalpogingen beëindigt de uitvoering. |
Stappen van medewerkers
Een stap van een medewerker draait als een beurt van de medewerker: zijn persona, geheugen en verbindingen gelden, en hij kan tot 50 modelbeurten gebruiken, of params.maxIterations. De resultaten van eerdere stappen worden doorgegeven als blokken [Activity 'id' result]. De stap die een workflow met een emit-lijst afsluit, krijgt de opdracht emit_event met die events aan te roepen. De tool exit is altijd beschikbaar om de uitvoering te beëindigen.
De gegevenscontext
Getypeerde activiteiten lezen waarden via een pad met punten uit één object: inputs bevat de invoer van de uitvoering, nodes.<id> bevat de uitvoer van elke voltooide activiteit (geparsed als JSON wanneer het JSON is), en item bevat het huidige item binnen een loop. Een kaal pad zoekt eerst in inputs en daarna in nodes.
condition
{ "id": "large", "type": "condition", "params": { "expression": "inputs.amount >= 500" } } params.expression is verplicht. De uitgaande verbindingen hebben de labels True en False. params.mode bepaalt hoe de expressie wordt gelezen:
| Modus | Expressie |
|---|---|
expression | De standaard. path op value met ==, !=, >=, <=, > of <, vergeleken als getallen wanneer beide kanten getallen zijn; of een kaal pad, waar als de waarde truthy is. |
exists | Een pad; waar als het verwijst naar een truthy waarde. |
contains | path contains text, of losse tekst die wordt vergeleken met de vorige uitvoer. |
regex | Een patroon dat wordt vergeleken met de vorige uitvoer. |
loop
{ "id": "each-invoice", "type": "loop", "params": { "source": "nodes.fetch.invoices", "concurrency": 4 } } params.source is het pad van een lijst. De verbinding met het label Each item leidt naar de body, die één keer per item draait met item ingesteld; die met het label Done draait na alle items. Iteraties beginnen tegelijk, tenzij je concurrency instelt. maxIterations en batchSize worden ook geaccepteerd.
"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 en 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" } } | Type | Verplicht | Gedrag |
|---|---|---|
wait | params.duration | Pauzeert gedurende een tijdsduur in s, m of h. Er is geen wachten-tot; om op een event te hervatten, trigger je er een tweede workflow mee. |
http | params.url | Doet het verzoek. method, headers en body zijn optioneel. |
command | params.command | Voert een shellopdracht uit. De stdout ervan is de uitvoer van de activiteit. |
decide
Een decide-activiteit stelt getypeerde vragen over het werk tot nu toe en legt gestructureerde antwoorden vast waarop een condition kan routeren.
{
"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 }
}
} | Vraagtype | criteria | Antwoord |
|---|---|---|
choice | Object van optie naar beschrijving, 2 tot 255 opties. | choice, confidence en probabilities. |
score | Lijst van 2 tot 10 geordende niveaus. | score vanaf 0 (eerste niveau) oplopend, en confidence. |
noul | Geen. | noul, de kans dat de bewering klopt. |
Routeer op een antwoord met een condition, zoals nodes.triage.urgency.score >= 1.5. params.default geeft voor elke vraag het veilige antwoord wanneer er geen beslissing kan worden genomen; een standaardantwoord heeft confidence 0. Een vraag zonder standaardwaarde krijgt geen antwoord, dus condities daarop volgen hun False-verbinding.
Fouten
on_error.retry bepaalt hoe vaak een mislukte activiteit opnieuw wordt geprobeerd; de standaard is 1. Na de laatste poging eindigt de uitvoering, en met de standaard-fallback notify_owner krijgt de eigenaar bericht. Nebo controleert bij de start van de uitvoering de verplichte parameters van elke getypeerde activiteit, en weigert een tak die naar een onbekende activiteit wijst.