MAF快速入门（16）用户智能体交互协议AG-UI（上）

雄鹰二 發表於 2026-2-13 22:27:00

MAF快速入门（16）用户智能体交互协议AG-UI（上）

大家好，我是Edison。
最近我一直在跟着圣杰的《.NET+AI智能体开发进阶》课程学习MAF开发多智能体工作流，我强烈推荐你也上车跟我一起出发！
上一篇，我们学习了MAF中快速调试的利器DevUI<span data-pm-slice="1 1 ["para",{"tagName":"p","attributes":{"style":"margin: 8px;padding: 0px;outline: 0px;max-width: 100%;color: rgb(34, 34, 34);font-size: 17px;font-style: normal;font-variant-ligatures: normal;font-variant-caps: normal;font-weight: 400;letter-spacing: 0.544px;orphans: 2;text-indent: 0px;text-transform: none;white-space: normal;widows: 2;word-spacing: 0px;-webkit-text-stroke-width: 0px;background-color: rgb(255, 255, 255);text-decoration-thickness: initial;text-decoration-style: initial;text-decoration-color: initial;font-family: -apple-system-font, BlinkMacSystemFont, \"Helvetica Neue\", \"PingFang SC\", \"Hiragino Sans GB\", \"Microsoft YaHei UI\", \"Microsoft YaHei\", Arial, sans-serif;min-height: 1em;text-align: justify;visibility: visible;box-sizing: border-box !important;overflow-wrap: break-word !important;"},"namespaceURI":"http://www.w3.org/1999/xhtml"},"node",{"tagName":"span","attributes":{"style":"font-family: system-ui, -apple-system, BlinkMacSystemFont, \"Helvetica Neue\", \"PingFang SC\", \"Hiragino Sans GB\", \"Microsoft YaHei UI\", \"Microsoft YaHei\", Arial, sans-serif;font-size: 15px;letter-spacing: 0.544px;text-align: left;caret-color: var(--weui-BRAND);"},"namespaceURI":"http://www.w3.org/1999/xhtml"}]">。本篇，我们来了解一个用户智能体交互协议：AG-UI。
<h1>1 什么是AG-UI</h1>
<span data-pm-slice="1 1 ["para",{"tagName":"p","attributes":{"style":"margin: 8px;padding: 0px;outline: 0px;max-width: 100%;color: rgb(34, 34, 34);font-size: 17px;font-style: normal;font-variant-ligatures: normal;font-variant-caps: normal;font-weight: 400;letter-spacing: 0.544px;orphans: 2;text-indent: 0px;text-transform: none;white-space: normal;widows: 2;word-spacing: 0px;-webkit-text-stroke-width: 0px;background-color: rgb(255, 255, 255);text-decoration-thickness: initial;text-decoration-style: initial;text-decoration-color: initial;font-family: -apple-system-font, BlinkMacSystemFont, \"Helvetica Neue\", \"PingFang SC\", \"Hiragino Sans GB\", \"Microsoft YaHei UI\", \"Microsoft YaHei\", Arial, sans-serif;min-height: 1em;text-align: justify;visibility: visible;box-sizing: border-box !important;overflow-wrap: break-word !important;"},"namespaceURI":"http://www.w3.org/1999/xhtml"},"node",{"tagName":"span","attributes":{"style":"font-family: system-ui, -apple-system, BlinkMacSystemFont, \"Helvetica Neue\", \"PingFang SC\", \"Hiragino Sans GB\", \"Microsoft YaHei UI\", \"Microsoft YaHei\", Arial, sans-serif;font-size: 15px;letter-spacing: 0.544px;text-align: left;caret-color: var(--weui-BRAND);"},"namespaceURI":"http://www.w3.org/1999/xhtml"}]">AG-UI 全称 Agent–User Interaction Protocol 即 智能体-用户交互协议，这是一个开放的、基于事件的协议，由 CopilotKit 团队发起，用于标准化 AI Agent 与用户界面的实时交互。
<h3><span data-pm-slice="1 1 ["para",{"tagName":"p","attributes":{"style":"margin: 8px;padding: 0px;outline: 0px;max-width: 100%;color: rgb(34, 34, 34);font-size: 17px;font-style: normal;font-variant-ligatures: normal;font-variant-caps: normal;font-weight: 400;letter-spacing: 0.544px;orphans: 2;text-indent: 0px;text-transform: none;white-space: normal;widows: 2;word-spacing: 0px;-webkit-text-stroke-width: 0px;background-color: rgb(255, 255, 255);text-decoration-thickness: initial;text-decoration-style: initial;text-decoration-color: initial;font-family: -apple-system-font, BlinkMacSystemFont, \"Helvetica Neue\", \"PingFang SC\", \"Hiragino Sans GB\", \"Microsoft YaHei UI\", \"Microsoft YaHei\", Arial, sans-serif;min-height: 1em;text-align: justify;visibility: visible;box-sizing: border-box !important;overflow-wrap: break-word !important;"},"namespaceURI":"http://www.w3.org/1999/xhtml"},"node",{"tagName":"span","attributes":{"style":"font-family: system-ui, -apple-system, BlinkMacSystemFont, \"Helvetica Neue\", \"PingFang SC\", \"Hiragino Sans GB\", \"Microsoft YaHei UI\", \"Microsoft YaHei\", Arial, sans-serif;font-size: 15px;letter-spacing: 0.544px;text-align: left;caret-color: var(--weui-BRAND);"},"namespaceURI":"http://www.w3.org/1999/xhtml"}]">为什么出现AG-UI协议？</h3>
<span data-pm-slice="1 1 ["para",{"tagName":"p","attributes":{"style":"margin: 8px;padding: 0px;outline: 0px;max-width: 100%;color: rgb(34, 34, 34);font-size: 17px;font-style: normal;font-variant-ligatures: normal;font-variant-caps: normal;font-weight: 400;letter-spacing: 0.544px;orphans: 2;text-indent: 0px;text-transform: none;white-space: normal;widows: 2;word-spacing: 0px;-webkit-text-stroke-width: 0px;background-color: rgb(255, 255, 255);text-decoration-thickness: initial;text-decoration-style: initial;text-decoration-color: initial;font-family: -apple-system-font, BlinkMacSystemFont, \"Helvetica Neue\", \"PingFang SC\", \"Hiragino Sans GB\", \"Microsoft YaHei UI\", \"Microsoft YaHei\", Arial, sans-serif;min-height: 1em;text-align: justify;visibility: visible;box-sizing: border-box !important;overflow-wrap: break-word !important;"},"namespaceURI":"http://www.w3.org/1999/xhtml"},"node",{"tagName":"span","attributes":{"style":"font-family: system-ui, -apple-system, BlinkMacSystemFont, \"Helvetica Neue\", \"PingFang SC\", \"Hiragino Sans GB\", \"Microsoft YaHei UI\", \"Microsoft YaHei\", Arial, sans-serif;font-size: 15px;letter-spacing: 0.544px;text-align: left;caret-color: var(--weui-BRAND);"},"namespaceURI":"http://www.w3.org/1999/xhtml"}]">这是因为在构建AI Agent应用的界面时，传统API模式面临很多问题和挑战：
<img src="https://img2024.cnblogs.com/blog/381412/202602/381412-20260213222047426-1470758576.png" alt="image" loading="lazy" style="display: block; margin-left: auto; margin-right: auto">
<span data-pm-slice="1 1 ["para",{"tagName":"p","attributes":{"style":"margin: 8px;padding: 0px;outline: 0px;max-width: 100%;color: rgb(34, 34, 34);font-size: 17px;font-style: normal;font-variant-ligatures: normal;font-variant-caps: normal;font-weight: 400;letter-spacing: 0.544px;orphans: 2;text-indent: 0px;text-transform: none;white-space: normal;widows: 2;word-spacing: 0px;-webkit-text-stroke-width: 0px;background-color: rgb(255, 255, 255);text-decoration-thickness: initial;text-decoration-style: initial;text-decoration-color: initial;font-family: -apple-system-font, BlinkMacSystemFont, \"Helvetica Neue\", \"PingFang SC\", \"Hiragino Sans GB\", \"Microsoft YaHei UI\", \"Microsoft YaHei\", Arial, sans-serif;min-height: 1em;text-align: justify;visibility: visible;box-sizing: border-box !important;overflow-wrap: break-word !important;"},"namespaceURI":"http://www.w3.org/1999/xhtml"},"node",{"tagName":"span","attributes":{"style":"font-family: system-ui, -apple-system, BlinkMacSystemFont, \"Helvetica Neue\", \"PingFang SC\", \"Hiragino Sans GB\", \"Microsoft YaHei UI\", \"Microsoft YaHei\", Arial, sans-serif;font-size: 15px;letter-spacing: 0.544px;text-align: left;caret-color: var(--weui-BRAND);"},"namespaceURI":"http://www.w3.org/1999/xhtml"}]">而AG-UI则是专门为AI Agent与用户界面的交互而设计的协议，其核心价值体现在：
<ul class="list-paddingleft-1">
<li>
📡 实时流式响应：即时展示 Agent 输出，无需等待
</li>
<li>
🎯 事件驱动架构：细粒度的交互事件，精确控制 UI
</li>
<li>
🔄 状态同步机制：Snapshot/Delta 模式，保持 UI 与 Agent 状态一致
</li>
<li>
🔧 工具调用可视化：透明展示 Agent 的思考和行动过程
</li>
</ul>
<h3><span data-pm-slice="1 1 ["para",{"tagName":"p","attributes":{"style":"margin: 8px;padding: 0px;outline: 0px;max-width: 100%;color: rgb(34, 34, 34);font-size: 17px;font-style: normal;font-variant-ligatures: normal;font-variant-caps: normal;font-weight: 400;letter-spacing: 0.544px;orphans: 2;text-indent: 0px;text-transform: none;white-space: normal;widows: 2;word-spacing: 0px;-webkit-text-stroke-width: 0px;background-color: rgb(255, 255, 255);text-decoration-thickness: initial;text-decoration-style: initial;text-decoration-color: initial;font-family: -apple-system-font, BlinkMacSystemFont, \"Helvetica Neue\", \"PingFang SC\", \"Hiragino Sans GB\", \"Microsoft YaHei UI\", \"Microsoft YaHei\", Arial, sans-serif;min-height: 1em;text-align: justify;visibility: visible;box-sizing: border-box !important;overflow-wrap: break-word !important;"},"namespaceURI":"http://www.w3.org/1999/xhtml"},"node",{"tagName":"span","attributes":{"style":"font-family: system-ui, -apple-system, BlinkMacSystemFont, \"Helvetica Neue\", \"PingFang SC\", \"Hiragino Sans GB\", \"Microsoft YaHei UI\", \"Microsoft YaHei\", Arial, sans-serif;font-size: 15px;letter-spacing: 0.544px;text-align: left;caret-color: var(--weui-BRAND);"},"namespaceURI":"http://www.w3.org/1999/xhtml"}]">三大Agent协议对比</h3>
<span data-pm-slice="1 1 ["para",{"tagName":"p","attributes":{"style":"margin: 8px;padding: 0px;outline: 0px;max-width: 100%;color: rgb(34, 34, 34);font-size: 17px;font-style: normal;font-variant-ligatures: normal;font-variant-caps: normal;font-weight: 400;letter-spacing: 0.544px;orphans: 2;text-indent: 0px;text-transform: none;white-space: normal;widows: 2;word-spacing: 0px;-webkit-text-stroke-width: 0px;background-color: rgb(255, 255, 255);text-decoration-thickness: initial;text-decoration-style: initial;text-decoration-color: initial;font-family: -apple-system-font, BlinkMacSystemFont, \"Helvetica Neue\", \"PingFang SC\", \"Hiragino Sans GB\", \"Microsoft YaHei UI\", \"Microsoft YaHei\", Arial, sans-serif;min-height: 1em;text-align: justify;visibility: visible;box-sizing: border-box !important;overflow-wrap: break-word !important;"},"namespaceURI":"http://www.w3.org/1999/xhtml"},"node",{"tagName":"span","attributes":{"style":"font-family: system-ui, -apple-system, BlinkMacSystemFont, \"Helvetica Neue\", \"PingFang SC\", \"Hiragino Sans GB\", \"Microsoft YaHei UI\", \"Microsoft YaHei\", Arial, sans-serif;font-size: 15px;letter-spacing: 0.544px;text-align: left;caret-color: var(--weui-BRAND);"},"namespaceURI":"http://www.w3.org/1999/xhtml"}]">我们之前已经学习了MCP 和 A2A两个重要的协议了，加上AG-UI，它们共同组成了Agent的三大通信协议体系。
<span data-pm-slice="1 1 ["para",{"tagName":"p","attributes":{"style":"margin: 8px;padding: 0px;outline: 0px;max-width: 100%;color: rgb(34, 34, 34);font-size: 17px;font-style: normal;font-variant-ligatures: normal;font-variant-caps: normal;font-weight: 400;letter-spacing: 0.544px;orphans: 2;text-indent: 0px;text-transform: none;white-space: normal;widows: 2;word-spacing: 0px;-webkit-text-stroke-width: 0px;background-color: rgb(255, 255, 255);text-decoration-thickness: initial;text-decoration-style: initial;text-decoration-color: initial;font-family: -apple-system-font, BlinkMacSystemFont, \"Helvetica Neue\", \"PingFang SC\", \"Hiragino Sans GB\", \"Microsoft YaHei UI\", \"Microsoft YaHei\", Arial, sans-serif;min-height: 1em;text-align: justify;visibility: visible;box-sizing: border-box !important;overflow-wrap: break-word !important;"},"namespaceURI":"http://www.w3.org/1999/xhtml"},"node",{"tagName":"span","attributes":{"style":"font-family: system-ui, -apple-system, BlinkMacSystemFont, \"Helvetica Neue\", \"PingFang SC\", \"Hiragino Sans GB\", \"Microsoft YaHei UI\", \"Microsoft YaHei\", Arial, sans-serif;font-size: 15px;letter-spacing: 0.544px;text-align: left;caret-color: var(--weui-BRAND);"},"namespaceURI":"http://www.w3.org/1999/xhtml"}]">不过，它们的定位各有侧重，并非非此即彼，而是协同使用，用形象的比喻来讲：
AG-UI 像是"客服窗口"：
<ul class="list-paddingleft-1">
<li>
用户与 Agent 之间的交互界面
</li>
<li>
实时展示 Agent 的工作状态
</li>
<li>
支持用户输入和反馈
</li>
</ul>
MCP 像是"工具箱"：
<ul class="list-paddingleft-1">
<li>
Agent 调用外部工具完成任务
</li>
<li>
工具是被动的，等待调用
</li>
<li>
扩展 Agent 的能力边界
</li>
</ul>
A2A 像是"同事协作"：
<ul class="list-paddingleft-1">
<li>
多个 Agent 之间的任务分发
</li>
<li>
每个 Agent 都是自主的
</li>
<li>
可以互相委托和协作
</li>
</ul>
<span data-pm-slice="1 1 ["para",{"tagName":"p","attributes":{"style":"margin: 8px;padding: 0px;outline: 0px;max-width: 100%;color: rgb(34, 34, 34);font-size: 17px;font-style: normal;font-variant-ligatures: normal;font-variant-caps: normal;font-weight: 400;letter-spacing: 0.544px;orphans: 2;text-indent: 0px;text-transform: none;white-space: normal;widows: 2;word-spacing: 0px;-webkit-text-stroke-width: 0px;background-color: rgb(255, 255, 255);text-decoration-thickness: initial;text-decoration-style: initial;text-decoration-color: initial;font-family: -apple-system-font, BlinkMacSystemFont, \"Helvetica Neue\", \"PingFang SC\", \"Hiragino Sans GB\", \"Microsoft YaHei UI\", \"Microsoft YaHei\", Arial, sans-serif;min-height: 1em;text-align: justify;visibility: visible;box-sizing: border-box !important;overflow-wrap: break-word !important;"},"namespaceURI":"http://www.w3.org/1999/xhtml"},"node",{"tagName":"span","attributes":{"style":"font-family: system-ui, -apple-system, BlinkMacSystemFont, \"Helvetica Neue\", \"PingFang SC\", \"Hiragino Sans GB\", \"Microsoft YaHei UI\", \"Microsoft YaHei\", Arial, sans-serif;font-size: 15px;letter-spacing: 0.544px;text-align: left;caret-color: var(--weui-BRAND);"},"namespaceURI":"http://www.w3.org/1999/xhtml"}]">在实际企业场景中，三大协议通常协同使用：
<ul class="list-paddingleft-1">
<li>
AG-UI：用户通过界面与主 Agent 交互
</li>
<li>
MCP：Agent 内部使用 MCP 调用工具
</li>
<li>
A2A：复杂任务委托给专家 Agent 处理
</li>
</ul>
<span data-pm-slice="1 1 ["para",{"tagName":"p","attributes":{"style":"margin: 8px;padding: 0px;outline: 0px;max-width: 100%;color: rgb(34, 34, 34);font-size: 17px;font-style: normal;font-variant-ligatures: normal;font-variant-caps: normal;font-weight: 400;letter-spacing: 0.544px;orphans: 2;text-indent: 0px;text-transform: none;white-space: normal;widows: 2;word-spacing: 0px;-webkit-text-stroke-width: 0px;background-color: rgb(255, 255, 255);text-decoration-thickness: initial;text-decoration-style: initial;text-decoration-color: initial;font-family: -apple-system-font, BlinkMacSystemFont, \"Helvetica Neue\", \"PingFang SC\", \"Hiragino Sans GB\", \"Microsoft YaHei UI\", \"Microsoft YaHei\", Arial, sans-serif;min-height: 1em;text-align: justify;visibility: visible;box-sizing: border-box !important;overflow-wrap: break-word !important;"},"namespaceURI":"http://www.w3.org/1999/xhtml"},"node",{"tagName":"span","attributes":{"style":"font-family: system-ui, -apple-system, BlinkMacSystemFont, \"Helvetica Neue\", \"PingFang SC\", \"Hiragino Sans GB\", \"Microsoft YaHei UI\", \"Microsoft YaHei\", Arial, sans-serif;font-size: 15px;letter-spacing: 0.544px;text-align: left;caret-color: var(--weui-BRAND);"},"namespaceURI":"http://www.w3.org/1999/xhtml"}]">下图展示了三大协议的详细对比：
<img src="https://img2024.cnblogs.com/blog/381412/202602/381412-20260213222138115-952680249.png" alt="image" loading="lazy" style="display: block; margin-left: auto; margin-right: auto">
<h1>2 快速开始：AG-UI对话应用<span data-pm-slice="1 1 ["para",{"tagName":"section","attributes":{"style":"letter-spacing: 0.578px;text-align: left;margin: 8px;","data-pm-slice":"6 3 []"},"namespaceURI":"http://www.w3.org/1999/xhtml"},"para",{"tagName":"p","attributes":{"style":"outline: 0px;visibility: visible;line-height: 1.75em;margin-top: 16px;margin-bottom: 16px;"},"namespaceURI":"http://www.w3.org/1999/xhtml"},"node",{"tagName":"span","attributes":{"style":"color: rgb(0, 179, 139);font-family: \"PingFang SC\", \"Lantinghei SC\", \"Microsoft Yahei\", \"Hiragino Sans GB\", \"Microsoft Sans Serif\", \"WenQuanYi Micro Hei\", Helvetica, sans-serif;"},"namespaceURI":"http://www.w3.org/1999/xhtml"},"node",{"tagName":"span","attributes":{"style":"letter-spacing: 0.544px;"},"namespaceURI":"http://www.w3.org/1999/xhtml"},"node",{"tagName":"strong","attributes":{},"namespaceURI":"http://www.w3.org/1999/xhtml"}]"> </h1>
AG-UI协议定义了清晰的架构组件，包括 Server、Client 和 Agent。
在MAF中提供了一个内置的AG-UI组件，我们可以非常方便地创建集成AG-UI的Agent应用。
接下来，我们就一步一步完成一个AG-UI对话应用涉及到的Server 和 Client。
<h3 data-pm-slice="0 0 []">AG-UI Server</h3>
首先，我们创建一个ASP.NET Web应用，安装以下NuGet包：
<div class="cnblogs_code">
<pre>Microsoft.Agents.AI.Hosting.AGUI.AspNetCore
Microsoft.Agents.AI.OpenAI
Microsoft.Extensions.AI.OpenAI</pre>
</div>
然后，就是整个示例的核心部分，我们一块一块来说：
（1）创建应用并注册AG-UI服务
<div class="cnblogs_code">
<pre>// Step0. Create WebApplication builder
var builder = WebApplication.CreateBuilder(args);
builder.Services.AddHttpClient().AddLogging();

