NeboAI
NeboAI
Aan de slag

Activiteiten

Een activiteit is één stap van een workflow. De meeste activiteiten voert de medewerker uit: jij geeft het doel aan en hij doet het werk met zijn skills en verbindingen. Zes typen draaien zonder het model, zodat routering en timing exact blijven.

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" }
}
VeldStandaardBetekenis
idverplichtUniek binnen de workflow. Gebruikt in connections en gegevenspaden.
typecustomEen stap van een medewerker, of een van condition, loop, wait, http, command, decide.
intentgeenWat de medewerker moet bereiken. Een stap van een medewerker heeft intent of steps nodig.
steps[]Geordende instructies, als één zin niet genoeg is.
labelgeenNaam 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.
modelgeenEen model-id voor deze stap.
paramsgeenParameters voor de getypeerde activiteiten, en maxIterations voor stappen van medewerkers.
min_iterationsgeenMinimaal aantal modelbeurten voordat de stap mag eindigen.
token_budgetgeen{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:

ModusExpressie
expressionDe standaard. path op value met ==, !=, >=, <=, > of <, vergeleken als getallen wanneer beide kanten getallen zijn; of een kaal pad, waar als de waarde truthy is.
existsEen pad; waar als het verwijst naar een truthy waarde.
containspath contains text, of losse tekst die wordt vergeleken met de vorige uitvoer.
regexEen 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" } }
TypeVerplichtGedrag
waitparams.durationPauzeert 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.
httpparams.urlDoet het verzoek. method, headers en body zijn optioneel.
commandparams.commandVoert 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 }
  }
}
VraagtypecriteriaAntwoord
choiceObject van optie naar beschrijving, 2 tot 255 opties.choice, confidence en probabilities.
scoreLijst van 2 tot 10 geordende niveaus.score vanaf 0 (eerste niveau) oplopend, en confidence.
noulGeen.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.