ag-ui-protocol GitHub avatar

ag-ui

TypeScript
智能体交互协议ag-ui-protocol最近推送 2026年11月18日
AI 开发工具MIT20.0k2,067588 issues7 天 +2,899

AI 分析 · 由大模型根据 README 与仓库数据生成 · 2026年11月17日

AG-UI 是一个开放协议,用事件流把 AI Agent 连接到前端应用。

AG-UI 是一个轻量、基于事件的开放协议,用于标准化 AI Agent 与用户界面之间的双向通信。它让 Agent 能流式输出、调用工具、更新共享状态、暂停等待人工输入,并支持子 Agent,无论 Agent 由哪个框架构建。

推荐指数

4.0

适合需要将 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. 第 1 步

    Agent 端实现 HTTP 端点

    接受 RunAgentInput 请求,返回事件流(如 RunStarted、TextMessageContent 等)。

  2. 第 2 步

    客户端连接

    使用 AG-UI 客户端 SDK(如 TypeScript 的 HttpAgent)连接 Agent 端点。

  3. 第 3 步

    事件流传输

    Agent 发出类型化事件,客户端按事件类型渲染或处理。

  4. 第 4 步

    双向交互

    客户端可发送用户消息、工具结果等,Agent 据此继续执行。

快速上手

  1. 1

    创建新应用

    使用 CLI 脚手架生成前端和 Agent 框架连接。

    npx create-ag-ui-app@latest
  2. 2

    设置 API Key

    模板默认调用 OpenAI,需设置环境变量。

    export OPENAI_API_KEY="sk-..."
  3. 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 许可证,可自由使用和修改。

主题标签

ag-ui-protocolagent-frontendagent-uiagentic-workflowai-agents