AG-UI：Agent 与用户的交互协议标准

CopilotKit 现已支持 Angular

Angular 支持 · 在 Angular 中构建 Agent 应用和生成式 UI · 现已上线

我们很高兴宣布 AG-UI，即 Agent-User Interaction Protocol（Agent-用户交互协议），这是一个精简的桥接，连接 AI Agent 和现实应用。

AG-UI 是一个开源、轻量级协议，通过标准 HTTP 或可选的二进制通道流式传输单一 JSON 事件序列。这些事件——消息、工具调用、状态补丁、生命周期信号——在 Agent 后端和前端界面之间无缝流动，保持完美的实时同步。

使用我们的 TypeScript 或 Python SDK，只需几分钟就能开始使用，支持任何 Agent 后端（OpenAI、Ollama、LangGraph 或自定义代码）。访问 docs.ag-ui.com 了解规范、快速入门指南和交互式游乐场。

Agent-用户交互

当今的 AI Agent 生态正在成熟。Agent 从有趣的病毒式演示逐渐成长为实际生产应用，许多全球最大的企业也开始使用。

然而，该生态主要关注后端自动化，即独立运行且用户交互有限的流程。启动或自动发生的工作流，其输出随后被使用。

常见用例包括数据迁移、研究和总结、表单填充等。

可重复且简单的工作流，其中可以确保准确性，或 80% 的准确度足够好。

这些已经带来了巨大的生产力提升，自动化了耗时且乏味的任务。

Agent 与用户的交汇点

编码工具（Devin vs. Cursor）

在生成式 AI 的采用过程中，编码工具一直是矿井中的金丝雀，而 Cursor 是用户交互式 Agent 的最佳示例。一个在共享工作区中与用户并肩工作的 AI Agent。

这与 Devin 不同，Devin 承诺了一个完全自主的 Agent，可以自动化高层次的工作。

对于许多最重要的用例，Agent 如果能与用户并肩工作会更有帮助。这意味着用户可以看到 Agent 在做什么，可以在相同的输出上共同工作，在共享工作区中轻松迭代。

构建用户交互式 Agent 的挑战

创建这些协作体验提出了重大的技术挑战：

实时流式传输：LLM 逐步生成 token；UI 需要实时获取它们，而不是阻塞等待完整响应。

工具编排：现代 Agent 调用函数、运行代码、访问 API。UI 必须显示进度和结果，有时需要寻求人工批准，然后恢复运行——所有这些都不能丢失上下文。

共享可变状态：Agent 常常生成计划、表格或代码文件夹，一步步演进。每次都发送整个数据块会浪费带宽；发送差异需要清晰的架构。

并发和取消：用户可能会同时发出多个查询、中途停止一个、或切换线程。后端和前端需要线程 ID、运行 ID 和有序的关闭路径。

安全边界：在 WebSocket 上流式传输任意数据很容易，直到需要处理 CORS、身份验证令牌和企业会同意的审计日志。

框架众多：LangChain、CrewAI、Mastra、AG2、自定义脚本——都说着略有不同的方言。没有标准，每个 UI 都必须重新发明适配器和边界情况处理。

引入 AG-UI

你的客户端向 Agent 端点发送单一 POST 请求，然后监听统一的事件流。每个事件都有一个 type（例如 TEXT_MESSAGE_CONTENT、TOOL_CALL_START、STATE_DELTA）和最少的负载。Agent 在事件发生时发出它们，UI 相应地做出反应——显示部分文本、在工具完成时渲染可视化，或在状态变化时更新界面。

AG-UI 建立在标准 HTTP 之上，可平稳集成到现有基础设施，同时为性能关键应用提供可选的二进制序列化器。

AG-UI 在 Agent 和界面之间建立了一致的契约，消除了自定义 WebSocket 格式和文本解析黑客的需要。通过这个统一协议：

组件变得可互换：将 CopilotKit 的 React 组件与任何 AG-UI 源一起使用

后端灵活性：在云和本地模型之间切换而无需更改 UI

多 Agent 协调：通过单一界面编排专门的 Agent

增强的开发：以零供应商锁定构建更快、拥有更丰富的体验

AG-UI 不仅仅是一个技术规范——它是下一代 AI 增强应用的基础，这些应用支持人类和 Agent 之间的无缝协作。

→ 预订电话并与我们的团队联系

请在会议描述中包含你是谁、你在构建什么以及你的公司规模，我们今天就会帮助你开始！

我们很乐意获得你的反馈。请加入我们的 AG-UI Discord 社区并加入对话。

从 docs.ag-ui.com 开始构建

订阅我们的博客，在你的收件箱中获取关于 CopilotKit 的更新。