// Step1. Register AG-UI services
builder.Services.AddAGUI();</pre>
</div>
<span data-pm-slice="1 1 ["para",{"tagName":"p","attributes":{"style":"margin: 8px;padding: 0px;outline: 0px;max-width: 100%;color: rgb(34, 34, 34);font-size: 17px;font-style: normal;font-variant-ligatures: normal;font-variant-caps: normal;font-weight: 400;letter-spacing: 0.544px;orphans: 2;text-indent: 0px;text-transform: none;white-space: normal;widows: 2;word-spacing: 0px;-webkit-text-stroke-width: 0px;background-color: rgb(255, 255, 255);text-decoration-thickness: initial;text-decoration-style: initial;text-decoration-color: initial;font-family: -apple-system-font, BlinkMacSystemFont, \"Helvetica Neue\", \"PingFang SC\", \"Hiragino Sans GB\", \"Microsoft YaHei UI\", \"Microsoft YaHei\", Arial, sans-serif;min-height: 1em;text-align: justify;visibility: visible;box-sizing: border-box !important;overflow-wrap: break-word !important;"},"namespaceURI":"http://www.w3.org/1999/xhtml"},"node",{"tagName":"span","attributes":{"style":"font-family: system-ui, -apple-system, BlinkMacSystemFont, \"Helvetica Neue\", \"PingFang SC\", \"Hiragino Sans GB\", \"Microsoft YaHei UI\", \"Microsoft YaHei\", Arial, sans-serif;font-size: 15px;letter-spacing: 0.544px;text-align: left;caret-color: var(--weui-BRAND);"},"namespaceURI":"http://www.w3.org/1999/xhtml"}]">（2）创建一个AI Agent：
<div class="cnblogs_code">
<pre>var app = builder.Build();

