ag-ui-protocol/ag-ui

项目介绍

AG-UI 是一套开放、轻量、基于事件的协议，用来标准化 AI Agent 与面向用户的应用之间的连接。Agent 后端发出符合约 16 种标准事件类型的事件，并接收少量 AG-UI 兼容输入；中间件层负责适配 SSE、WebSockets、webhooks 等传输方式，并允许较宽松的事件格式匹配。仓库还提供参考 HTTP 实现和默认连接器。

它面向在应用内构建 Agent 交互的团队，覆盖流式对话、双向状态同步、生成式 UI 与结构化消息、实时上下文补充、前端工具调用和人在回路审批。在 Agent 协议栈中，项目把 MCP 定位为给 Agent 提供工具、A2A 负责 Agent 之间通信，而 AG-UI 负责把 Agent 带到用户面前。

快速使用

准备可用的 Node.js 环境和 npx。在任意目录执行：

npx create-ag-ui-app my-agent-app

这会生成名为 my-agent-app 的起步应用；README 没有说明生成后的目录结构和启动命令，下一步请查看脚手架输出或应用快速上手。如果只想先看效果、不写代码，可以打开 AG-UI Dojo，其中每个核心构件都有约 50–200 行的示例，并托管了各个框架集成的演示。

集成与 SDK

一方支持包括内置 Agent、LangChain/LangGraph、CrewAI、Microsoft Agent Framework、Google ADK、Google Antigravity、AWS Strands Agents、Mastra、Pydantic AI、Agno、LlamaIndex 和 AG2；AWS Bedrock Agents 与 OpenAI Agents SDK 仍在进行中。社区集成包括 Claude Agent SDK、Claude Managed Agents、Langroid、Omnara 和 Cloudflare Agents。SDK 覆盖 Kotlin、Go、Dart、Java、Rust、Ruby、C++、.NET 和 Nim，Flowise 与 Langflow 尚在开发。客户端侧支持 CopilotKit、终端/Agent 客户端、通过 Channels SDK 接入的 Slack 与 Teams、React Native 和 OpenBot。

使用约束

协议以 MIT 许可证发布，且与传输方式无关，不强制某一类事件传输或框架。可用性取决于是否使用所选后端的 AG-UI 连接器或适配器；部分集成标注为进行中，暂不可用。仓库的快速开始止于项目脚手架，要跑起完整应用还需查阅链接文档。人在回路和前端工具功能要求前端处理对应事件。

HotRepo 点评

AG-UI 在 HotRepo 的 GitHub 全部语言日榜上最高排到第 8 名，记录日期为 2026-11-14，当时有 17,183 星，当日新增 9 星。2025-05-13 的 Show HN 讨论获得 36 分和 5 条评论，讨论同时体现了吸引力与困惑：评论者 dhorthy 把它理解为可跨客户端展示 Agent 状态的方式——工作中、思考中、调用工具、出错、需要输入或审批；评论者 aatd86 则追问它究竟用来做什么，是辅助功能还是新的 UI 范式。这个落差说明协议的价值需要具体的前端用例来体现，Dojo 示例比规范本身更能说明这一点。