- はじめに
- スタート アップ ガイド
- BPMN を使用したプロセス モデリング
- ケース管理を使用したプロセス モデリング
- フローを使用したプロセス モデリング
- プロセスの実装
- プロセスの操作
- プロセスの監視
- プロセスの最適化
- 参考情報
caseManagerDecisions オブジェクトや caseCurrentExecutionState オブジェクトなど、ケース・マネージャーが必要とする正確な入力および出力の形状を調べます。
| Maestro Case | Maestro BPMN | Maestro Flow | |
|---|---|---|---|
| 適用されるコンテンツ | ✅ | ❌ | ❌ |
概要
ケース マネージャーは、ルール、エージェント、またはその両方を一緒に使用してケースをオーケストレーションします。どちらのモードを使用する場合でも、Case Manager タスクは特定のデータ形状を受け入れて返す必要があります。このページでは、その契約について説明します。Case Manager タスクは、出力がこのコントラクトと完全に一致しない場合、サイレントに失敗します (実行は成功として報告されますが、タスクは実行されず、ステージは遷移しません)。
ルールベースのオーケストレーションとエージェンティック オーケストレーションの概念の概要については、コンポーネント ディクショナリの 「ケース マネージャー 」をご覧ください。
入力コントラクト
| フィールド | 入力 | ユーザーが | 説明 |
|---|---|---|---|
caseCurrentExecutionState | オブジェクト | Maestro (自動) | ケースの現在のステート: アクティブ、終了、または完了したステージ、実行中または完了したタスク、および現在のケース変数値。 |
caseRulesDecisions | オブジェクト | Maestro (自動、ルールベース、またはハイブリッド設定のみ) | エージェントの実行前に評価される、ルール エンジン独自の推奨される決定。下の caseManagerDecisionsと同じ形。 |
どちらの入力にも値を自分でマッピングしないでください。ケース マネージャー タスクが入力をこれらの正確な名前のいずれかで宣言している限り、Maestro によって実行のたびに自動的に入力が行われます。
caseCurrentExecutionState を使用する状況
エージェントの決定がケース履歴に依存する場合の参照 caseCurrentExecutionState (例: 「レビュー タスクがすでに完了している場合にのみ、フォローアップ タスクを送信してください」)。以下の項目が含まれます。
- どのステージに入ったか、どのステージを終了したか、または完了したか
- 実行中または完了しているタスク
- ケース変数の値、ステージ別にグループ化
ケースを使用する状況ルールDecisions
ケース プランで決定論的なルールがエージェントと組み合わさっている場合にのみ、 caseRulesDecisions を参照します。その設定では、ルール エンジンが最初に実行されて独自の推奨される意思決定を生成します。エージェントはそれを出発点として使用し、それを上書きまたは拡張できます。ケース プランでエージェントのみを使用する場合は、この入力は必要ありません。
出力コントラクト
ケース マネージャー タスクは、 という名前の 1 つの出力フィールドを返す必要があります caseManagerDecisions。このフィールドは、ケースのすべてのオーケストレーションの決定を制御します。
caseManagerDecisions キー | 入力 | 説明 |
|---|---|---|
tasksToRun | オブジェクトの配列 | 次にトリガーするタスク。各オブジェクトには、 taskNameというフィールドがあります。 |
tasksToCancel | オブジェクトの配列 | キャンセルする実行中のタスク。各オブジェクトには、 のタスク識別子と一致するフィールド identifier caseCurrentExecutionStateがあります。 |
stagesEntered | オブジェクトの配列 | アクティブ化するステージ。各オブジェクトには、 stageNameというフィールドがあります。 |
stagesExited | オブジェクトの配列 | 早期に終了する段階。各オブジェクトには、 stageNameというフィールドがあります。 |
stagesCompleted | オブジェクトの配列 | 完了としてマークするステージ各オブジェクトには、 stageNameというフィールドがあります。 |
caseResolution | オブジェクト | 事件は終了です。typeを含む、completed または exitedに設定されています。 |
すべてのキーは任意です。現在のイベントに関連する決定のみを含めます。たとえば、タスクを開始するだけの意思決定には、 stagesEntered や caseResolutionを含める必要はありません。
{
"caseManagerDecisions": {
"tasksToRun": [
{ "taskName": "Task 1" },
{ "taskName": "Task 2" }
],
"stagesCompleted": [
{ "stageName": "Intake" }
]
}
}
{
"caseManagerDecisions": {
"tasksToRun": [
{ "taskName": "Task 1" },
{ "taskName": "Task 2" }
],
"stagesCompleted": [
{ "stageName": "Intake" }
]
}
}
ケースを終了するには、以下の手順を実行します。
{
"caseManagerDecisions": {
"caseResolution": {
"type": "completed"
}
}
}
{
"caseManagerDecisions": {
"caseResolution": {
"type": "completed"
}
}
}
よくある間違い
タスク名のプレーンな配列 ( ["Task 1", "Task 2"] など) は有効な出力ではありません。ケース・マネージャーは、検証エラーを発生させる代わりに、サイレントにアクションを実行しません。配列は必ず の下に入れ子に caseManagerDecisions.tasksToRun、各エントリは を含むオブジェクトとして入れ子 taskName。
関連リソース
- タスク I/O コントラクトとライトバック コントラクトの確立 — 出力図形を修正してもタスクがトリガーされない場合のトラブルシューティング手順です。
- ケース マネージャー — ルールベースのケース マネージャーとエージェンティック ケース マネージャーの概要