用途:面向已存在的 Make 场景,负责运行、启用/停用、查看执行历史与调试失败,以及排查 Webhook 未收到数据。创建或编辑场景不在范围内(见 make-scenario-building),仅解释场景而不运行见 make-scenario-explore。
主要能力:scenario_run 运行场景,行为取决于 scenario_get 返回的 trigger.kind:on-demand 按声明的输入名传入并返回声明的输出;polling/scheduled 立即运行一次,拒绝输入、不返回结果,运行进入历史;webhook 不运行任何内容,只返回 Webhook URL 或应用事件名,需让用户发真实请求后查 scenario_execution_list。scenario_activate 与停用为两个独立工具,已满足的请求视为成功。历史用 scenario_execution_list 与 scenario_execution_get,前者内联 errorMessage,后者给出单次运行的结果、输出与消耗(credits 和 bytes,属用量单位而非金额),无逐模块明细。调试用 scenario_execution_inspect 与 scenario_execution_module_get,前者给出整体状态、错误及每个运行模块的调用与错误计数,后者按 inspect 报告的 cycle 取该模块真实输入输出。Webhook 排查用 scenario_trigger_inspect(查看排队投递、检测到的结构与近期投递)和 scenario_trigger_learn(学习模式,捕获下一次请求结构而不运行场景)。
限制与注意:403 表示整个连接需重新授权全部权限,而非单个工具;结果中的 content remark 是指令而非装饰;调用前应说明歧义值被解析成什么。未激活场景会拒绝运行并指向 scenario_activate,新场景默认未激活。pending 状态表示运行超出等待时间,应查 scenario_execution_get,不要当作失败。无接口的场景传入输入会被静默忽略。运行可能滞后列表数秒。Make 每次运行只记录一个错误,warning 运行无顶层错误,需看 modules[].errors。比较 scenario_get 的 lastEdit 与运行 startedAt,若场景在运行后被编辑,读到的配置未必是实际运行的。…[truncated] 是截断载荷,属文本而非 JSON。无下游消费者的模块输出为空属正常。机密或共享 Webhook、超过 1 MB 的正文及二进制载荷会被占位符替换并在 remark 中说明。