JaydenAI的博客

Headless工具允许Agent调用那些实际执行必须在用户应用而非服务器端进行的工具。Agent仍然可以看到标准的工具架构，但实际实现位于前端，因此它可以访问浏览器 API，例如IndexedDB、地理位置、剪贴板、画布或文件选择器。当数据需要保留在设备本地时，这种模式尤其有用。本页的示例使用了一个基于IndexedDB的小型浏览器内存工具包，以及一个完全在客户端运行的地理位置工具。Headless（无头）这个词是计算机科学领域的一个经典行业术语，其核心含义是剥离了前端展示层或用户界面的系统。这里的。

”AG-UI详解-06：AG-UI针对MAF的服务端实现“解决了MAF与AG-UI服务端的适配问题，我们只需要在一个ASP.NET Core应用中将指定的`AIAgent`作为参数调用`MapAGUIServer`扩展方法注册一个对应的路由中间点就能提供一个遵循AG-UI协议的Agent服务。本篇文章介绍客户端的实现，核心功能由官方提供的NuGet包`AGUI.Client`提供。

在"G-UI详解-04：如何构建一个兼容AG-UI协议的Agent"，我通过在ASP.NET Core应用中注册了一个绑定到IChatClient的路由中间件，构建了一个兼容AG-UI协议的Agent后端。虽然AG-UI协议定义的很多功能未曾实现，但是它与MAF与AG-UI集成的实现原理本质上是一致的。现在我们来看看微软官方是如何将一个MAF AIAgent暴露成一个兼容AG-UI的后端服务的。

在”AG-UI详解-04：如果构建一个兼容AG-UI协议的Agent“中，我们通过在一个ASP.NET Core应用中注册了一个绑定指定IChatClient的路由终结点，使外界可以通过Web调用的方式以AG-UI协议调用对应的LLM。在这篇文章中，我们看看AG-UI客户端又该如何开发。和前面一样，我们的目的仅仅是作一个简单的演示，并非开发一款真正的功能完备的AG-UI客户端，所以我们的客户端建立在一个简单的假设上面，比如不考虑工具调用、人机交互、多模态消息内容和中断等

Agent是AG-UI协议的核心组件，负责处理请求和生成响应。它们为前端应用程序提供了一种标准化的方式，使其能够通过一致的接口与AI服务进行通信，而无需考虑底层实现方式。与我们针对某个Agent框架（MAF或者LangChain）谈论的Agent不同，AG-UI语境下的Agent本质上是一个供前端应用调用的远程服务。

AG-UI基于灵活的**事件驱动**架构构建，可实现前端应用程序和Agent之间无缝、高效的通信。**事件驱动**是整个AG-UI的核心，整个协议层以如下的形式为应用程序与Agent之间的交互提供一个灵活的通信基础。在前一篇中，我们针对Python SDK对各种`RunAgentInput`和各种事件类型，以及基于这些事件类型对相应数据的传输方式进行了详细介绍。这篇文章会使用概括性的语言简单介绍这些类型在.NET SDK种的定义。

AG-UI是一种开放、轻量级、基于**事件**的协议，它规范了Agent与面向用户的前端应用之间的连接方式。AG-UI旨在成为面向用户的应用程序与Agent后端之间的通用双向连接。它提供了简单灵活的方式规范了数据在LLM、Agent Runtime和前端应用之间的流动方式，从而使应用程序开发人员能够快速交付可靠、可调试、用户友好的Agent功能，同时专注于应用程序需求并避免复杂的临时连接。

AG‑UI是微软在Microsoft Agent Framework (MAF)中定义的标准化前后端通信协议，用来构建Web/移动端的AI Agent UI。它让Agent不再只是后端逻辑，而是能以统一格式与前端实时交互、流式输出、同步状态，并渲染交互式组件。本系列将对协议本身以及背后的执行原理对AG-UI进行系统介绍。