
AG-UI
AG-UI(代理-用户交互协议)是一个开放、轻量级、基于事件的协议,它通过实时流式传输、状态管理和人机协作交互来标准化AI代理如何连接到前端应用程序。
https://ag-ui.com/?ref=aipure&utm_source=aipure

产品信息
更新于:2025年05月20日
什么是 AG-UI
AG-UI通过在后端AI代理和前端应用程序之间提供标准化的通信层,解决了AI代理生态系统中的一个关键缺口。虽然像LangChain、LangGraph和CrewAI这样的工具擅长编排复杂的AI工作流程,但代理和用户界面之间的交互层仍然是分散的。AG-UI通过建立一个结构化的协议来解决这个问题,该协议通过JSON事件流实现无缝的实时通信,从而使开发者更容易构建交互式的AI驱动应用程序。
AG-UI 的主要功能
AG-UI 是一个开放、轻量级的、基于事件的协议,用于标准化 AI 代理和前端应用程序之间的通信。它提供实时流式传输、双向交互和工具编排功能,同时通过一系列标准化事件保持代理后端和前端界面之间的完美同步,从而可以轻松构建交互式 AI 驱动的应用程序。
实时事件流: 支持 LLM 输出的逐个令牌流式传输,并通过 16 种标准化事件类型实现即时 UI 更新,而无需阻塞完整响应
传输层灵活性: 支持多种传输机制,包括服务器发送事件 (SSE)、WebSocket 和 Webhook,使开发人员可以选择最适合其架构的方法
工具编排: 使代理能够调用函数、运行代码并与 API 交互,同时保持上下文并支持人机协作审批流程
共享可变状态: 维护前端和后端之间同步的状态,用于逐步演变的计划、表格或代码文件夹
AG-UI 的使用场景
AI 驱动的聊天界面: 构建具有实时流式响应和动态 UI 更新的交互式聊天应用程序
协作开发工具: 创建编码助手和开发工具,使 AI 代理与人类开发人员在共享上下文中协同工作
多代理系统: 开发多个 AI 代理通过统一界面协作并与用户交互的应用程序
人机协作工作流程: 构建需要人工监督和批准的系统,同时保持与 AI 代理的持续交互
优点
轻量级且易于与现有系统集成
框架无关,支持多种传输方法
标准化事件系统确保一致的通信模式
缺点
相对较新的协议,规范不断发展
与更成熟的协议相比,生态系统有限
如何使用 AG-UI
安装AG-UI: 根据您的技术栈,使用您的包管理器(npm/yarn/poetry)安装AG-UI协议和所需的依赖项
设置环境: 将您的OpenAI API密钥设置为环境变量:export OPENAI_API_KEY=your-api-key
创建一个AG-UI代理: 实现一个代理类,该类从@ag-ui/client扩展AbstractAgent并实现所需的事件发射器
定义事件处理程序: 为16个标准化的AG-UI事件设置处理程序,如RUN_STARTED、TEXT_MESSAGE_START、TEXT_MESSAGE_CONTENT等
设置HTTP端点: 创建一个HTTP端点,该端点实现AG-UI协议以使用服务器发送事件(SSE)处理代理-UI通信
连接前端UI: 使用CopilotKit React组件或构建使用AG-UI事件流的自定义UI组件
启用双向通信: 实现用户输入和反馈的处理程序,以实现人与代理之间的协作工作流程
测试集成: 运行您的服务器(例如poetry run uvicorn endpoint:app --reload)并测试代理-UI交互
添加高级功能: 根据您的用例需要,实现其他功能,如工具调用、推理步骤、多模态支持
部署和扩展: 部署您的AG-UI实现,并根据需要使用代理服务扩展以管理多个代理
AG-UI 常见问题
AG-UI 是一个开放、轻量级、基于事件的协议,它标准化了 AI 代理连接到前端应用程序的方式。它充当 AI 驱动系统的通用翻译器,以确保代理和用户界面之间的流畅通信。