Keyboard shortcuts

Press or to navigate between chapters

Press ? to show this help

Press Esc to hide this help

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 listzeroclaw sop approve)或通过 gateway API 审批端点(GET /admin/sop/pendingPOST /admin/sop/approvePOST /admin/sop/deny)清除或查看它们。

另见