AI 分析 · 由大模型根据 README 与仓库数据生成 · 2026年11月17日
AG-UI 是一个开放协议,用事件流把 AI Agent 连接到前端应用。
AG-UI 是一个轻量、基于事件的开放协议,用于标准化 AI Agent 与用户界面之间的双向通信。它让 Agent 能流式输出、调用工具、更新共享状态、暂停等待人工输入,并支持子 Agent,无论 Agent 由哪个框架构建。
推荐指数
适合需要将 Agent 集成到前端应用的开发者,协议稳定、生态活跃,但需理解事件流模型。
近 7 天
+2,899
新增 Star
总 Star 排名
#358
雷达追踪的 3,931 个 AI 仓库中
创建于
2025
2025年5月7日
核心亮点
1开放协议
基于事件流,标准化 Agent 与前端交互,避免为每个框架定制连接逻辑。
2框架无关
支持 LangChain、CrewAI、Mastra 等多种 Agent 框架,客户端无需改动。
31.0 稳定版
协议规范已冻结,提供 JSON Schema,TypeScript、Python、.NET SDK 自动生成。
4双向通信
支持流式消息、共享状态、人工介入、前端工具调用和子 Agent。
5快速上手
提供 CLI 脚手架和 30 行示例代码,可快速搭建 Agent 服务与客户端。
适用场景
Web 应用集成 Agent
例如:在 Next.js 前端中通过 AG-UI 连接 LangChain Agent,实现流式聊天和工具调用。
多端统一 Agent 接入
例如:同一个 Agent 同时服务 Web、移动端、终端和 Slack,客户端使用相同协议。
需要人工介入的 Agent 工作流
例如:Agent 在关键步骤暂停,等待用户确认后继续执行。
它是怎么工作的
第 1 步
Agent 端实现 HTTP 端点
接受 RunAgentInput 请求,返回事件流(如 RunStarted、TextMessageContent 等)。
第 2 步
客户端连接
使用 AG-UI 客户端 SDK(如 TypeScript 的 HttpAgent)连接 Agent 端点。
第 3 步
事件流传输
Agent 发出类型化事件,客户端按事件类型渲染或处理。
第 4 步
双向交互
客户端可发送用户消息、工具结果等,Agent 据此继续执行。
快速上手
- 1
创建新应用
使用 CLI 脚手架生成前端和 Agent 框架连接。
npx create-ag-ui-app@latest - 2
设置 API Key
模板默认调用 OpenAI,需设置环境变量。
export OPENAI_API_KEY="sk-..." - 3
运行示例
启动开发服务器,查看流式聊天效果。
npm run dev
适合谁
- 需要将 AI Agent 集成到前端应用的开发者
- 使用多种 Agent 框架、希望统一交互协议的团队
- 构建需要流式输出、人工介入等复杂交互的 Agent 产品
不太适合
- 只需要简单请求-响应式 AI 集成的项目
- 不涉及前端或用户界面的纯后端 Agent 服务
成熟度
- 活跃度最近更新于 2026 年 11 月,star 数近 2 万,社区活跃。
- 文档提供完整文档、规范、示例和迁移指南,但部分内容需跳转外部链接。
- 社区有 Discord 社区和 2021 个 fork,但 open issues 较多(591)。
- 上手难度提供 CLI 和快速示例,但需理解事件流协议和框架集成。
使用前注意
- · 协议 1.0 已稳定,但与 0.x 版本需注意兼容性(双向兼容)。
- · 使用模板时需自行准备 OpenAI API Key,可能产生费用。
- · 需要 Node.js 20+ 或 Python 3.9+ 环境。
- · MIT 许可证,可自由使用和修改。
