SOP Fan-In: MQTT
MQTT 消息可以启动 SOP 运行。MQTT 监听器订阅 broker,为每条消息构建一个 SOP 事件,并将其分发给引擎。此路径受 channel-mqtt 构建特性控制。
传输端(broker URL、凭据、TLS、QoS)在 MQTT channel 上配置。此页面介绍触发器。
触发器
MQTT 消息到达。Live:由 MQTT 监听器传递。
| 字段 | 类型 | 默认 | 含义 |
|---|---|---|---|
condition | 字符串? | null | 可选表达式,针对消息载荷进行求值;运行 |
topic* | 字符串 | — | 主题过滤器。+ 匹配一层,# 匹配剩余层级。 |
加载并验证 SOP:
定义
根据 Syntax 中的说明编写 SOP,并使用 mqtt 触发器。上方的触发器字段是受支持的键;该页面会完整讲解整个文件。
验证
zeroclaw sop validate
检查
zeroclaw sop list
zeroclaw sop show <name>
匹配
主题模式支持 +(单层)和 #(多层)通配符。MQTT 负载会转发到 SOP 事件负载中,并可供可选的触发器 condition 使用;步骤上下文接收的是截断、已清理、已加帧的形式。像 $.value > 85 这样的 JSON-path condition 要求发布者发送 JSON 正文。
启动它
在加载了 SOP 且订阅了 MQTT 频道后,将消息发布到触发器模式匹配的主题(例如使用 mosquitto_pub,或任何 broker 客户端)。监听器会根据主题和有效载荷构建事件并分发它。对于每个已加载且其 topic 模式匹配、并且其 condition(如有)对有效载荷成立的 SOP,都会启动一次运行。
如果没有任何内容启动,请确认主题与触发器模式匹配、broker 订阅处于活动状态,并且 condition 与负载匹配。请参阅 fan-in 概览故障排查表。
批准并观察
命中检查点的运行会暂停为 WaitingApproval。可使用 CLI(zeroclaw sop list、zeroclaw sop approve)或通过 gateway API 审批端点(GET /admin/sop/pending、POST /admin/sop/approve、POST /admin/sop/deny)清除或查看它们。