Impri 是一个面向 AI 智能体的人类审批收件箱(human-in-the-loop approval inbox)。其核心思路是:当智能体准备执行具有副作用的操作(如发送邮件、发布回复、运行数据库迁移或写入)时,先把拟执行的动作推送到收件箱,并轮询等待决定;只有 API 实际返回 status: "approved" 后,执行分支才可达。这样把“先问用户”从系统提示词中的一条指令,转变为一种数据依赖——审批门位于模型之外,而不是模型提示词之内。
主要能力
- 审批收件箱:智能体提交拟执行动作,人类批准、拒绝或编辑后,动作才会运行。
- 多通道通知:动作可通知 Slack、Discord、Telegram、ntfy、邮件或通用 webhook,审批人无需一直盯着仪表盘。
- 审批前编辑:审批人可在批准前修改草稿,智能体会收到编辑后的文本。
- 接口支持:提供 MCP 与 REST 两种接入方式。
- 自托管:完整核心可自托管,MIT 许可,无需许可证密钥。
- 框架集成:integrations/ 目录提供 Claude Agent SDK、CrewAI、LangChain、OpenAI Agents SDK 的包;文档中提供 n8n、Make、Zapier 的基于 webhook 的模式。
- 审计日志:提供事件类型、查询 API、导出与保留策略。
- Watcher 预设:提供 18 个模板,支持 REST、SDK 与 MCP 用法。
使用方式
- 若客户端支持远程 MCP 服务器,可直接连接托管端点,无需安装。
- 若指向自托管服务器,则需运行本地包。
- Cursor:在 .cursor/mcp.json 中添加配置块。
- Windsurf:在 mcp_config.json 中添加相同配置块。
- 获取 im_... 密钥:通过一次 curl 调用即可,无需注册表单。
- IMPRI_BASE_URL 若省略则默认 http://localhost:8484(自托管);托管云需设置为 https://api.impri.dev。
- 自托管:服务器运行在 http://localhost:8484,Web 收件箱运行在 http://localhost:8080;首次启动时引导管理员密钥会打印到日志中。
- 智能体侧可通过 MCP 或 REST 完成提交动作、轮询决定等调用。
适用场景
- 智能体具备发送邮件、发布回复、执行数据库写入等副作用能力,需要在执行前由人类确认。
- 团队希望通过 Slack、Discord、Telegram 等常用渠道快速审批,而不必登录专门仪表盘。
- 需要审批前修改智能体草稿内容的流程。
- 希望自托管、掌控数据与审批链路的场景。
限制与注意事项
- 官方明确说明:只有当“已批准路径”是智能体到达该副作用的唯一路径时,这扇门才真正有效;如果同时把原始凭据交给智能体,它可能绕过审批。
- 版本状态:v0.1,预发布。MCP 已发布;CLI 与两个 SDK 目前仅支持本地安装(尚未发布到 npm / PyPI)。
- 托管云处于早期 beta。
- 收费:免费版(3 个 watcher,100 次审批/月);Indie $9/月(20 个 watcher,2,000 次审批/月,5 分钟检查);Team $29/月(不限 watcher 与审批,1 分钟检查)。自托管完整核心免费,托管云之外的层级限制不适用。
- 许可:MIT,详见 LICENSE;托管云与付费层级为商业产品,详见 MONETIZATION.md。
- 作者:Radim Sekera。相关项目:briefgate.dev(面向 AI 编码智能体的客户接入)。