NeboAI
NeboAI
Inizia

Attività

Un'attività è un passaggio di un flusso di lavoro. La maggior parte delle attività viene svolta dal dipendente: tu indichi l'intento e lui fa il lavoro con le sue skill e connessioni. Sei tipi vengono eseguiti senza il modello, così instradamento e tempi restano esatti.

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" }
}
CampoPredefinitoSignificato
idobbligatorioUnivoco all'interno del flusso di lavoro. Usato in connections e nei percorsi dei dati.
typecustomUn passaggio del dipendente, oppure uno tra condition, loop, wait, http, command, decide.
intentnessunoCosa deve ottenere il dipendente. Un passaggio del dipendente richiede intent o steps.
steps[]Istruzioni in sequenza, quando una frase non basta.
labelnessunoNome 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.
modelnessunoUn id di modello per questo passaggio.
paramsnessunoParametri per le attività tipizzate, e maxIterations per i passaggi del dipendente.
min_iterationsnessunoNumero minimo di turni del modello prima che il passaggio possa terminare.
token_budgetnessuno{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
expressionIl 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.
existsUn percorso; vero quando si risolve in un valore truthy.
containspath contains text, oppure testo semplice confrontato con l'output precedente.
regexUn 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" } }
TipoObbligatorioComportamento
waitparams.durationMette 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.
httpparams.urlEffettua la richiesta. method, headers e body sono facoltativi.
commandparams.commandEsegue 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 domandacriteriaRisposta
choiceOggetto da opzione a descrizione, da 2 a 255 opzioni.choice, confidence e probabilities.
scoreElenco da 2 a 10 livelli ordinati.score da 0 (primo livello) in su, e confidence.
noulNessuno.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.