RULITH 规据 接入传感器

接入传感器

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)——改了实现而忘了改文档,校验会自己发现。