// Step2. Load Configuration
var config = new ConfigurationBuilder()
.AddJsonFile($"appsettings.json", optional: false, reloadOnChange: true)
.AddJsonFile($"appsettings.{Environment.GetEnvironmentVariable("ASPNETCORE_ENVIRONMENT")}.json", optional: true, reloadOnChange: true)
.Build();
var openAIProvider = config.GetSection("OpenAI").Get<OpenAIProvider>();

// Step3. Create one ChatClient
var chatClient = new OpenAIClient(
 new ApiKeyCredential(openAIProvider.ApiKey),
 new OpenAIClientOptions { Endpoint = new Uri(openAIProvider.Endpoint) })
.GetChatClient(openAIProvider.ModelId)
.AsIChatClient();

// Step4. Create one AI Agent
var agent = chatClient.AsAIAgent(
name: "AGUI-Assistant",
instructions: "你是一个友好的AI助手，请使用中文回答用户的问题。");
Console.WriteLine("✅ AI Agent 创建成功");</pre>
</div>
<span data-pm-slice="1 1 ["para",{"tagName":"p","attributes":{"style":"-webkit-tap-highlight-color: rgba(0, 0, 0, 0);margin: 8px 0px;padding: 0px;outline: 0px;max-width: 100%;clear: both;min-height: 1em;color: rgba(0, 0, 0, 0.9);font-family: \"PingFang SC\", system-ui, -apple-system, BlinkMacSystemFont, \"Helvetica Neue\", \"Hiragino Sans GB\", \"Microsoft YaHei UI\", \"Microsoft YaHei\", Arial, sans-serif;font-size: 17px;font-style: normal;font-variant-ligatures: normal;font-variant-caps: normal;font-weight: 400;letter-spacing: 0.578px;orphans: 2;text-align: left;text-indent: 0px;text-transform: none;widows: 2;word-spacing: 0px;-webkit-text-stroke-width: 0px;white-space: normal;background-color: rgb(255, 255, 255);text-decoration-thickness: initial;text-decoration-style: initial;text-decoration-color: initial;line-height: 1.75em;visibility: visible;box-sizing: border-box !important;overflow-wrap: break-word !important;"},"namespaceURI":"http://www.w3.org/1999/xhtml"},"node",{"tagName":"strong","attributes":{"style":"-webkit-tap-highlight-color: rgba(0, 0, 0, 0);padding: 0px;outline: 0px;max-width: 100%;visibility: visible;box-sizing: border-box !important;overflow-wrap: break-word !important;"},"namespaceURI":"http://www.w3.org/1999/xhtml"}]">（3）映射AGUI端点并启动应用：
<div class="cnblogs_code">
<pre>// Step5. Mapping AG-UI Endpoints
app.MapAGUI("/", agent);

