NeboAI
NeboAI
Loslegen

Workflows

Ein Workflow ist Arbeit, die ein Mitarbeiter erledigt, ohne gefragt zu werden: eine Zusammenfassung am Morgen, eine Antwort auf jede neue Nachricht, ein Wochenbericht. Jeder Workflow verbindet einen Trigger mit den Aktivitäten, die der Mitarbeiter ausführt. Workflows liegen in der agent.json des Mitarbeiters und wandern so mit der Rolle mit.

Ein erster Workflow

Füge agent.json eine Zuordnung workflows hinzu. Jeder Schlüssel benennt einen Workflow; jeder Wert hat einen Trigger und Aktivitäten.

{
  "workflows": {
    "morning-summary": {
      "trigger": { "type": "schedule", "cron": "0 8 * * 1-5" },
      "description": "Summarize yesterday's open conversations every weekday morning.",
      "activities": [
        { "id": "summarize", "intent": "Summarize yesterday's open customer conversations and what each one is waiting on." }
      ]
    }
  }
}

Dieser Workflow läuft werktags um 08:00 in der Ortszeit des Bots. Der Mitarbeiter führt die Aktivität mit seiner eigenen Persona, seinen Skills und Verbindungen aus.

Workflow-Felder

FeldBedeutung
triggerPflicht. Wann der Workflow läuft. Siehe Trigger.
descriptionWofür der Workflow da ist.
activitiesDie Schritte. Siehe Aktivitäten.
connectionsKanten {from, to, label}, die die Aktivitäten zu einem Graphen machen. __trigger__ ist der Start und __emit__ das Ende.
emitEvents, die dieser Workflow beim Abschluss ankündigt: eine Liste oder ein durch Kommas getrennter String. Siehe Events.
inputsWerte, die an jeden Lauf übergeben werden.
budget{total_per_run, cost_estimate}. In einem Graph-Lauf begrenzt total_per_run die Ausgabe-Tokens; andernfalls sind beide Schätzungen.
caseMacht den Workflow zu einem lang laufenden Fall pro Person oder Sache. Siehe Fälle.

Ein Workflow mit einem Trigger und ohne Aktivitäten ist gültig. Ein Watch ohne Aktivitäten leitet seine Events nur an andere Workflows weiter.

Wie ein Lauf ausgeführt wird

Ohne connections laufen die Aktivitäten der Reihe nach, und der Mitarbeiter führt jede einzelne aus. Das Ergebnis jeder Aktivität wird an die nächste übergeben. Eine Aktivität ohne Ausgabe beendet den Lauf.

Mit connections bilden die Aktivitäten einen Graphen. Zweige laufen parallel, und sechs Aktivitätstypen laufen ohne das Modell: condition, loop, wait, http, command und decide. Nutze einen Graphen, wenn das Routing exakt sein muss.

{
  "trigger": { "type": "watch", "plugin": "mail", "event": "email.new" },
  "activities": [
    { "id": "classify", "type": "decide",
      "params": {
        "questions": {
          "kind": {
            "type": "choice",
            "instructions": "What kind of message is this?",
            "criteria": { "invoice": "A bill from a vendor", "other": "Anything else" }
          }
        },
        "default": { "kind": "other" }
      } },
    { "id": "is-invoice", "type": "condition", "params": { "expression": "nodes.classify.kind.choice == invoice" } },
    { "id": "record", "intent": "Record the invoice in _watch_payload as a bill and note the due date." }
  ],
  "connections": [
    { "from": "__trigger__", "to": "classify" },
    { "from": "classify", "to": "is-invoice" },
    { "from": "is-invoice", "to": "record", "label": "True" },
    { "from": "record", "to": "__emit__" }
  ],
  "emit": ["invoice.recorded"]
}

Was ein Lauf erhält

Der Mitarbeiter hat immer seine Persona und die Antworten des Inhabers auf seine inputs-Fragen. Je nach Trigger erhält ein Lauf außerdem diese Werte.

EingabeVorhanden, wenn
_event_source, _event_payload, _event_originEin Event-Trigger wurde ausgelöst. Payloads ab 8 KB werden auf ihre skalaren Felder gekürzt, wobei E-Mail-Header und Verweise auf Anhänge erhalten bleiben.
_watch_payloadEin Watch- oder Ordner-Trigger wurde ausgelöst. Eine Zeile der Watcher-Ausgabe oder {files} bei einem Ordner.
inputsImmer. Die eigenen inputs-Werte des Workflows.

Fälle

Manche Arbeit zieht sich über Tage: ein Lead, der Nachfassen braucht, eine Anfrage, die auf Unterlagen wartet. Füge case hinzu, und der Workflow führt einen offenen Fall pro Person oder Sache, statt jedes Mal neu anzufangen.

FeldBedeutung
keyPflicht. Durch Kommas getrennte Punktpfade in die Trigger-Daten, die das Subjekt identifizieren, etwa contactEmail,email,phone.
typeDie Art des Falls, etwa lead. Workflows mit demselben Typ teilen sich Fälle. Standard ist der Name des Workflows.
default_waitWie lange gewartet wird, wenn ein Durchgang keine Wartezeit nennt: 3d, 12h, 45m. Standard drei Tage.

Jeder Durchgang eines Falls muss mit genau einem JSON-Objekt enden, ohne etwas danach. result ist der geschäftliche Zustand; next sagt der Engine, ob sie wait oder close ausführen soll. Eine Frist ist RFC 3339 oder eine relative Zeitspanne. Alles andere ist ein ungültiger Durchgang.

{"result": {"status": "awaiting_documents", "summary": "Requested two bank statements"},
 "next":   {"action": "wait", "on": "signal", "deadline": "3d", "reason": "documents"}}

Grenzen und Wiederherstellung

  • Jede Aktivität kann bis zu 50 Modelldurchgänge nutzen, sofern params.maxIterations nichts anderes festlegt.
  • In einem Graphen kann eine Aktivität pro Lauf höchstens 10.000-mal laufen.
  • Das Ausgabenlimit des Inhabers für den Mitarbeiter stoppt einen Lauf, sobald es erreicht ist. Das token_budget einer Aktivität ist eine Schätzung.
  • Ein durch einen Neustart unterbrochener Lauf wird als unterbrochen markiert und einmal fortgesetzt.
  • Der Mitarbeiter kann einen Lauf mit dem Tool exit vorzeitig beenden.

Workflows ausführen und verwalten

Der Inhaber kann jeden Workflow von Hand starten. Mitarbeiter verwalten Workflows mit run_workflow, workflow_status, list_workflow_runs, set_workflow_enabled und den anderen Workflow-Tools, die unter Helfer und Teams aufgeführt sind.