Campi
{
"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" }
} | Campo | Predefinito | Significato |
|---|---|---|
id | obbligatorio | Univoco all'interno del flusso di lavoro. Usato in connections e nei percorsi dei dati. |
type | custom | Un passaggio del dipendente, oppure uno tra condition, loop, wait, http, command, decide. |
intent | nessuno | Cosa deve ottenere il dipendente. Un passaggio del dipendente richiede intent o steps. |
steps | [] | Istruzioni in sequenza, quando una frase non basta. |
label | nessuno | Nome mostrato al proprietario. |
skills | [] | Skill da usare. Le skill del marketplace elencate qui vengono installate con il dipendente. |
tools | [] | Se impostato, gli unici strumenti che il passaggio può usare. |
requires_tools | [] | Strumenti che devono riuscire perché il passaggio conti come completato. |
cmds | [] | Comandi di plugin indicati per il passaggio. |
mcps | [] | Server MCP indicati per il passaggio. |
model | nessuno | Un id di modello per questo passaggio. |
params | nessuno | Parametri per le attività tipizzate, e maxIterations per i passaggi del dipendente. |
min_iterations | nessuno | Numero minimo di turni del modello prima che il passaggio possa terminare. |
token_budget | nessuno | {max}. Una stima. |
on_error | {retry: 1, fallback: notify_owner} | Tentativi ripetuti, poi l'alternativa. Qualsiasi errore dopo i tentativi termina l'esecuzione. |
Passaggi del dipendente
Un passaggio del dipendente viene eseguito come un turno del dipendente: valgono la sua persona, la sua memoria e le sue connessioni, e può usare fino a 50 turni del modello, oppure params.maxIterations. I risultati dei passaggi precedenti vengono passati come blocchi [Activity 'id' result]. Al passaggio che chiude un flusso di lavoro con un elenco emit viene detto di chiamare emit_event con quegli eventi. Lo strumento exit è sempre disponibile per terminare l'esecuzione.
Il contesto dei dati
Le attività tipizzate leggono i valori tramite percorso puntato da un unico oggetto: inputs contiene gli input dell'esecuzione, nodes.<id> contiene l'output di ogni attività completata (interpretato come JSON quando è JSON), e item contiene l'elemento corrente dentro un loop. Un percorso semplice cerca in inputs, poi in nodes.
condition
{ "id": "large", "type": "condition", "params": { "expression": "inputs.amount >= 500" } } params.expression è obbligatorio. Le sue connessioni in uscita sono etichettate True e False. params.mode sceglie come viene interpretata:
| Modalità | Espressione |
|---|---|
expression | Il valore predefinito. path op value con ==, !=, >=, <=, > o <, confrontati come numeri quando entrambi i lati sono numeri; oppure un percorso semplice, vero quando il suo valore è truthy. |
exists | Un percorso; vero quando si risolve in un valore truthy. |
contains | path contains text, oppure testo semplice confrontato con l'output precedente. |
regex | Un pattern confrontato con l'output precedente. |
loop
{ "id": "each-invoice", "type": "loop", "params": { "source": "nodes.fetch.invoices", "concurrency": 4 } } params.source è il percorso di un elenco. La connessione etichettata Each item porta al corpo, che viene eseguito una volta per elemento con item impostato; quella etichettata Done viene eseguita dopo tutti gli elementi. Le iterazioni partono insieme a meno che tu imposti concurrency. Sono accettati anche maxIterations e 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 e 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" } } | Tipo | Obbligatorio | Comportamento |
|---|---|---|
wait | params.duration | Mette in pausa per un intervallo in s, m o h. Non esiste un'attesa fino a un momento preciso; per riprendere su un evento, avvia un secondo flusso di lavoro con un trigger su quell'evento. |
http | params.url | Effettua la richiesta. method, headers e body sono facoltativi. |
command | params.command | Esegue un comando della shell. Il suo stdout è l'output dell'attività. |
decide
Un'attività decide pone domande tipizzate sul lavoro svolto fin lì e registra risposte strutturate su cui una condition può instradare.
{
"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 }
}
} | Tipo di domanda | criteria | Risposta |
|---|---|---|
choice | Oggetto da opzione a descrizione, da 2 a 255 opzioni. | choice, confidence e probabilities. |
score | Elenco da 2 a 10 livelli ordinati. | score da 0 (primo livello) in su, e confidence. |
noul | Nessuno. | noul, la probabilità che l'affermazione sia vera. |
Instrada su una risposta con una condition, come nodes.triage.urgency.score >= 1.5. params.default fornisce la risposta sicura per ogni domanda quando non si può prendere una decisione; una risposta predefinita ha confidenza 0. Una domanda senza valore predefinito non riceve risposta, quindi le condition basate su di essa prendono il loro arco False.
Errori
on_error.retry imposta quante volte viene ritentata un'attività non riuscita; il valore predefinito è 1. Dopo l'ultimo tentativo l'esecuzione termina e, con il fallback predefinito notify_owner, il proprietario viene avvisato. Nebo verifica i parametri obbligatori di ogni attività tipizzata all'avvio dell'esecuzione, e rifiuta un ramo che punta a un'attività sconosciuta.