AG-UI
以事件协议将 AI 智能体接入面向用户的应用界面。
- Star 数
- ★ 17k
- 最近更新
- 1 天前
- License
- MIT
- 主语言
- TypeScript
- FA 评分
- 34/100 · 缺口较多
30 秒速览
- 运行形态
- 可在哪里用
- 通用 · 跨平台Claude API（部分支持）
- 费用
- 免费，无需付费服务
- 上手难度
- 低 · 几分钟可跑通
- 开始前需要
- 典型场景
- 正在构建实时聊天界面的团队，需要让智能体后端把流式执行事件传递到面向用户的应用。
- 不适合
- 需要开箱即用、能独立完成业务任务的智能体产品的团队
- 没有自建智能体后端或前端应用、只想直接使用的用户
- 需要完整事件名、端点与鉴权文档才能落地的团队
这个 Agent 能做什么，适合哪些场景？
AG-UI 是一个开放、轻量、事件驱动的智能体—用户交互协议，而不是开箱即用的智能体产品。智能体后端在执行期间发出与约 16 种标准事件类型兼容的事件，并接收少量兼容输入。其灵活中间件层支持 SSE、WebSocket、Webhook 等任意事件传输，并允许较宽松的事件格式匹配。项目提供参考 HTTP 实现和默认连接器，帮助将后端事件接入用户界面。仓库还列出了多种框架、社区 SDK 和客户端集成；但所给材料未说明生成应用后的运行、部署、认证或凭据配置步骤。
在一次智能体执行中，接入 AG-UI 的后端输出与约 16 类标准事件兼容的事件流，并接收 AG-UI 兼容输入作为参数。中间件将这些交互适配到 SSE、WebSocket、Webhook 或其他事件传输，使用户界面能够处理实时流式交互、双向状态同步、结构化消息或生成式 UI 等已列出的能力。项目还提供参考 HTTP 实现和默认连接器；npx create-ag-ui-app my-agent-app 是材料中唯一明确给出的创建应用命令。所给材料未给出具体事件名称、HTTP 端点、请求体、环境变量或生产部署配置。
- 正在构建实时聊天界面的团队，需要让智能体后端把流式执行事件传递到面向用户的应用。
- 需要让前端与智能体执行过程双向同步状态的产品工程师。
- 使用 LangGraph 或 CrewAI 的团队，希望接入 README 标示为已支持的 AG-UI 路径。
- 希望在应用界面中结合结构化消息、生成式 UI 或前端工具交互的前端开发者。
- 需要以 HTTP、SSE、WebSocket 或 Webhook 等不同传输方式对接同一交互协议的集成团队。
如何安装或部署这个 Agent？
材料中明确提供的初始化命令为：npx create-ag-ui-app my-agent-app。该命令用于创建新的 AG-UI 应用。材料未说明所需 Node.js 版本、安装后的启动命令、依赖安装流程、认证凭据、环境变量或部署配置，因此无法据此给出可验证的完整安装与部署步骤。
如何使用这个 Agent？
运行 npx create-ag-ui-app my-agent-app 创建应用后，将智能体后端配置为在执行中发出 AG-UI 兼容事件，并接收 AG-UI 兼容输入；可通过参考 HTTP 实现或默认连接器接入。传输可选 SSE、WebSocket、Webhook 等。材料未提供事件定义、连接器调用示例或创建后应用的启动命令，首个可运行调用无法仅凭所给内容验证。
这个 Agent 有哪些优点和局限？
- 以事件为核心，明确面向智能体后端与用户界面之间的交互，而非仅覆盖模型调用。
- README 明确表示可使用 SSE、WebSocket、Webhook 等任意事件传输，适合已有传输层不同的应用。
- 提供参考 HTTP 实现和默认连接器，降低首次接入协议的起步成本。
- 已列出 LangGraph、CrewAI、Google ADK、Microsoft Agent Framework 等支持或集成路径。
- 它是协议和集成层，不是可直接完成业务任务的智能体；采用方仍需提供智能体后端和前端应用。
- 所给材料没有给出具体事件名称、端点、认证机制或错误处理语义，实施前仍需查阅规范。
- README 中部分集成仍标为“开发中”或“需要帮助”，包括 OpenAI Agent SDK、Cloudflare Agents、.NET、Nim、Flowise、Langflow 和 React Native。
- 初始化命令之外，材料未说明运行时版本、生产部署流程或凭据要求。
这个 Agent 与同类方案有什么区别？
AG-UI 被定位为与 MCP 和 A2A 互补：MCP 为智能体提供工具，A2A 用于智能体之间通信，AG-UI 则把智能体带入面向用户的应用。
与相关度最高的同类 agent 并排比较关键指标。
| Agent | 源码审查 | 形态 / 费用 | Star | 最近更新 | 主语言 | 完整支持的平台 |
|---|---|---|---|---|---|---|
| AG-UI 当前 | 34 · 缺口较多 | 命令行工具免费 | ★ 17k | 1 天前 | TypeScript | — |
| TrueForge | 67 · 存在缺口 | 命令行工具免费 + 模型费 | ★ 6.4k | 1 天前 | TypeScript | OpenAI API · Claude API |
| Tambo AI 生成式 UI 工具包 | 42 · 缺口较多 | 代码库 / SDK免费版 + 付费版 | ★ 11k | 29 天前 | TypeScript | OpenAI API · Claude API |
| Mirafold | 89 · 表现良好 | 命令行工具免费版 + 付费版 | ★ 19 | 1 个月前 | TypeScript | Codex · Claude Code |
FollowAgents 如何评估这个 Agent？
查看各维度的扣分理由
证据显示仓库未提供权限管理、用户确认、数据流透明性、敏感数据处理、依赖安全、外部影响、回滚或来源归属的具体实现或文档。所有相关标准均得0分，因为缺乏证据。
自一致性得2分：README、package.json和测试文件在协议描述和集成列表上基本一致。依赖可用性得1分：package.json列出了依赖和覆盖，但未提供可用性保证或锁定文件细节。失败消息得1分：测试中有重试逻辑，但未提供面向用户的错误消息文档。
受众和场景得2分：README明确列出了目标受众（开发者）和多种使用场景（聊天、状态同步、生成式UI等）。能力边界得1分：描述了协议范围，但未明确限制。触发精度得1分：事件类型有描述，但未详细说明触发条件。环境适配得2分：支持多种框架和传输方式，但未提供详细配置指南。
信息架构得2分：README结构清晰，有目录和链接。安装说明得2分：提供了npx create-ag-ui-app命令。命名稳定性得1分：版本为0.0.1，未承诺稳定性。示例和FAQ得2分：提供了示例和Dojo链接。已知限制得1分：未明确列出限制。许可证得2分：MIT许可证文件存在。版本和变更日志得1分：无CHANGELOG。维护责任得1分：作者信息存在，但未明确维护政策。
输出可用性得2分：协议定义清晰，有参考实现。边际价值得2分：填补了Agent-UI交互协议空白。成本效益得1分：未提供性能或成本数据。
声明可追溯性得1分：README中的声明未链接到具体代码或测试。跨来源佐证得1分：有多个集成列表，但未独立验证。事实与推断分离得1分：部分内容为推断，未明确区分。
- 源码中未见：最小权限约束只授予完成任务所需的权限：用专用账号或只读令牌，并限定可访问的目录和仓库。
- 源码中未见：执行前用户确认开启或自行加上执行前确认；先在沙箱或测试环境跑通，确认行为后再接入真实数据。
- 源码中未见：数据流向说明运行时观察它连接了哪些外部服务（代理或防火墙日志）；弄清数据去向之前不要输入敏感数据。
- 源码中未见：敏感信息处理使用专用、低权限、可随时吊销的 API 密钥，不要复用生产凭据，也不要让密钥出现在日志里。
- 源码中未见：依赖安全审查安装前固定版本并做一次依赖扫描（如 npm audit、pip-audit）；优先放在容器里运行。
- 源码中未见：外部影响披露先弄清它会写入、发送或修改哪些外部系统，用测试账号或测试仓库验证后再接入正式环境。
- 源码中未见：回滚或恢复路径运行前先备份，或在 git 分支、快照上操作，确保改动可以撤销。
- 源码中未见：来源归属可核验从官方仓库或包源安装，核对发布者和仓库地址，避免同名仿冒包。
- 仓库未提供安全相关文档或实现，如权限管理、数据加密、用户确认等，使用前需自行评估。
- 版本号为0.0.1，且无变更日志，API可能不稳定。
- 依赖安全未审计，存在覆盖但未说明原因。
最近版本
来自该项目 GitHub Releases 的最新发布记录，说明为上游原文摘录，未经本站改写或测试。
-
release/2026-11-06 Release 2026-11-06
发布说明摘录
Packages Published Python (PyPI) - published at 12:19:18 UTC | Package | Version | Install | |---------|---------|--------| | ag-ui-openai-agents | 0.1.0 | pip install ag-ui-openai-agents==0.1.0 | [email protected] _No release notes were approved for this version — the changelog entry is missing._ <!-- ag-ui-published: [email protected] -->在 GitHub 查看 ↗ -
release/2026-11-05 Release 2026-11-05
发布说明摘录
Packages Published Maven Central - published at 08:13:26 UTC | Package | Version | Install | |---------|---------|--------| | kotlin-core | 0.5.0 | com.ag-ui.community:kotlin-core:0.5.0 | | kotlin-client | 0.5.0 | com.ag-ui.community:kotlin-client:0.5.0 | | kotlin-tools | 0.5.0 | com.ag-ui.community:kotlin-tools:0.5.0 | [email protected] - Aligned the SDK with AG-UI 1.0, including strict event/input decoding and state patch structural checks. - Added REASONING_* events; THINKING_* events and ThinkingTelemetryState are deprecated with ReplaceWith hints. …在 GitHub 查看 ↗ -
release/2026-11-03 Release 2026-11-03
发布说明摘录
Packages Published Python (PyPI) - published at 01:10:30 UTC | Package | Version | Install | |---------|---------|--------| | ag_ui_adk | 0.12.0 | pip install ag_ui_adk==0.12.0 | [email protected] - Added opt-in A2UI Express inference path alongside Direct JSON, selectable per run for injected and explicitly owned render tools. - Express output is compiled incrementally by a2ui-agent-sdk 0.10.0 into validated A2UI activity updates on a stable surface/activity identity. …在 GitHub 查看 ↗