案例管理器输入和输出合同

查找案例管理器所需的确切输入和输出形状，包括 caseManagerDecisions 和 caseCurrentExecutionState 对象。

	Maestro 案例	Maestro BPMN	Maestro 流程
内容适用于	✅	❌	❌

概述

案例管理器使用规则和/或智能体编排案例。无论使用哪种模式，案例管理器任务都必须接受并返回特定的数据形状。此页面记录该合同。当输出与此合同不完全匹配时，案例管理器任务将失败（运行报告为成功，但不会执行任何任务，也不会进行阶段转换）。

有关基于规则的编排与智能体编排的概念概述，请参阅组件字典中的“案例管理器” 。

输入合同

字段	类型	填充对象	描述
caseCurrentExecutionState	对象	Maestro（自动）	案例的当前状态：哪些阶段处于活动状态、哪些已退出或已完成，哪些任务正在运行或已完成，以及当前的案例变量值。
caseRulesDecisions	对象	Maestro（仅限自动设置、基于规则的或混合设置）	规则引擎自身的建议决策，在智能体运行前评估。与下方 caseManagerDecisions 相同的形状。

备注：

请勿自行将值映射到任一输入。只要案例管理器任务使用这些确切名称之一声明了输入，Maestro 就会在每次运行时自动填充该名称。

何时使用案例当前执行状态

当智能体的决策取决于案例历史时，参考 caseCurrentExecutionState — 例如，“仅在审核任务已完成的情况下发送后续任务”。其中包括：

• 已进入、退出或完成哪些阶段
• 哪些任务正在运行或已完成
• 案例变量值，按阶段分组

何时使用案例规则决策

仅当您的案例计划将确定性规则与智能体相结合时，引用 caseRulesDecisions。在此设置中，规则引擎首先运行，并生成自己的推荐决策——智能体可以以此为起点，对其进行覆盖或扩展。如果您的案例计划仅使用智能体，则不需要此输入。

输出合同

案例管理器任务必须返回名为 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": {
    "caseResolution": {
      "type": "completed"
    }
  }
}

常见错误

普通的任务名称数组（例如 ["Task 1", "Task 2"]）不是有效的输出。案例管理器不会静默执行任何操作，不会引发验证错误。始终将数组嵌套在 caseManagerDecisions.tasksToRun 下，每个条目都作为包含 taskName 的对象。

相关资源

• 建立任务 I/O 和回写合同— 修复输出形状后仍无法触发任务时的故障排除步骤。
• 案例管理器— 基于规则的案例管理器与智能体案例管理器概述