Repolode
提交项目
ag-ui-protocol

ag-ui-protocol/ag-ui

一套开放的事件驱动协议，用于标准化 AI 智能体与前端应用之间的连接方式。

在 GitHub 查看官网
Star
16,716
Fork
1,728
未关闭 Issue
495
最近提交
5小时前

这是什么？

AG-UI（Agent-User Interaction Protocol，智能体与用户交互协议）定义了一套轻量的事件格式，智能体后端在执行过程中按此格式输出事件，前端应用便能以统一的方式展示结果并做出响应。智能体只需接受少量兼容 AG-UI 的输入，协议本身不依赖特定传输方式，可以运行在 SSE、WebSocket、Webhook 等通道之上。

在智能体协议栈中，MCP 负责为智能体提供工具，A2A 负责智能体之间的通信，AG-UI 则专注于智能体与用户界面之间的连接。它支持流式实时对话、双向状态同步、生成式 UI、前端工具调用以及人在回路（human-in-the-loop）协作。项目还提供参考用的 HTTP 实现和默认连接器。

仓库列出了与 LangChain、CrewAI、Google ADK、Pydantic AI、LlamaIndex、Mastra 等多个智能体框架的集成，并提供多种语言的客户端 SDK 以及 TypeScript 核心包。通过 npx create-ag-ui-app 命令可以快速创建新应用。

核心功能

  • 01通过标准事件类型将智能体输出实时流式传输到前端
  • 02在智能体与用户界面之间双向同步状态
  • 03支持生成式 UI 和结构化消息
  • 04允许智能体调用前端工具并请求人工介入
  • 05可运行在 SSE、WebSocket 等任意传输通道上

适用场景

  • 为现有智能体后端添加支持流式输出的聊天界面
  • 让智能体读取并更新 Web 或移动端界面中展示的应用状态
  • 构建需要用户确认智能体操作的人在回路审批流程
  • 将 LangChain、CrewAI 或 Pydantic AI 构建的智能体接入统一的前端协议

快速上手

  1. 1

    使用脚手架命令创建新的 AG-UI 应用

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

使用前须知

  • 该协议仍在发展中，部分框架集成仍处于开发阶段。
  • 要充分使用通常需要自行搭建智能体后端，它并非独立即用的工具。

标签

#ai-agents#agent-protocol#streaming#frontend#generative-ui#typescript#human-in-the-loop#ag-ui-protocol#agent-frontend#agent-ui

常见问题

ag-ui 是什么？
一套开放的事件驱动协议，用于标准化 AI 智能体与前端应用之间的连接方式。 AG-UI（Agent-User Interaction Protocol，智能体与用户交互协议）定义了一套轻量的事件格式，智能体后端在执行过程中按此格式输出事件，前端应用便能以统一的方式展示结果并做出响应。智能体只需接受少量兼容 AG-UI 的输入，协议本身不依赖特定传输方式，可以运行在 SSE、WebSocket、Webhook 等通道之上。
ag-ui 可以免费使用吗？用的什么许可证？
ag-ui 以 MIT 许可证开源。用于商业产品前，请先确认许可证条款。
ag-ui 还在维护吗？
活跃维护中。ag-ui 最近一次提交是在 2026年10月20日。
ag-ui 适合用来做什么？
为现有智能体后端添加支持流式输出的聊天界面 让智能体读取并更新 Web 或移动端界面中展示的应用状态 构建需要用户确认智能体操作的人在回路审批流程 将 LangChain、CrewAI 或 Pydantic AI 构建的智能体接入统一的前端协议
ag-ui 怎么安装和运行？
使用脚手架命令创建新的 AG-UI 应用: npx create-ag-ui-app my-agent-app
在哪里获取 ag-ui？
源代码和安装说明在 GitHub 上：https://github.com/ag-ui-protocol/ag-ui

概要由 AI 根据项目 README 生成；GitHub 数据每日更新。

相关项目