Console.WriteLine("━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━");
Console.WriteLine("🚀 AG-UI Server 已启动");
Console.WriteLine("📍 端点地址: https://localhost:8443/");
Console.WriteLine("💡 使用 Ctrl+C 停止服务");
Console.WriteLine("━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━");

app.Run();</pre>
</div>
可以看到，我们仅用一行代码 app.MapAGUI() 就启用了AG-UI协议，So Easy!
启动起来的效果如下图所示：
<img src="https://img2024.cnblogs.com/blog/381412/202602/381412-20260213222325381-1327622437.png" alt="image" loading="lazy" style="display: block; margin-left: auto; margin-right: auto">
<h3>AG-UI Client</h3>
首先，我们创建一个控制台应用，安装以下NuGet包：
<div class="cnblogs_code">
<pre>Microsoft.Agents.AI.AGUI
Microsoft.Agents.AI</pre>
</div>
<span data-pm-slice="1 1 ["para",{"tagName":"p","attributes":{"style":"-webkit-tap-highlight-color: rgba(0, 0, 0, 0);margin: 8px 0px;padding: 0px;outline: 0px;max-width: 100%;clear: both;min-height: 1em;color: rgba(0, 0, 0, 0.9);font-family: \"PingFang SC\", system-ui, -apple-system, BlinkMacSystemFont, \"Helvetica Neue\", \"Hiragino Sans GB\", \"Microsoft YaHei UI\", \"Microsoft YaHei\", Arial, sans-serif;font-size: 17px;font-style: normal;font-variant-ligatures: normal;font-variant-caps: normal;font-weight: 400;letter-spacing: 0.578px;orphans: 2;text-align: left;text-indent: 0px;text-transform: none;widows: 2;word-spacing: 0px;-webkit-text-stroke-width: 0px;white-space: normal;background-color: rgb(255, 255, 255);text-decoration-thickness: initial;text-decoration-style: initial;text-decoration-color: initial;line-height: 1.75em;visibility: visible;box-sizing: border-box !important;overflow-wrap: break-word !important;"},"namespaceURI":"http://www.w3.org/1999/xhtml"},"node",{"tagName":"strong","attributes":{"style":"-webkit-tap-highlight-color: rgba(0, 0, 0, 0);padding: 0px;outline: 0px;max-width: 100%;visibility: visible;box-sizing: border-box !important;overflow-wrap: break-word !important;"},"namespaceURI":"http://www.w3.org/1999/xhtml"}]"><span data-pm-slice="1 1 ["para",{"tagName":"p","attributes":{"style":"-webkit-tap-highlight-color: rgba(0, 0, 0, 0);margin: 8px;padding: 0px;outline: 0px;max-width: 100%;box-sizing: border-box !important;overflow-wrap: break-word !important;clear: both;min-height: 1em;color: rgba(0, 0, 0, 0.9);font-family: \"PingFang SC\", system-ui, -apple-system, BlinkMacSystemFont, \"Helvetica Neue\", \"Hiragino Sans GB\", \"Microsoft YaHei UI\", \"Microsoft YaHei\", Arial, sans-serif;font-size: 17px;font-style: normal;font-variant-ligatures: normal;font-variant-caps: normal;font-weight: 400;letter-spacing: 0.578px;orphans: 2;text-align: left;text-indent: 0px;text-transform: none;widows: 2;word-spacing: 0px;-webkit-text-stroke-width: 0px;white-space: normal;background-color: rgb(255, 255, 255);text-decoration-thickness: initial;text-decoration-style: initial;text-decoration-color: initial;line-height: 1.75em;visibility: visible;","data-pm-slice":"0 0 []"},"namespaceURI":"http://www.w3.org/1999/xhtml"},"node",{"tagName":"strong","attributes":{"style":"-webkit-tap-highlight-color: rgba(0, 0, 0, 0);margin: 0px;padding: 0px;outline: 0px;max-width: 100%;box-sizing: border-box !important;overflow-wrap: break-word !important;visibility: visible;"},"namespaceURI":"http://www.w3.org/1999/xhtml"}]">然后，我们创建AG-UI Client 和 AI Agent：
<div class="cnblogs_code">
<pre>// Load Configuration
var config = new ConfigurationBuilder()
.AddJsonFile($"appsettings.json", optional: false, reloadOnChange: true)
.Build();
var openAIProvider = config.GetSection("OpenAI").Get<OpenAIProvider>();
var serverEndpoint = config.GetValue<string>("AGUI_SERVER_URL")
?? "https://localhost:8443";
Console.WriteLine("━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━");
Console.WriteLine("🚀 AG-UI 客户端已启动");
Console.WriteLine($"📍 服务端地址: {serverEndpoint}");
Console.WriteLine("━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\n");
// Step1. Create HTTP Client
using HttpClient httpClient = new()
{
Timeout = TimeSpan.FromSeconds(60)
};
// Step2. Create AG-UI Client
var chatClient = new AGUIChatClient(httpClient, serverEndpoint);
// Step3. Create AI Agent
var agent = chatClient.AsAIAgent(
name: "agui-client",
description: "AG-UI Client Agent");</pre>
</div>
<span data-pm-slice="1 1 ["para",{"tagName":"p","attributes":{"style":"-webkit-tap-highlight-color: rgba(0, 0, 0, 0);margin: 8px;padding: 0px;outline: 0px;max-width: 100%;box-sizing: border-box !important;overflow-wrap: break-word !important;clear: both;min-height: 1em;color: rgba(0, 0, 0, 0.9);font-family: \"PingFang SC\", system-ui, -apple-system, BlinkMacSystemFont, \"Helvetica Neue\", \"Hiragino Sans GB\", \"Microsoft YaHei UI\", \"Microsoft YaHei\", Arial, sans-serif;font-size: 17px;font-style: normal;font-variant-ligatures: normal;font-variant-caps: normal;font-weight: 400;letter-spacing: 0.578px;orphans: 2;text-align: left;text-indent: 0px;text-transform: none;widows: 2;word-spacing: 0px;-webkit-text-stroke-width: 0px;white-space: normal;background-color: rgb(255, 255, 255);text-decoration-thickness: initial;text-decoration-style: initial;text-decoration-color: initial;line-height: 1.75em;visibility: visible;","data-pm-slice":"0 0 []"},"namespaceURI":"http://www.w3.org/1999/xhtml"},"node",{"tagName":"strong","attributes":{"style":"-webkit-tap-highlight-color: rgba(0, 0, 0, 0);margin: 0px;padding: 0px;outline: 0px;max-width: 100%;box-sizing: border-box !important;overflow-wrap: break-word !important;visibility: visible;"},"namespaceURI":"http://www.w3.org/1999/xhtml"}]">然后，准备开始对话：
<div class="cnblogs_code">
<pre>// Step4. Prepare for Conversation
var session = await agent.GetNewSessionAsync();
var messages = new List<ChatMessage>()
{
new ChatMessage(ChatRole.System, "你是一个友好的AI助手，使用中文回答用户的问题。")
};
Console.WriteLine("💬 开始对话（输入 :q 或 quit 退出）\n");

