Microsoft Agent Framework 中 Agent 的架构形态

发布时间:2026/11/19 11:28:37

Microsoft Agent Framework 中 Agent 的架构形态 目录1. 应用托管型 AgentApplication-owned Agent可用的模型提供商不同 Model Provider 面向 Microsoft Agent Framework 提供的能力.NET SDK 和 Endpoint2. 自定义实现型 AgentCustom Agent引用 Abstractions 包自定义 AIAgent3. 远程托管型 AgentRemote / Managed AgentMicrosoft FoundryGitHub CopilotCopilot StudioAnthropic ClaudeA2A总结在使用 Microsoft Agent Framework 时会接触到不同类型的 Agent。它们的创建方式、运行位置以及管理方式都有所不同。按照微软官方文档的划分可以主要从下面三类来理解应用托管型 AgentApplication-owned Agent自定义实现型 AgentCustom Agent远程托管型 AgentRemote / Managed Agent今天我们来解剖一下这三种 Agent 的类型。1. 应用托管型 AgentApplication-owned Agent我们首先来介绍第一种。微软官方的命名是 Model providersApplication-owned Agent 这个名字是我根据 Agent 的职责划分命名的一个名字你可以理解为他们两者是等同的。与此同时这也是我们用得最多的一种形态。微软官方在 Model Providers 文档中是这样描述这种职责关系的模型提供商为 Agent 提供推理客户端。你的应用负责 Agent 定义、Instructions、Tools、Middleware 和 Session Policy而 Model Provider 负责模型推理以及 Provider 托管的相关能力。简单来说Agent Runtime 运行在自己的应用中Agent 的定义和执行流程由应用控制Model Provider 主要负责提供模型推理能力。在 Agent Framework 中ChatClientAgent就是这种开发方式中非常重要的一个 Agent 实现。它的基本结构是ChatClientAgent使用IChatClient与底层模型推理服务进行交互。因此Agent 和 Model Provider 实际上是两个不同的概念ChatClientAgent负责 Agent 的执行与运行管理Model Provider负责提供模型推理客户端以及 Provider 托管的相关能力。那么问题来了ChatClientAgent可以使用哪些模型服务这里并不仅仅只有 Azure。Agent Framework 的ChatClientAgent建立在Microsoft.Extensions.AI.IChatClient抽象之上。任何能够提供Microsoft.Extensions.AI.IChatClient实现的推理服务都可以作为ChatClientAgent的后端模型服务。可用的模型提供商不同 Model Provider 面向 Microsoft Agent Framework 提供的能力不同 Model Provider 面向 Agent Framework 暴露或提供的能力并不完全相同。除了基本的模型推理能力之外一些 Provider 还可以提供 Function Tools、 Structured Outputs、Code Interpreter、File Search、MCP Tools、 Background Responses 等能力。.NET SDK 和 Endpoint针对不同的 AI 服务或模型服务Agent Framework 在 .NET 中需要使用 对应的 Client SDK、NuGet Package 以及 Endpoint。到这里第一种 Agent 的开发方式基本就清楚了……2. 自定义实现型 AgentCustom Agent大多数情况下我们可以直接使用 Agent Framework 已经提供的ChatClientAgent。但是如果ChatClientAgent的执行机制无法满足业务需求需要自己控制 Agent 的核心执行逻辑Agent Framework 还提供了更底层的扩展方式直接继承AIAgent实现自己的 Agent。Microsoft Agent Framework 支持通过继承AIAgent类并实现所需的方法来构建 Custom Agent。这里需要注意Custom Agent 并不是和 Application-owned Agent 完全独立的另一套运行模式。Custom Agent 本质上仍然可以运行在自己的应用中只不过 Agent 的核心执行逻辑由开发者自己实现。简单来说当现成的ChatClientAgent无法满足业务场景需要自己控制 Session、消息处理、执行流程或响应生成逻辑时可以考虑实现 Custom Agent。引用 Abstractions 包自定义 Agent 需要引用dotnet add package Microsoft.Agents.AI.Abstractions自定义 AIAgentCustom Agent 的核心是继承 AIAgent并实现必要的 Session 管理和 Agent 执行方法。Session 可以基于 InMemoryAgentSession 实现但并不限定只能使用这一种 Session。下面先通过一个简单骨架看看 AIAgent 的主要扩展点internal sealedclassMyAgent : AIAgent{ // 1. 创建 Session protected override ValueTaskAgentSession CreateSessionCoreAsync( CancellationToken cancellationToken default) { thrownew NotImplementedException(); } // 2. Session 序列化 protected override ValueTaskJsonElement SerializeSessionCoreAsync( AgentSession session, JsonSerializerOptions? jsonSerializerOptions null, CancellationToken cancellationToken default) { thrownew NotImplementedException(); } // 3. Session 反序列化 protected override ValueTaskAgentSession DeserializeSessionCoreAsync( JsonElement serializedState, JsonSerializerOptions? jsonSerializerOptions null, CancellationToken cancellationToken default) { thrownew NotImplementedException(); } // 4. Agent 非流式执行 protected override TaskAgentResponse RunCoreAsync( IEnumerableChatMessage messages, AgentSession? session null, AgentRunOptions? options null, CancellationToken cancellationToken default) { thrownew NotImplementedException(); } // 5. Agent 流式执行 protected override async IAsyncEnumerableAgentResponseUpdate RunCoreStreamingAsync( IEnumerableChatMessage messages, AgentSession? session null, AgentRunOptions? options null, [EnumeratorCancellation] CancellationToken cancellationToken default) { thrownew NotImplementedException();#pragma warning disable CS0162 yieldbreak;#pragma warning restore CS0162 }}从这个骨架可以看到自定义 AIAgent 主要需要处理两部分内容。第一部分是 Session 管理CreateSessionCoreAsyncSerializeSessionCoreAsyncDeserializeSessionCoreAsync第二部分是 Agent 执行RunCoreAsyncRunCoreStreamingAsync实际上Agent Framework 自带的 ChatClientAgent 本身也是 AIAgent 的一个具体实现。Microsoft 已经在其中实现了 Session 管理、非流式执行、流式执行以及与 IChatClient 交互等逻辑。因此大多数常规的模型 Agent 场景直接使用 ChatClientAgent 即可3. 远程托管型 AgentRemote / Managed Agent前面两种方式主要讨论的是 Agent Framework 应用侧的 Agent 实现。除此之外Agent Framework 还可以接入已经运行在远程服务中的 Agent。微软将这一类集成归到 Agent Services。Agent Services 提供的是远程或托管的 Agent Runtime而不仅仅是模型推理能力。远程服务可以负责 Agent Definition、Hosted Tools、Permissions、Session 或 Execution Lifecycle这也是远程托管型 AgentRemote / Managed Agent和 应用托管型 AgentApplication-owned Agent 一个很重要的区别应用托管型 AgentApplication-owned Agent 主要为应用侧 Agent 提供模型推理客户端 远程托管型 AgentRemote / Managed Agent则提供远程或托管的 Agent RuntimeMicrosoft FoundryMicrosoft Agent Framework 提供了对 Microsoft Foundry Agent Service 的集成。应用可以通过 Agent Framework 接入运行在 Microsoft Foundry 中的 Prompt Agent 或 Hosted Agent。Agent 的定义、版本、Hosted Tools、Conversation 以及服务端执行可以由 Microsoft Foundry 负责。GitHub CopilotAgent Framework 可以接入 GitHub Copilot 的 Coding Agent Runtime。Agent Runtime、Session、权限以及 Shell、File、URL 等内置能力和 MCP 连接由 GitHub Copilot 侧负责Agent Framework 则通过统一接口与这个远程 Agent Runtime 进行交互。目前该集成支持 C#、Python 和 Go。Copilot StudioAgent Framework 可以接入已经发布到 Copilot Studio 中的 Agent。Agent 的 Topics、Knowledge、Actions、Plugins 以及远程执行由 Copilot Studio 负责应用通过 Agent Framework 与这个远程 Agent 进行交互。目前该集成支持 C# 和 Python。Anthropic ClaudeAgent Framework 可以接入由 Claude Agent SDK 提供的 Agent Runtime。Agent Runtime、Session、权限、内置 Tools 和 MCP 连接由 Claude Agent SDK 侧负责。目前 Agent Framework 的这项 Agent Service 集成支持 Python。A2AAgent Framework 还可以通过 A2A 接入符合 A2A 规范的远程 Agent。远程 Agent 负责自己的 Agent Definition、Tools、Session、Task 和 ExecutionAgent Framework 通过 A2A 与其进行交互。目前该集成支持 C#、Python 和 Go。总结理解 Microsoft Agent Framework 中的 Agent可以先抓住一个关键问题Agent Runtime 到底运行在哪里谁负责 Agent 的执行如果 Agent 运行在自己的应用中通常可以直接使用 ChatClientAgent通过 IChatClient 接入不同的 Model Provider。如果现成的 ChatClientAgent 无法满足需求需要自己控制 Session、执行流程或响应生成逻辑可以继承 AIAgent 实现 Custom Agent。如果 Agent 已经运行在 Microsoft Foundry、GitHub Copilot、Copilot Studio、Claude Agent SDK 或其他支持的远程环境中则可以通过 Agent Framework 的 Agent Services 集成进行调用。把 Agent 本身、Model Provider 和 Agent Service 这三个概念分开之后Microsoft Agent Framework 的整体结构就比较容易理解了。引入地址
延伸阅读

更多相关文章

2026/11/19 10:27:04

3个实战案例解决wordpress页面重定向循环

3个实战案例解决wordpress页面重定向循环 域名解析指向了服务器IP,服务器却把请求踢回域名,这个死循环一卡,网站直接白屏。很多项目经理接手烂摊子时,面对后台日志里满屏的301和302跳转,脑子里只剩“域名服务器搞不懂”这几个字。别慌…

2026/11/19 10:27:39

网站构建是什么新手入门避坑指南

网站构建是什么新手入门避坑指南 网站做好了却没人访问,这是绝大多数新手最崩溃的瞬间。别急着怀疑自己的代码写得烂,或者SEO没做好,很多时候是因为你对“网站构建是什么”这个基础概念理解得过于浅显。…

2026/11/19 22:39:57

重庆电工证考场在哪里报名费多少钱 内部消息告诉你真相

重庆电工证考场在哪里报名费多少钱 内部消息告诉你真相 怕考不过白交培训费?重庆电工证考场在哪里,其实很多人都不知道,但内部消息透露,选对地方和机构真的能大大降低风险和成本。 重庆电工证考场在哪里?官方考试地点怎么查? 答:…

2026/11/19 22:39:57

电工证最好考几级2026河南最新政策怎么考更稳妥

电工证最好考几级2026河南最新政策怎么考更稳妥 实操考试心里没底怕挂科,这几乎是每个准备考电工证的人心里的疙瘩。特别是在河南,2026年最新政策对报考条件、考试流程、实操标准等都有了更明确的规定,很多人因此担心自己是否能顺利通过。别急,咱…

2026/11/19 22:39:57

电工作业具备什么技术千万别踩坑 实操考试心里没底怕挂科

电工作业具备什么技术千万别踩坑 实操考试心里没底怕挂科 实操考试心里没底怕挂科?别慌,今天就带你从头到尾说清楚电工作业到底要考什么、怎么考、怎么准备,尤其是郑州的水利工程从业者,千万别踩坑。 电工作业到底考什么技术?…

2026/11/19 22:39:56

深圳高低压电工证在哪考?三门峡建筑工人的真实经历给你答案

深圳高低压电工证在哪考?三门峡建筑工人的真实经历给你答案 我在三门峡工地干了五年,去年被临时叫去协助安装工地配电箱,结果被告知必须有低压电工证才能上岗。当时心里一紧, 急需特种作业证才能上岗找工作 ,这事儿可不能拖。我就开始打听…

2026/11/19 22:14:34

电工证考试口诉怎么准备值不值得考

电工证考试口诉怎么准备值不值得考 实操考试心里没底怕挂科,这是大多数准备考电工证的人心里最真实的感受。尤其是面对【电工证考试口诉】环节,很多人不知道该怎么准备,甚至担心自己说不好就被淘汰。其实,只要掌握方法, 值不值得考…

2026/11/18 21:55:23

桑植县考电工证千万别踩坑!报名全流程教你避坑

桑植县考电工证千万别踩坑!报名全流程教你避坑 你是不是也遇到过这种情况:想考个电工证,但不知道从哪儿下手,怕被中介坑,怕花冤枉钱,更怕考了证还不能用?别急,这正是你该看这篇文章的原因。在桑植县考电工证,确实有很多人被坑过,但只要你知道流程、…

2026/11/19 0:04:42

深圳电工证培训考场模拟考试题库:郑州报考避坑指南

深圳电工证培训考场模拟考试题库:郑州报考避坑指南 证书过期了不知道怎么复审延期,很多人在遇到这个问题的时候才意识到特种作业证的重要性。其实,不管是电工证、焊工证还是高处作业证,这些证书不仅是上岗的“通行证”,更是法律对安全操作的硬性要求。尤…

2026/11/19 0:04:42

天津电工证查询入口多少钱能报上名

天津电工证查询入口多少钱能报上名 学历不高怕报不上名?别急,天津电工证查询入口其实没你想的那么难。今天咱们就来聊聊,怎么用最低的门槛、最少的钱,把电工证拿下来,还能查得到、用得上。 电工证到底值不值?先搞清楚它的作用…

2026/11/18 12:37:05

面向复杂光照与角度的宠物面部识别鲁棒性增强策略

在智慧养宠时代,基于视觉的宠物身份识别技术正逐步从实验室走向家庭应用。然而,与配合度高的人类不同,宠物是典型的“非合作生物识别对象”——它们不会主动配合摄像头调整姿态,更无法控制光照环境。实际应用中,我们常…

2026/11/19 17:18:32

SSM电子书店源码全解析:结构、原理、部署与排错实战

/* MD / 富文本中的 .toc(含博客园搬家等嵌套结构);.toc-box 在侧栏,不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p(:empty 仍占 20px),一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views …

还想了解更多?直接咨询顾问

免费诊断 + 免费方案 + 透明报价。

全国咨询热线400-8866-253
免费获取方案
☎咨询二维码 ☎ ↑