Kepil 是一个面向 AI 智能体的问责层，旨在为智能体提供身份、授权、执行、证据以及撤销能力。根据其官方资料，53% 的组织曾遭遇 AI 智能体超出预期权限，48% 的生产环境智能体完全没有监控，只有 22% 将智能体视为具有自身身份的实体。Kepil 正是为其余 78% 所缺失的部分而设计。
主要能力
护照（Passport）：每个智能体版本获得一张不可变的卡片，记录构建者、运行者、功能、永不执行的操作、风险等级、自主等级、限制以及风险复审时间。新版本生成新卡片，旧卡片永久保留。
授权（Mandate）：针对单个任务的机器可读授权书，包含允许的动作、允许的系统、支出限额、有效期窗口，以及哪些动作类型必须由人类确认。任何未明确允许的内容都会被拒绝。
网关（Gate）：智能体与外部世界交互的唯一入口。每个动作在调用模型之前都会根据授权进行检查。故障关闭：检查过程中任何错误都意味着拒绝，绝不通过。
日志（Journal）：仅追加的 JSONL 文件，每条记录携带前一条记录的哈希。编辑或删除记录可被检测到，任何人都可以使用独立实现进行验证。
撤销（Undo）：日志是动作的图结构，每个职业（profession）声明其补偿动作。Kepil 沿图向后遍历，并在第一个无法撤销的步骤处诚实停止。
手机确认：不可逆动作会通过 Telegram 发送，带有批准或退回两个按钮，因此问责无需坐在笔记本电脑前。
使用方式
Kepil 提供 MCP 服务器，编辑器、助手或其他智能体可以通过它工作，每个动作仍然经过同一网关进入同一日志。提供七个工具：列出职业、创建订单、运行步骤、读取订单状态、查看等待人工处理的内容、验证日志、读取智能体护照。故意缺少一个工具：确认。如果模型可以批准不可逆动作，人类就会脱离链条，整个设计就失去意义。确认卡片发送给人类（面板或 Telegram），任何 MCP 客户端都无法按下。
Kepil 还提供小型 JSON API，n8n 工作流、Make 场景或自定义脚本可以在执行前请求许可。答案记录在日志中，以便后续展示自动化执行或未执行的依据。n8n 有现成节点：n8n-nodes-kepil。API 默认关闭，直到设置令牌（面板 → 设置，或 KEPIL_API_TOKEN）。
python -m kepil.admin 打开操作员控制台：订单、职业、智能体护照、计量器（动作、令牌、成本、替代的人工时间）、合规生成器、带链验证和锚定的日志以及设置。状态是 KEPIL_DATA 下的纯 JSON 文件（默认 ./data），无数据库。
适用场景
适用于需要对 AI 智能体进行问责和审计的组织，包括入站线索、流程自动化、记账文档、AI 采用审计、公共采购包等职业场景。也适用于需要保护现有自动化（如 n8n、Make）的团队。
限制
- 智能体永远不会完全自主：AgentPassport 拒绝构建人类无法取消决策的自主等级，这是架构限制。
- 日志中最后见证头之后的记录不受保护，保证在此停止。
- 合规调查中约五分之一可自动关闭，其余需要人工回答。
- 验证器是另一种语言的独立实现。
- 项目处于 Alpha 阶段，有 170 个测试，接口可能变化。
- 不构成法律意见，依赖生成文档前应咨询律师。
- AGPL-3.0-or-later 许可，运行基于 Kepil 的网络服务需以相同条款发布源代码或获取商业许可。
- 核心零依赖，基于 Python 3.11+ 标准库，CI 在出现第三方导入时失败。
- 值从不进入日志，只有类型、计数和哈希。
