NeboAI
NeboAI
Loslegen

Aktivitäten

Eine Aktivität ist ein Schritt eines Workflows. Die meisten Aktivitäten führt der Mitarbeiter aus: Du nennst das Ziel, und er erledigt die Arbeit mit seinen Skills und Verbindungen. Sechs Typen laufen ohne das Modell, damit Routing und Timing exakt bleiben.

Felder

{
  "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" }
}
FeldStandardBedeutung
iderforderlichEindeutig innerhalb des Workflows. Wird in connections und Datenpfaden verwendet.
typecustomEin Mitarbeiterschritt oder einer von condition, loop, wait, http, command, decide.
intentkeinerWas der Mitarbeiter erreichen soll. Ein Mitarbeiterschritt braucht intent oder steps.
steps[]Geordnete Anweisungen, wenn ein Satz nicht reicht.
labelkeinerName, der dem Inhaber angezeigt wird.
skills[]Zu nutzende Skills. Hier aufgeführte Marktplatz-Skills werden mit dem Mitarbeiter installiert.
tools[]Falls gesetzt, die einzigen Tools, die der Schritt nutzen darf.
requires_tools[]Tools, die erfolgreich sein müssen, damit der Schritt als erledigt gilt.
cmds[]Plugin-Befehle, die für den Schritt genannt werden.
mcps[]MCP-Server, die für den Schritt genannt werden.
modelkeinerEine Modell-ID für diesen Schritt.
paramskeinerParameter für die typisierten Aktivitäten und maxIterations für Mitarbeiterschritte.
min_iterationskeinerMindestanzahl an Modelldurchgängen, bevor der Schritt enden darf.
token_budgetkeiner{max}. Eine Schätzung.
on_error{retry: 1, fallback: notify_owner}Wiederholungen, dann der Fallback. Jeder Fehler nach den Wiederholungen beendet den Lauf.

Mitarbeiterschritte

Ein Mitarbeiterschritt läuft als Durchgang des Mitarbeiters: Seine Persona, sein Gedächtnis und seine Verbindungen gelten, und er kann bis zu 50 Modelldurchgänge nutzen oder params.maxIterations. Die Ergebnisse früherer Schritte werden als [Activity 'id' result]-Blöcke übergeben. Der Schritt, der einen Workflow mit einer emit-Liste beendet, wird angewiesen, emit_event mit diesen Events aufzurufen. Das Tool exit ist immer verfügbar, um den Lauf zu beenden.

Der Datenkontext

Typisierte Aktivitäten lesen Werte per Punktpfad aus einem Objekt: inputs enthält die Eingaben des Laufs, nodes.<id> die Ausgabe jeder abgeschlossenen Aktivität (als JSON geparst, wenn sie JSON ist) und item das aktuelle Element innerhalb einer Schleife. Ein bloßer Pfad sucht zuerst in inputs, dann in nodes.

condition

{ "id": "large", "type": "condition", "params": { "expression": "inputs.amount >= 500" } }

params.expression ist Pflicht. Die ausgehenden Verbindungen sind mit True und False beschriftet. params.mode legt fest, wie der Ausdruck gelesen wird:

ModusAusdruck
expressionDer Standard. path op value mit ==, !=, >=, <=, > oder <, als Zahlen verglichen, wenn beide Seiten Zahlen sind; oder ein bloßer Pfad, wahr, wenn sein Wert truthy ist.
existsEin Pfad; wahr, wenn er einen Truthy-Wert ergibt.
containspath contains text oder bloßer Text, der mit der vorherigen Ausgabe abgeglichen wird.
regexEin Muster, das mit der vorherigen Ausgabe abgeglichen wird.

loop

{ "id": "each-invoice", "type": "loop", "params": { "source": "nodes.fetch.invoices", "concurrency": 4 } }

params.source ist der Pfad einer Liste. Die mit Each item beschriftete Verbindung führt zum Rumpf, der für jedes Element einmal mit gesetztem item läuft; die mit Done beschriftete läuft nach allen Elementen. Die Iterationen starten gleichzeitig, sofern du nicht concurrency setzt. maxIterations und batchSize werden ebenfalls akzeptiert.

"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 und 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" } }
TypPflichtVerhalten
waitparams.durationPausiert für eine Zeitspanne in s, m oder h. Ein Warten bis zu einem Zeitpunkt gibt es nicht; um bei einem Event fortzufahren, löse damit einen zweiten Workflow aus.
httpparams.urlSendet die Anfrage. method, headers und body sind optional.
commandparams.commandFührt einen Shell-Befehl aus. Seine stdout-Ausgabe ist die Ausgabe der Aktivität.

decide

Eine decide-Aktivität stellt typisierte Fragen zur bisherigen Arbeit und speichert strukturierte Antworten, nach denen eine condition routen kann.

{
  "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 }
  }
}
FragetypcriteriaAntwort
choiceObjekt aus Option und Beschreibung, 2 bis 255 Optionen.choice, confidence und probabilities.
scoreListe von 2 bis 10 geordneten Stufen.score ab 0 (erste Stufe) aufwärts und confidence.
noulKeine.noul, die Wahrscheinlichkeit, dass die Aussage zutrifft.

Route mit einer condition anhand einer Antwort, etwa nodes.triage.urgency.score >= 1.5. params.default gibt für jede Frage die sichere Antwort an, wenn keine Entscheidung getroffen werden kann; eine Standardantwort hat die Konfidenz 0. Eine Frage ohne Standard erhält keine Antwort, sodass Bedingungen darauf ihre False-Kante nehmen.

Fehler

on_error.retry legt fest, wie oft eine fehlgeschlagene Aktivität wiederholt wird; der Standard ist 1. Nach der letzten Wiederholung endet der Lauf, und mit dem Standard-fallback notify_owner wird der Inhaber benachrichtigt. Nebo prüft beim Start des Laufs die Pflichtparameter jeder typisierten Aktivität und lehnt einen Zweig ab, der auf eine unbekannte Aktivität zeigt.