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
| Feld | Bedeutung |
|---|---|
trigger | Pflicht. Wann der Workflow läuft. Siehe Trigger. |
description | Wofür der Workflow da ist. |
activities | Die Schritte. Siehe Aktivitäten. |
connections | Kanten {from, to, label}, die die Aktivitäten zu einem Graphen machen. __trigger__ ist der Start und __emit__ das Ende. |
emit | Events, die dieser Workflow beim Abschluss ankündigt: eine Liste oder ein durch Kommas getrennter String. Siehe Events. |
inputs | Werte, 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. |
case | Macht 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.
| Eingabe | Vorhanden, wenn |
|---|---|
_event_source, _event_payload, _event_origin | Ein 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_payload | Ein Watch- oder Ordner-Trigger wurde ausgelöst. Eine Zeile der Watcher-Ausgabe oder {files} bei einem Ordner. |
inputs | Immer. 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.
| Feld | Bedeutung |
|---|---|
key | Pflicht. Durch Kommas getrennte Punktpfade in die Trigger-Daten, die das Subjekt identifizieren, etwa contactEmail,email,phone. |
type | Die Art des Falls, etwa lead. Workflows mit demselben Typ teilen sich Fälle. Standard ist der Name des Workflows. |
default_wait | Wie 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.maxIterationsnichts 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_budgeteiner 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
exitvorzeitig 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.