AGUI.Server
AGUI.Server 是 AG-UI 的 .NET 服务端适配器。它把 Microsoft.Extensions.AI.IChatClient 流转换为 AG-UI 协议事件,因此任何聊天客户端都能作为 AG-UI 端点暴露:接受 RunAgentInput,并把 AG-UI 事件流式发给前端。
dotnet add package AGUI.Server核心理念
你不需要学习新的智能体编程模型。你托管的是一个 IChatClient。
本包把 AG-UI 请求体适配为 Microsoft.Extensions.AI 的消息与选项,调用你的聊天客户端,再把流式返回的 ChatResponseUpdate 转换回 AG-UI 协议事件。
依赖
AGUI.Server 刻意保持精简,只依赖:
- 来自
AGUI.Abstractions的 AG-UI 协议类型 Microsoft.Extensions.AI.Abstractions
它与框架无关:不依赖 ASP.NET Core 或任何 Web 框架,由你把它托管在自选的 Web 框架中(示例与文档使用 ASP.NET Core)。它也不依赖 .NET 的 AG-UI 客户端包——服务端与客户端共享协议类型,但彼此独立。
说明: 服务端包面向
net10.0、net9.0与net8.0。
托管层负责什么
- 把
RunAgentInput.Messages转换为ChatMessage - 把
RunAgentInput.Resume翻译为 MEAI 的审批与中断响应内容,载荷(以及非工具中断的 metadata)落到InterruptResponseContent - 把客户端声明的工具安装到
ChatOptions - 把原始输入存到
ChatOptions.AdditionalProperties[AGUIConstants.RunAgentInputKey] - 发出
RUN_STARTED与终态RUN_FINISHED结果 - 把文本、推理、工具调用、工具结果、状态、原始事件与中断映射为 AG-UI 事件
- 以 Server-Sent Events 流式输出结果
验证与框架归属
服务端测试验证:RunAgentInput 变为 ChatMessage 与 ChatOptions;resume 载荷变为标准 MEAI 响应内容;生命周期事件被发出;流式的 ChatResponseUpdate 变为预期的文本、推理、工具、状态、原始、自定义与中断事件。当 RUN_ERROR 等原始 AG-UI 事件由 ChatResponseUpdate.RawRepresentation 提供时会原样透传。
cd sdks/dotnet
dotnet test tests/AGUI.Server.UnitTests/
dotnet test tests/AGUI.Hosting.AspNetCore.IntegrationTests/SDK 负责 AG-UI 与 Microsoft.Extensions.AI 之间的共享桥接。框架专属的映射属于使用方框架。例如 Microsoft Agent Framework 可以使用 AGUI.Server 完成通用桥接,再用 AGUIStreamOptions 或原始 AG-UI 事件映射它自己的工作流、步骤与智能体事件。
与服务端客户端配合
构建 AG-UI 服务端时使用 AGUI.Server;.NET 代码需要把 AG-UI 端点当作 IChatClient 消费时使用 AGUI.Client。
两端的协议语义均以规范 1.0 为准:托管层产出的事件必须是规范允许的序列,客户端必须接受全部已定义事件。