Eingabe- und Ausgabevertrag für den Fall Manager

Suchen Sie die genaue vom Fallmanager benötigte Eingabe- und Ausgabeform, einschließlich der Objekte caseManagerDecisions und caseCurrentExecutionState.

	Maestro-Fall	Maestro-BPMN	Maestro-Flow
Der Inhalt gilt für	✅	❌	❌

Überblick

Der Fallmanager orchestriert einen Fall mithilfe von Regeln, einem Agent oder beiden zusammen. Welchen Modus Sie auch verwenden, die Fallmanager-Aufgabe muss bestimmte Datenstrukturen akzeptieren und zurückgeben. Auf dieser Seite wird dieser Vertrag dokumentiert. Fallmanager-Aufgaben schlagen im Hintergrund fehl (die Ausführung wird als erfolgreich gemeldet, aber es werden keine Aufgaben ausgeführt und es gibt keine Phasenübergänge), wenn die Ausgabe nicht genau diesem Vertrag entspricht.

Eine konzeptionelle Übersicht über die regelbasierte vs. agentische Orchestrierung finden Sie unter Fallmanager im Komponentenwörterbuch.

Eingabevertrag

Feld	Typ	Aufgefüllt von	Beschreibung
caseCurrentExecutionState	Objekt	Maestro (automatisch)	Der aktuelle Status des Falls: welche Phasen aktiv, beendet oder abgeschlossen sind, welche Aufgaben ausgeführt oder abgeschlossen werden und aktuelle Variablenwerte des Falls.
caseRulesDecisions	Objekt	Maestro (nur automatische, regelbasierte oder hybride Setups)	Die eigenen empfohlenen Entscheidungen der Regelengine, die vor der Ausführung des Agents ausgewertet werden. Die gleiche Form wie caseManagerDecisions unten.

Hinweis:

Ordnen Sie keinen Wert selbst einer Eingabe zu. Solange die Fallmanager-Aufgabe eine Eingabe mit einem dieser genauen Namen deklariert, füllt Maestro sie automatisch bei jeder Ausführung aus.

Wann caseCurrentExecutionState verwendet werden soll

Verweisen Sie auf caseCurrentExecutionState, wenn die Entscheidung Ihres Agents vom Fallverlauf abhängt – z. B. „Senden Sie die Folgeaufgabe nur, wenn die Überprüfungsaufgabe bereits abgeschlossen ist“. Dazu gehören:

• Welche Phasen aufgetreten, beendet oder abgeschlossen wurden
• Welche Aufgaben ausgeführt oder abgeschlossen werden
• Fallvariablenwerte, gruppiert nach Phase

Wann caseRulesDecisions verwendet werden sollten

Nur auf caseRulesDecisions verweisen, wenn Ihr Fallplan deterministische Regeln mit einem Agent kombiniert. In diesem Setup wird die Regel-Engine zuerst ausgeführt und trifft eigene empfohlene Entscheidungen – der Agent kann diese als Ausgangspunkt verwenden und überschreiben oder erweitern. Wenn Ihr Fallplan nur den Agent verwendet, benötigen Sie diese Eingabe nicht.

Ausgabevertrag

Die Fallmanager-Aufgabe muss ein einzelnes Ausgabefeld mit dem Namen caseManagerDecisions zurückgeben. Dieses Feld steuert jede Orchestrierungsentscheidung für den Fall.

caseManagerDecisions Schlüssel	Typ	Beschreibung
tasksToRun	Array von Objekten	Als nächstes ausgelöste Aufgaben. Jedes Objekt hat ein Feld: taskName.
tasksToCancel	Array von Objekten	Abzubrechende Aufgaben werden ausgeführt. Jedes Objekt hat ein Feld: identifier, das dem Bezeichner der Aufgabe von caseCurrentExecutionState entspricht.
stagesEntered	Array von Objekten	Zu aktivierende Phasen. Jedes Objekt hat ein Feld: stageName.
stagesExited	Array von Objekten	Phasen, in denen früher beendet wird. Jedes Objekt hat ein Feld: stageName.
stagesCompleted	Array von Objekten	Phasen, die als abgeschlossen markiert werden sollen. Jedes Objekt hat ein Feld: stageName.
caseResolution	Objekt	Beendet den Fall. Enthält type, festgelegt auf completed oder exited.

Jeder Schlüssel ist optional – enthalten Sie nur die Entscheidungen, die für das aktuelle Ereignis relevant sind. Beispielsweise muss eine Entscheidung, die nur eine Aufgabe startet, nicht stagesEntered oder caseResolution enthalten.

{
  "caseManagerDecisions": {
    "tasksToRun": [
      { "taskName": "Task 1" },
      { "taskName": "Task 2" }
    ],
    "stagesCompleted": [
      { "stageName": "Intake" }
    ]
  }
}

So beenden Sie einen Fall:

{
  "caseManagerDecisions": {
    "caseResolution": {
      "type": "completed"
    }
  }
}

Häufiger Fehler

Ein einfaches Array von Aufgabennamen – z. B. ["Task 1", "Task 2"] – ist keine gültige Ausgabe. Der Fallmanager unternimmt im Hintergrund keine Aktion, anstatt einen Validierungsfehler auszugeben. Verschachteln Sie das Array immer unter caseManagerDecisions.tasksToRun, wobei jeder Eintrag als Objekt enthalten ist, das taskName enthält.

Zugehörige Ressourcen

• Festlegen von Aufgaben-I/O- und Write-Back-Verträgen – Fehlerbehebungsschritte, wenn Aufgaben nach dem Korrigieren der Ausgabeform immer noch nicht ausgelöst werden.
• Fallmanager – Übersicht über den regelbasierten vs. agentischen Fallmanager.