SuperAPI AI 工具集

agent-decision-receipts

智能体与模型

查看项目

更新于 10-15 19:54

技能介绍

用途:为智能体的重要操作生成防篡改收据。日志只说明发生了什么且可被静默修改;收据在执行前或执行时开具,记录谁、做了什么、依据哪条策略,并带签名,任何后续改动都会破坏签名。

主要能力:三项决策——判断操作是否需要收据(有副作用、后果重大、日后可举证三者兼具才需要);构建操作清单并签名开具收据;仅凭证书离线验证。签名由开源 OpenAgentOntology 收据原语(Apache-2.0)完成,使用 Ed25519,安装后量子后端时附加 ML-DSA-65(FIPS 204)与 SLH-DSA(FIPS 205)。验证会重算哈希并检查各签名分支,返回 {ok, hash_ok, sig_ok, legs, reason},无需数据库、网络或信任签发方。

使用方式:先安装原语 pip install "openagentontology[pq]";用 python scripts/build_action_manifest.py 构建并校验操作清单(仅标准库,无加密无网络),必填 agent_id、operation、target、policy,inputs_hash 与 decision_label 自动添加;再用 mint_receipt 开具收据,用 verify_receipt 验证。

适用场景:部署、删除、付款/转账/退款、授权访问、导出/外发、批准或拒绝理赔,以及高风险 AI 系统中影响个人的模型决策。

限制:本技能不是日志分析、不是托管公证服务(跨组织验证属另一托管服务,超出范围)、不是法律意见;收据是用于支持 FRE 902(13)/(14) 式认证与 EU AI Act 第 12 条记录保存的证据形态,是否被采纳由法律顾问与法院决定。不要把签名密钥与收据放在一起,不要在清单中放入明文机密或个人信息,缺少加密时不要伪造签名。未安装 openagentontology 时构建步骤仍可用,仅开具与验证需要该包。