项目预览
项目数据
项目介绍
Star 增长趋势
本站每日记录该项目 GitHub 星标变化,观测越久曲线越完整
数据来源:GitHub API 逐日快照 · 收录于 2026-09-12 · 当前星标 ★ 1097
使用教程
ℹ 本教程由 AI 依据该项目 README 整理,个别步骤可能需要按你的环境微调。
环境要求
- 已安装 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
同类项目推荐
airunner
开源
本地离线跑 AI,画画聊天全搞定
Offline inference engine for art, real-time voice conversations, LLM powered chatbot···
Autonomous-Agents
开源
每日更新,一站式追踪自主智能体前沿论文
Autonomous Agents (LLMs) research papers. Updated Daily.
NanoResearch
开源
丢个问题进去,自动产出带引用的研究报告
+ NanoResearch: The Autonomous AI Research Assistant
locally-uncensored
开源
一键安装,本地离线运行无审查 AI,聊天、生图、视频全搞定。
The all-in-one local AI studio for your desktop: chat, image and video generation an···
busabase
开源
给 AI 智能体一个可自托管、带人工审核的数据库工作台
Open-source database & workspace for AI agents — structured data, durable knowledge···
skills
开源
给 AI 装上社媒运营大脑,一句话跑通内容全流程
106 social media skills for AI agents - strategy, writing, video, design, platform g···
ComfyUI-Assistant-GPTs
开源
用大白话对话,自动生成和优化 ComfyUI 工作流
GPTs for ComfyUI | Explanation Creation Resolution | ComfyUI 助手
ai-agents-from-zero
开源
从零到企业级Agent开发,一站式学习+面试通关
2026 最系统的 AI Agent 速成指南|智能体实战教程 · 完整学习路径 + 实战项目 + 面试题···
NagaAgent
开源
用 MCP 和工具调用,快速搭一个能干活的私人 AI 助手
A simple yet powerful agent framework for personal assistants, designed to enable in···
