Kepil

Kepil 是一个面向 AI Agent 的开源责任追溯框架，定位为 AI 代理的身份证、授权书、网关和日志四合一模块。根据 Cloud Security Alliance 2026 年报告，53% 的组织曾遭遇 AI 代理超出预设权限运行，48% 的生产环境代理完全没有监控，只有 22% 的组织将代理视为独立身份实体。Kepil 正是针对剩下那 78% 的缺失而设计。技术实现上，Kepil 围绕四个核心组件构建。最底层是 Agent Passport（代理护照）：每个版本的 Agent 都有一个不可变的信息卡，记录建造者、运营方、功能范围、禁止行为、风险等级、自主等级、权限边界以及下次审查时间——每次更新版本都会生成新卡，旧卡永久保留，不可篡改。其次是 Mandate（授权书）：这是机器可读的操作委托文件，定义了该代理被授权执行的具体任务、允许访问的系统、支出限额、有效时间窗口，以及哪些操作类型必须由人工确认后才能执行——任何不在明确授权范围内的操作都会被拒绝。第三是 Gate（网关）：这是代理连接外部世界的唯一入口，每次执行动作前都会在调用模型之前先检查 Mandate 授权情况，采用失败即关闭策略——检查过程中任何错误都会导致拒绝，而不是默认通过。最后是 Journal（日志）：一个只追加的 JSONL 文件，每条记录都包含前一条记录的哈希值，一旦有人编辑或删除历史记录，任何人都可以通过独立实现验证出异常。Kepil 还提供两项延伸能力。Undo（撤销）模块基于 Journal 构建了可补偿动作图谱，每个行业或职业都可以声明其补偿动作，即撤销某操作的后果。Kepil 从日志末尾向前回溯，遇到无法撤销的步骤时诚实停止，将系统恢复到尽可能接近操作前的状态——这与普通平台只记录发生了什么完全不同，它真正把事情还原回去。Confirmation（人工确认）则面向不可逆操作：当代理尝试执行高风险动作时，确认请求会通过 Telegram 推送给你，你有两个按钮可选——批准或退回。即便是 MCP 客户端调用 Kepil，所有需要确认的动作也必须由真人通过面板或 Telegram 完成，没有任何 MCP 工具可以代替人按下确认键。快速上手只需三步：第一步安装 Kepil，pip install kepil 全局安装；第二步启动管理面板，python -m kepil.admin 在本地 7317 端口运行，首次需要设置 API Token；第三步配置代理，每个代理配置 JSON 文件声明其职业（Profession）和操作步骤（Order），Kepil 内置七个子工具处理列表查询、订单创建、步骤执行、状态读取、待确认项查询、日志验证和护照查询。如需接入 MCP 兼容编辑器或另一个代理，可直接在 MCP Server 配置中加入 kepil 模块。适用人群主要包括：在生产环境中部署 AI 代理的企业安全团队、需要为多个 AI 代理划分权限边界的技术负责人，以及关注 AI 决策可追溯性的审计合规人员。对于个人开发者而言，Kepil 提供了一个结构化的方式来管理自己搭建的多个 AI 自动化工作流，避免某个代理权限过大导致难以追踪的行为。