find_mqttable_capabilities在 capability id 未知时查找一个 typed action、workflow、resource 或 prompt。
Mqttable for AI Agents
Mqttable 让兼容 Agent 发现运行时、读取有界 MQTT 证据,并通过唯一修改入口执行已授权操作。服务端负责提交检查和结果取证。
合成流程演示:静态文本,不是实时遥测。Mqttable 不调用,也不内置独立模型。
01 · Discover
$ query_mqttable → mqttable://runtime/status
find_mqttable_capabilities → describe_mqttable_capabilityRuntime 位于本机回环,MCP 已启用,运行健康状态正常,schema 内含示例。
02 · Capture
$ query_mqttable → mqtt.qos.analyze_flow
query_mqttable → proxy.toxic.listQoS 分析发现重复 PUBLISH 与 2.6 秒到达的 PUBACK;Proxy 报告 2400 ms downstream latency。
03 · Reproduce
$ query_mqttable → bounded Trace URI
query_mqttable → proxy.toxic.list有界 Trace、Proxy 与 Monitor 证据共同指向下行延迟,本地运行时压力保持正常。
04 · Act
$ execute_mqttable_action({ action: "proxy.toxic.delete", input: { … }, idempotency_key: "remove-fault-once" })本次操作只针对 latency_downstream。重试时复用幂等键,不会因为响应丢失而再次执行。
05 · 结果证据
$ query_mqttable → operation.read
query_mqttable → mqtt.qos.analyze_flow先看操作返回的结果证据。只有结果待定或未知时才查询 operation.read,再按用户目标检查 MQTT 流程证据。
QoS 1 延迟重试
读取工具不产生业务副作用。MCP 已启用且运行时健康时,一次执行调用即可完成受支持修改的检查、执行和结果验证。
Runtime 位于本机回环,MCP 已启用,运行健康状态正常,schema 内含示例。
QoS 分析发现重复 PUBLISH 与 2.6 秒到达的 PUBACK;Proxy 报告 2400 ms downstream latency。
有界 Trace、Proxy 与 Monitor 证据共同指向下行延迟,本地运行时压力保持正常。
本次操作只针对 latency_downstream。重试时复用幂等键,不会因为响应丢失而再次执行。
先看操作返回的结果证据。只有结果待定或未知时才查询 operation.read,再按用户目标检查 MQTT 流程证据。
紧凑外部契约
Example 已并入 schema expansion。能力深度可以变化,而无需让 Agent 学习新的顶层工具列表。
find_mqttable_capabilities在 capability id 未知时查找一个 typed action、workflow、resource 或 prompt。
describe_mqttable_capability返回一个准确的 action、resource 或 workflow 契约与 compact example。
query_mqttable查询数据、运行无副作用分析,或读取一个有界 mqttable:// resource。
execute_mqttable_action执行一个已授权的有副作用 action,并返回持久化 Operation 证据。
diagnose_mqttable返回 Mqttable Runtime 与 MCP 服务的被动或显式主动诊断。
持久本地策略
启用 MCP 即授权受支持的读取与变更。每次变更仍需通过运行时检查。
mcp_enabled: falseendpoint 关闭;用户重新启用后,原 URL-only 客户端配置可以继续使用。
mcp_enabled: true本机客户端可以读取证据、执行受支持的操作。启用状态持续有效,直到你关闭 MCP。
运行健康状态与启用开关独立。变更服务异常时拒绝写入,但不改变用户设置;可用的诊断读取仍保留。
硬边界
本地 MCP client 无需客户端凭据,直接连接 loopback endpoint。浏览器 Origin 请求会被拒绝,mutable call 仍需要有效变更门禁。
MCP 只接受 loopback HTTP;非 loopback 请求没有配置开关或 authorization provider 旁路。
密码、bearer token、PEM 证书与 private key 通过第一方 intake 录入;Agent 流程只引用 SecretRef、CertRef 与 KeyRef handles。
Replay 场景在 Workbench 中创建、审阅、Dry Run 与执行。当前没有 Replay 专用 MCP 执行面。
打开 Settings → MCP,为受信任的本机客户端启用 MCP。修改仍需通过当前授权和运行时健康检查。
复制生成的 URL-only 客户端配置。停用或重新启用 MCP 不会使它失效,也没有客户端凭据生命周期。
先读 runtime info;只有 capability id 未知时才 search;调用前先读对应 schema。
Agent FAQ
打开下载页,在设置中选择 MCP 访问模式,并从运行时发现开始,而不是猜测状态。