SOP Fan-In:手动
手动触发会从 agent 回合内部启动一次运行,而不是由外部事件启动。agent 调用 sop_execute 工具,并指定要运行的 SOP。无需配置监听器或事件源;运行会在 agent 决定启动时开始。
当执行与否的决定属于代理的推理而不是外部信号时,请使用手动触发器。这是 worked example 所采用的路径:一个发布通过某个渠道到达,代理对其进行推理,然后自行触发 SOP。
定义它
带有 manual 触发器的 SOP 没有匹配字段。有关触发器块,请参见 Syntax。像任何其他 SOP 一样对其进行验证和检查:
zeroclaw sop validate
zeroclaw sop list
zeroclaw sop show <name>
从仪表盘启动一个
仪表盘的运行按钮(POST /sops/{name}/run)会触发相同的 manual 事件,因此 manual 触发器可以从两个方向被调用:一是智能体的一轮对话,二是没有智能体参与的操作员。从仪表盘启动的运行与 cron 运行一样,以无头模式驱动。
通过 sop_execute 启动时,由调用方 agent 持有该次运行,因此 agent 是可选的;从仪表盘启动的运行没有可继承的 agent。因此,如果某个流程的 execute 步骤未声明负责人,端点会拒绝启动并返回 422(错误信息会列出这些步骤),而不是启动一个必然在第一步失败的运行。编写时只会发出警告而不会阻止保存,因此仅供 sop_execute 使用的流程仍可保存。要让手动 SOP 能从仪表盘启动,请在 SOP.toml 中(或在步骤上)设置 agent。
批准并观察
命中检查点的运行会暂停为 WaitingApproval。可使用 CLI(zeroclaw sop list、zeroclaw sop approve)或通过 gateway API 审批端点(GET /admin/sop/pending、POST /admin/sop/approve、POST /admin/sop/deny)清除或查看它们。