
agent-inbox
把智能体待办收进一个收件箱,人工审批不再漏
agent-inbox 是一个面向 human-in-the-loop(人在回路)智能体的收件箱式交互界面。它把 AI 智能体需要人工确认、补充信息或审批的请求,统一汇聚成一个类似邮箱的消息流,让用户按条目处理,而不是在多个对话窗口间来回切换。核心能力包括:以收件箱形式集中展示待处理任务,支持对智能体请求进行查看、回复、批准或拒绝,保留处理历史与上下文,帮助开发者把人工介入环节产品化。它解决的是智能体自动化流程中“何时需要人、人如何高效响应”的问题,避免人工审核散落在日志或聊天里。项目用 TypeScript 编写,适合集成进现有前端或作为独立工具使用,定位偏开发者与产品原型场景。
项目数据
使用教程
环境要求
- 已安装 Node.js 与 yarn
- 一个已运行可用的 LangGraph 部署(本地或 LangGraph Platform 生产环境)
- 你的 LangGraph / LangSmith API key
- 可正常使用的浏览器(配置存放在浏览器 localStorage 中)
安装与启动步骤
-
1克隆仓库
把 agent-inbox 源码克隆到本地,需已安装 git 并能访问 GitHub。
git clone https://github.com/langchain-ai/agent-inbox.git -
2安装依赖
进入项目目录并用 yarn 安装全部依赖,需提前装好 Node.js 与 yarn。
cd agent-inbox yarn install -
3启动本地服务
README 未给出启动命令,请查看项目 package.json 中的 scripts 自行启动。
-
4填写 API 密钥
在侧边栏点击 Settings 按钮,填入你的 LangSmith API key,用于连接部署。
-
5添加第一个收件箱
点左下设置弹窗的 Add Inbox,填写 Graph ID、Deployment URL 和可选名称。
关键配置
| 配置项 | 必填 | 说明 | 示例 |
|---|---|---|---|
LangSmith API key | 是 | 在侧边栏 Settings 中填写,用于连接并认证 LangGraph 部署。 | your-langsmith-api-key |
Assistant/Graph ID | 是 | 你的 LangGraph 图名称或 assistant ID,发送人工响应时使用。 | agent |
Deployment URL | 是 | LangGraph 部署地址,用于拉取中断并回传人工响应。 | https://your-deployment-url |
Name | 否 | 收件箱名称,仅作为该收件箱的展示标签。 | my-inbox |
如何确认成功
打开页面后侧边栏可进入 Settings 填写密钥,成功添加 Inbox 后即可看到汇聚的待处理中断消息流。
常见问题
Q:必须自己部署吗?
A:不是,README 提供了托管版本,可直接访问 dev.agentinbox.ai 使用,无需自行部署。
Q:Open in Studio 按钮点了没反应?
A:该功能依赖 LangGraph 部署在 2025-04-18 之后生成的字段。若图中未创建新 revision,需新建 revision,并删除后重新添加收件箱。
Q:密钥和配置保存在哪里?
A:都保存在浏览器 localStorage 中,仅用于连接和认证请求到你的 LangGraph 部署。
Q:代码里该怎么触发人工介入?
A:需使用 interrupt 函数并传入 HumanInterrupt 实例,而不是抛出 NodeInterrupt 异常,其返回值即 HumanResponse。
Q:支持哪些人工操作类型?
A:accept、edit、response、ignore 四种,可在 HumanInterrupt 的 config 字段中任意组合配置。
注意事项
- 代码中必须使用 interrupt 函数,不能沿用抛出 NodeInterrupt 异常的方式。
- Agent Inbox 回复时,始终返回包含单个 HumanResponse 对象的列表。
- README 节选未提供启动命令与默认端口,请以项目 package.json 的 scripts 为准。
- 更换或新增收件箱后,若图未产生新 revision,Studio 相关功能可能不可用。
核心亮点
- 以收件箱统一管理智能体的人工介入请求,交互模式直观
- 支持查看、回复、批准/拒绝等操作,覆盖典型 human-in-the-loop 流程
- TypeScript 实现,便于前端项目集成和二次开发
不足之处
- 项目较新,生态与文档完善度有待观察
- 缺少与主流智能体框架的现成集成示例
适用场景
- 智能体自动处理任务时,把需要人工确认的步骤推送到收件箱统一审批
- 客服或运营团队集中处理 AI 生成的待回复、待审核内容
- 开发者原型验证 human-in-the-loop 交互流程
替代项目
LangGraph、CrewAI
项目介绍
上一篇:OneBox
下一篇:memory-agent
同类项目推荐
xinchao-dynamic-mind
开源
给 AI 装上疲惫和欲望,让交互更真实
独立、可自托管的 AI 动态心智状态引擎:驱动力、念头池、疲惫、睡眠与意图。
deepseek-harness
开源
把 AI 能力拆成乐高积木,拼出你的专属智能体。
DeepSeek Harness: Everything is a Plugin.
AutoGPT
开源
开箱即用的 AI 员工,交代任务就自己干完
AutoGPT is the vision of accessible AI for everyone, to use and to build on. Our mis···
agent-manager
开源
一站式管理企业 AI 代理,部署治理全搞定
WSO2 AI Agent Manager is an open control plane designed for enterprises to deploy, m···