接入传感器
worker(计算后端与执行器)部分已移至接入计算后端与执行器。
智能体的可信,一半来自物理世界的证据与回执。这一页讲操作:怎么让传感器把观测推上智能体的板。概念先读智能体由什么构成的连接与接线两节。
三类接入(传感器/计算后端/执行器)共用同一套注册流程:在控制台注册拿身份与密钥(密钥只显示一次;传感器在「可信数据源」页,计算后端与执行器在「计算与执行器」页),然后你的系统用纯出站 HTTPS 与云端往来——防火墙不用开任何入站口。
传感器:实现一条 HTTP POST
传感器端要实现的全部,就是"事件发生了就推":
curl -X POST https://api.rulith.com/observe \
-H "x-rulith-channel: <你的通道 id>" \
-H "x-rulith-channel-key: <你的密钥>" \
-H "content-type: application/json" \
-d '{"facts":[{"predicate":"signed","args":{"request":"R1","by":"张三"}}]}'
任何能发 HTTPS 的东西都够格:十行脚本、一个 cron 任务、OA 的 webhook 转发。已有系统不必改造——加一个"桥"(收到内部事件 → 组这个 JSON → POST)即可。
规矩只有三条,违反的请求会收到写明原因的拒绝:
- 词要先在「可信数据源」页绑定给这条连接——没绑词推什么都被拒(这正是"晚绑不产生来历不明历史"的保证);
- 只能推绑定过的词——越出范围被拒,这是连接的权限边界;
- 密钥要对——错钥与不存在的连接收到同一句拒绝,不给探测者提供线索。
验签通过的数据落板即带「实证」标记与出身(经哪条连接)。到「智能体」页能立即看到这条材料。
当前边界(如实说明)
- 解绑单个词、把词改绑到另一条连接尚未开放——目前的生命周期操作是连接级的(吊销 / 重新发钥)。
进度与验证记录见生产状态。计算后端与执行器的接入(worker 三步、工具表、围栏),见接入计算后端与执行器。
正文住
content/*.md;能力清单、工具清单、字段矩阵由生成器从实现代码抽取
(快照在 facts.json)——改了实现而忘了改文档,校验会自己发现。