ag-ui

让智能体轻松接入前端，统一交互协议，快速构建 AI 应用界面。

AG-UI 是一个定义智能体与用户界面之间交互协议的开源项目，旨在将 AI 智能体无缝集成到前端应用中。它解决的是当前智能体应用缺乏标准化交互接口的问题，提供了一套统一的协议规范，让开发者能够轻松构建支持智能体驱动的前端界面。其核心能力包括：定义智能体与前端之间的消息格式、事件流和状态同步机制，支持流式输出、用户确认、工具调用等交互模式，并提供多种语言的 SDK 和参考实现。通过 AG-UI，开发者可以快速搭建具有自然语言交互能力的 Web 应用，而无需从零设计底层通信协议。该项目由知名 AI 公司推动，社区活跃，已被多个项目采用，是构建下一代智能体应用的重要基础设施。

开源 free 智能体

访问官网 ↗ GitHub ↗ 文档 ↗

GitHub 星标 ★ 15991

维护状态活跃

是否开源是

定价模式 free

项目数据

分类智能体

开发团队ag-ui-protocol

所属国家

官网地址https://ag-ui.com

GitHubhttps://github.com/ag-ui-protocol/ag-ui

定价模式free

价格说明开源协议，免费使用，无付费版本。

访问状态

是否开源是

开源协议MIT

主要语言TypeScript

技术栈/模型ag-ui-protocol,agent-frontend,agent-ui,agentic-workflow,ai-agents

GitHub 星标★ 15991

30天Star增速

HF 下载量

上线时间2025-05-07 00:00:00

最近更新2026-09-22 00:00:00

维护状态活跃

中文支持

访问方式

移动端支持

综合评分

收录时间2026-08-09

浏览次数4

使用教程

难度：入门约 10 分钟部署方式：命令行工具 5 步

环境要求

已安装 Node.js（npx 随 npm 一起提供，README 未指定具体版本）
终端可访问外网，npx 需要联网拉取 create-ag-ui-app
具备在目标目录创建文件的读写权限

安装与启动步骤

1准备 Node.js 环境

AG-UI 脚手架通过 npx 运行，需先在本机装好 Node.js（自带 npm 与 npx）；README 未给出最低版本要求。
2生成 AG-UI 应用

在终端执行官方脚手架命令，按提示生成一个名为 my-agent-app 的 AG-UI 项目。
```
npx create-ag-ui-app my-agent-app
```
3进入项目目录

脚手架执行完成后，进入它生成的项目目录，后续启动与开发都在该目录内进行。
```
cd my-agent-app
```
4启动本地开发服务

脚手架项目自带启动脚本，具体命令与访问端口以项目内 README 和控制台输出为准，README 主文档未列出。
5按官方文档继续开发

参照 Quickstart 文档构建应用或把已有智能体框架接入 AG-UI 协议。

如何确认成功

脚手架命令无报错并生成 my-agent-app 目录；开发服务启动后按终端打印的本地地址即可打开页面。

常见问题

Q：需要哪个版本的 Node.js？

A：README 未注明版本要求，建议安装较新的 Node.js LTS 版本，并确认 npm 与 npx 命令可用。

Q：提示找不到 npx 或命令无法执行怎么办？

A：说明 Node.js 未正确安装或未加入环境变量，重新安装 Node.js LTS 后再执行 npx create-ag-ui-app my-agent-app。

Q：想了解智能体与前端如何对接？

A：查看官方 Quickstart 文档 https://docs.ag-ui.com/quickstart/applications，或在 https://dojo.ag-ui.com/ 在线体验。

Q：AG-UI 支持哪些部署平台？

A：README 的部署表格显示 Amazon Bedrock AgentCore 已支持，并提供了对应的官方文档链接。

注意事项

README 主文档只给出脚手架命令，安装与构建细节请以官网 https://ag-ui.com 和 Quickstart 文档为准。
遇到问题可加入官方 Discord 社区：https://discord.gg/Jd3FzfdJa8。
项目还提供在线演示 AG-UI Dojo：https://dojo.ag-ui.com/。

核心亮点

定义了标准化的智能体-前端交互协议，降低集成成本
支持流式输出、用户确认等丰富交互模式，体验好
提供多语言 SDK，上手快，社区活跃

不足之处

协议仍在演进，可能面临版本兼容问题
文档/社区待观察

适用场景

构建聊天机器人前端界面
开发需要用户确认的自动化工作流应用
将 AI 能力嵌入现有 Web 产品

替代项目

LangChain、OpenAI Assistants API、Copilot Kit

项目介绍

ag-ui 是智能体领域的开源项目，由 ag-ui-protocol 开发，2025 年首次发布。

在全站 13,090 个收录项目中，它的 GitHub 星标数（15,991）位列前 3%，在智能体分类的 2,517 个项目里位列前 4%。

近 41 天，它的 GitHub 星标从 15,270 增加到 15,991，净增 721。

项目目前处于活跃维护状态，最近一次代码更新于 2026-09-22。开源协议，免费使用，无付费版本。从国内网络环境看，可直接访问。

它主要面向的使用场景是：构建聊天机器人前端界面。同类可对比的替代方案包括 LangChain、OpenAI Assistants API、Copilot Kit。

上一篇：riseofmachine

下一篇：awesome-harness-engineering