lenses.run模块 26平台模块
平台模块Governance lenses
对您交给它的数据运行固定的检查，得到带证据的通过或失败，每次答案都相同。
lenses.run 对您发送的 input 评估一个已安装的透镜。透镜是一条确定性规则：个人数据模式、重叠的租约或超出范围的请求。结果带有发现、证据，以及规则和输入的摘要。不涉及任何模型。
lenses.run模块 26对您交给它的数据运行固定的检查，得到带证据的通过或失败，每次答案都相同。
lenses.run 对您发送的 input 评估一个已安装的透镜。透镜是一条确定性规则：个人数据模式、重叠的租约或超出范围的请求。结果带有发现、证据，以及规则和输入的摘要。不涉及任何模型。
透镜不读取工作区自己的记录。请把您要检查的租约、授权或文本取出，作为 input 发送。共有三种规则类型；第四种需要修改代码。
installIdinstall 或 list。inputparametersstatus扫描 input 中的每个字符串，查找电子邮件、美国社会安全号码和电话号码的模式。发现项带有路径和计数；匹配的值绝不保留。
接受 input.leases，每项带有 resource、holder 以及开始和结束时间。标出同一资源上由不同持有者持有、时间重叠的两个租约。
点击运行，将左侧的请求发送到共享演示工作区。
在共享的演示工作区中使用演示密钥运行：任何人都可以看到其中的内容，因此请勿发送任何私密信息。
一个符合 API 接受格式的请求，以及模块返回格式的示例响应。
POST /api/v1/acp/lenses/run Authorization: Bearer av_workspace_•••• Content-Type: application/json { : , : }
对草稿载荷运行 pii_presence。发现项给出每处命中的 JSON 路径和计数，匹配的文本不被存储。
把租约列表发给 lease_overlap。在重叠时间内同一资源上有两个持有者的情况，会作为成对的证据连同两个租约引用返回。
连同一个请求发送授权的 actions 和 resources。超出范围的资源会失败，并带有违规字段的路径。
模块是对一件狭窄事情的强力保证。请仅在其确切范围内依赖它。
input 产生相同的发现、证据和 digest，因为不读取时钟或模型。pii_presence 记录模式在哪里被发现以及出现多少次，而不是匹配的文本。definitionDigest 指明产生它的确切规则版本。install、create 和 update 需要 Pro 等级，publish 需要 Scale。run 没有等级要求。install 和 uninstall 还需要管理员角色。
使用工作区 API 密钥作为 Bearer 令牌进行认证。基础 URL 为 https://api.intramedial.com。
/api/v1/acp/lenses/catalog列出透镜目录。/api/v1/acp/lenses/list列出此工作区中的定义和安装。
pass，否则为 fail。findingscode（如 pii.present、lease.overlap 或 mandate.out_of_scope）、message 和 path。evidencekind、path 和一个 detail 对象。definitionDigestinputDigestinput 和 parameters 的 SHA-256 摘要，因此相同的数据给出相同的摘要。digestid 或 executedAt。接受 input.mandate（actions、resources）和 input.request（action、resource）。标出超出授权的请求；* 和结尾的 * 可匹配。
catalog 列出内置透镜和发布到您工作区的任何透镜。每个条目标明其规则类型。
install 把目录条目作为未激活的安装复制到工作区。activate 将其开启。运行未激活的安装会返回 409。
发送 installId 和形状与规则相符的 input。缺失或格式错误的 input 会返回 400 并指明问题。
结果会被存储。results 按 resultId 返回其中一个，或返回某个 installId 的所有结果。
{
"result": {
"id": "result_3f9a",
"installId": "install_7c2e",
"definitionId": "lens_builtin_lease_overlap",
"version": 1,
"definitionDigest": "sha256:5b1d0c9e7a42",
"inputDigest": "sha256:e07a93b1c6d8",
"status": "fail",
"findings": [
{
"code": "lease.overlap",
"message": "overlapping leases for repo:payments/main",
"path": "$.leases"
}
],
"evidence": [
{
"kind": "lease_overlap",
"path": "$.leases",
"detail": {
"resource": "repo:payments/main",
"left": "l1",
"right": "l2"
}
}
],
"digest": "sha256:a2c4e8f016b3",
"executedAt": "2026-11-01T09:12:00.000Z"
}
}结果的 definitionDigest 和 inputDigest 让审阅者可以对同样的数据重新运行检查并比较。
coordination.admit；透镜只报告数据，不阻止任何东西。coordination.lease 中；透镜检查的是您传入的列表。detection.run，它运行检测器包。results 之后可按 id 返回。create 和 update 存储新的定义版本。它们只能在现有规则类型中选择，并给出名称、说明和参数模式。publish 把自定义定义作为非精选的社区条目放入目录。内置条目是精选的。
activate 和 deactivate 需要 policies.approve；create 和 update 需要 policies.propose。
重叠需要不同的持有者。同一个持有者在一个资源上有两个重叠的租约，不算发现。
pii_presence、lease_overlap 和 mandate_scope。不受支持的类型返回 400。resource、holder，以及开始时间和随后的结束时间；有问题的租约返回 400 并指明其序号。mandate_scope 需要字符串形式的 mandate.actions、mandate.resources、request.action 和 request.resource。/api/v1/acp/lenses/install/api/v1/acp/lenses/activate开启一个安装。/api/v1/acp/lenses/run对您发送的 input 评估一个安装。/api/v1/acp/lenses/results读取一个已存储的结果，或某个安装的所有结果。coordination.lenses.run从智能体运行透镜。coordination.lenses.results从智能体读取已存储的结果。coordination.lenses.catalog从智能体列出目录。coordination.lenses.activate从智能体激活一个安装。detection.run07civics.settings23Workspace constitution为此工作区的每种紧急程度，设定真人必须多快回答您的智能体的提问，以及谁值班。change-trains.list24Staged change trains先把变更推给集群的一部分，对照测得的信号检查，再逐阶段向前推进。packs.list25Signed pack registry从外部引入一个由智能体、授权和演练组成的包，并知道是谁签署的，以及途中是否有任何字节被更改。attestation.policy27Artifact build attestation决定您接受哪些构建者来构建策略快照和检测器包，并拒绝受信任作者签名但由另一次构建产生的内容。pack-revenue.balances28Pack revenue ledger在任何人获得付款之前，查看每位包作者赚了多少、还欠多少，每一个最小货币单位都有账可查。