while (true)
{
Console.Write("👤 用户: ");
string? message = Console.ReadLine();
if (string.IsNullOrWhiteSpace(message))
 continue;
if (message is ":q" or "quit")
 break;
// 添加用户消息
messages.Add(new ChatMessage(ChatRole.User, message));
// 流式接收响应
Console.Write("🤖 助手: ");
await foreach (var update in agent.RunStreamingAsync(messages, session))
{
 foreach (AIContent content in update.Contents)
 {
 switch (content)
 {
 case TextContent textContent:
 Console.Write(textContent.Text);
 break;
 case UsageContent usageContent:
 Console.WriteLine($"\n[📊 Tokens: {usageContent.Details.TotalTokenCount}]");
 break;
 default:
 Console.Write("Unknown content!");
 break;
 }
 }
}
Console.WriteLine("\n");
}
Console.WriteLine("👋 再见！");
Console.ReadKey();</pre>
</div>
<span data-pm-slice="1 1 ["para",{"tagName":"p","attributes":{"style":"-webkit-tap-highlight-color: rgba(0, 0, 0, 0);margin: 8px;padding: 0px;outline: 0px;max-width: 100%;box-sizing: border-box !important;overflow-wrap: break-word !important;clear: both;min-height: 1em;color: rgba(0, 0, 0, 0.9);font-family: \"PingFang SC\", system-ui, -apple-system, BlinkMacSystemFont, \"Helvetica Neue\", \"Hiragino Sans GB\", \"Microsoft YaHei UI\", \"Microsoft YaHei\", Arial, sans-serif;font-size: 17px;font-style: normal;font-variant-ligatures: normal;font-variant-caps: normal;font-weight: 400;letter-spacing: 0.578px;orphans: 2;text-align: left;text-indent: 0px;text-transform: none;widows: 2;word-spacing: 0px;-webkit-text-stroke-width: 0px;white-space: normal;background-color: rgb(255, 255, 255);text-decoration-thickness: initial;text-decoration-style: initial;text-decoration-color: initial;line-height: 1.75em;visibility: visible;","data-pm-slice":"0 0 []"},"namespaceURI":"http://www.w3.org/1999/xhtml"},"node",{"tagName":"strong","attributes":{"style":"-webkit-tap-highlight-color: rgba(0, 0, 0, 0);margin: 0px;padding: 0px;outline: 0px;max-width: 100%;box-sizing: border-box !important;overflow-wrap: break-word !important;visibility: visible;"},"namespaceURI":"http://www.w3.org/1999/xhtml"}]">最终的调试效果如下图所示：
<span data-pm-slice="1 1 ["para",{"tagName":"p","attributes":{"style":"-webkit-tap-highlight-color: rgba(0, 0, 0, 0);margin: 8px;padding: 0px;outline: 0px;max-width: 100%;box-sizing: border-box !important;overflow-wrap: break-word !important;clear: both;min-height: 1em;color: rgba(0, 0, 0, 0.9);font-family: \"PingFang SC\", system-ui, -apple-system, BlinkMacSystemFont, \"Helvetica Neue\", \"Hiragino Sans GB\", \"Microsoft YaHei UI\", \"Microsoft YaHei\", Arial, sans-serif;font-size: 17px;font-style: normal;font-variant-ligatures: normal;font-variant-caps: normal;font-weight: 400;letter-spacing: 0.578px;orphans: 2;text-align: left;text-indent: 0px;text-transform: none;widows: 2;word-spacing: 0px;-webkit-text-stroke-width: 0px;white-space: normal;background-color: rgb(255, 255, 255);text-decoration-thickness: initial;text-decoration-style: initial;text-decoration-color: initial;line-height: 1.75em;visibility: visible;","data-pm-slice":"0 0 []"},"namespaceURI":"http://www.w3.org/1999/xhtml"},"node",{"tagName":"strong","attributes":{"style":"-webkit-tap-highlight-color: rgba(0, 0, 0, 0);margin: 0px;padding: 0px;outline: 0px;max-width: 100%;box-sizing: border-box !important;overflow-wrap: break-word !important;visibility: visible;"},"namespaceURI":"http://www.w3.org/1999/xhtml"}]"><img src="https://img2024.cnblogs.com/blog/381412/202602/381412-20260213222507160-684244773.gif" alt="agui-gif-demo-001" loading="lazy" style="display: block; margin-left: auto; margin-right: auto">
可以看到，我们很容易就创建了一个用户友好的对话客户端，实时的流式响应也不需要我们写过多代码实现。
<h1><span data-pm-slice="1 1 ["para",{"tagName":"p","attributes":{"style":"-webkit-tap-highlight-color: rgba(0, 0, 0, 0);margin: 8px;padding: 0px;outline: 0px;max-width: 100%;box-sizing: border-box !important;overflow-wrap: break-word !important;clear: both;min-height: 1em;color: rgba(0, 0, 0, 0.9);font-family: \"PingFang SC\", system-ui, -apple-system, BlinkMacSystemFont, \"Helvetica Neue\", \"Hiragino Sans GB\", \"Microsoft YaHei UI\", \"Microsoft YaHei\", Arial, sans-serif;font-size: 17px;font-style: normal;font-variant-ligatures: normal;font-variant-caps: normal;font-weight: 400;letter-spacing: 0.578px;orphans: 2;text-align: left;text-indent: 0px;text-transform: none;widows: 2;word-spacing: 0px;-webkit-text-stroke-width: 0px;white-space: normal;background-color: rgb(255, 255, 255);text-decoration-thickness: initial;text-decoration-style: initial;text-decoration-color: initial;line-height: 1.75em;visibility: visible;","data-pm-slice":"0 0 []"},"namespaceURI":"http://www.w3.org/1999/xhtml"},"node",{"tagName":"strong","attributes":{"style":"-webkit-tap-highlight-color: rgba(0, 0, 0, 0);margin: 0px;padding: 0px;outline: 0px;max-width: 100%;box-sizing: border-box !important;overflow-wrap: break-word !important;visibility: visible;"},"namespaceURI":"http://www.w3.org/1999/xhtml"}]">3 小结</h1>
<span data-pm-slice="1 1 ["para",{"tagName":"p","attributes":{"style":"-webkit-tap-highlight-color: rgba(0, 0, 0, 0);margin: 8px;padding: 0px;outline: 0px;max-width: 100%;box-sizing: border-box !important;overflow-wrap: break-word !important;clear: both;min-height: 1em;color: rgba(0, 0, 0, 0.9);font-family: \"PingFang SC\", system-ui, -apple-system, BlinkMacSystemFont, \"Helvetica Neue\", \"Hiragino Sans GB\", \"Microsoft YaHei UI\", \"Microsoft YaHei\", Arial, sans-serif;font-size: 17px;font-style: normal;font-variant-ligatures: normal;font-variant-caps: normal;font-weight: 400;letter-spacing: 0.578px;orphans: 2;text-align: left;text-indent: 0px;text-transform: none;widows: 2;word-spacing: 0px;-webkit-text-stroke-width: 0px;white-space: normal;background-color: rgb(255, 255, 255);text-decoration-thickness: initial;text-decoration-style: initial;text-decoration-color: initial;line-height: 1.75em;visibility: visible;","data-pm-slice":"0 0 []"},"namespaceURI":"http://www.w3.org/1999/xhtml"},"node",{"tagName":"strong","attributes":{"style":"-webkit-tap-highlight-color: rgba(0, 0, 0, 0);margin: 0px;padding: 0px;outline: 0px;max-width: 100%;box-sizing: border-box !important;overflow-wrap: break-word !important;visibility: visible;"},"namespaceURI":"http://www.w3.org/1999/xhtml"}]">本文介绍了AG-UI协议的基本概念，为什么会出现AG-UI协议，AG-UI和MCP，A2A的对比，随后介绍了如何在MAF中快速开发一个基于AG-UI的对话应用。
<h1>示例源码</h1>
GitHub: https://github.com/EdisonTalk/MAFD
<h1>参考资料</h1>
圣杰，《.NET + AI 智能体开发进阶》（推荐指数：★★★★★）
Microsoft Learn，《Agent Framework Tutorials》
<div> </div>
<img src="https://images.cnblogs.com/cnblogs_com/edisonchou/1647700/o_200902144330EdisonTalk-Footer.jpg" alt="" style="width: 65%; border: 1px solid rgba(221, 221, 221, 1); border-radius: 3px; box-shadow: 0 4px 8px rgba(3, 27, 78, 0.12)">
<div id="Copyright">
作者：爱迪生
出处：https://edisontalk.cnblogs.com
本文版权归作者和博客园共有，欢迎转载，但未经作者同意必须保留此段声明，且在文章页面明显位置给出原文链接。
</div>

</div>
<div id="MySignature" role="contentinfo">
<div align="center"><img border="0" src="http://service.t.sina.com.cn/widget/qmd/2068032061/d643d182/10.png"></div> 
来源：https://www.cnblogs.com/edisontalk/p/-/quick-start-on-maf-chatper16

頁: [1]

琼殿技术论坛's Archiver

MAF快速入门（16）用户智能体交互协议AG-UI（上）