什么是 Microsoft Agent Framework？
Microsoft Agent Framework 是微软面向 Python 与 .NET 的开源开发套件，用于构建 AI Agent 和类型化、图式工作流。微软将其定义为 AutoGen 与 Semantic Kernel 的直接后继，并分别提供 Agent、Session、Context、Middleware、Tool 与 Workflow 执行抽象。
快速了解
| 规范文档 | 官方规范 |
|---|
工作原理
Microsoft Agent Framework 将开放式 Agent 行为与显式编排分开。Agent 组合模型客户端、Instructions、Tool 和可选 Context Provider；AgentSession 承载对话状态；Middleware 可检查或约束调用；MCP Client 暴露外部能力。对于多步骤系统，Workflow 用类型化 Executor、Edge、路由、嵌套、Checkpoint 与 Request-response 暂停来组织人工输入。这种演进不是从 AutoGen 直接替换命名空间：团队必须重新映射模型客户端、消息、Tool、状态与 Team 模式。Checkpoint 能保留工作流状态，但不能让数据库写入、支付或消息发送自动获得 exactly-once 语义；生产系统仍需幂等键、Effect Record、对账、授权和租户隔离。
主要特点
- 双 SDK 范围：为 Python 与 .NET 提供相互对应的 Agent 与 Workflow 抽象
- Agent 组合：整合模型客户端、Instructions、Tool、Session、Context Provider 与 Middleware
- 类型化工作流：通过图 Edge 与 Executor 路由消息，而不是只依赖自由形式的 Agent 对话
- 运行控制：支持 Checkpoint、Request-response 暂停、人工交互与遥测集成
- 协议集成：可连接 MCP Server，但信任、权限和数据边界仍由应用负责
常见用途
- 构建带 Session 状态和受治理 Tool 的 Python 或 .NET 助手
- 在同一类型化工作流中组合确定性函数与模型驱动 Agent
- 为长任务增加人工审批暂停，并从持久化状态恢复
- 通过显式 API 映射迁移 AutoGen 或 Semantic Kernel 应用
- 在企业 Agent 执行路径中接入 Middleware、遥测和 MCP
示例
Loading code...常见问题
Microsoft Agent Framework 会取代 AutoGen 吗？
微软把 Agent Framework 定义为 AutoGen 与 Semantic Kernel 面向新项目的直接后继，但 AutoGen 仍是独立项目和 API。现有应用不能只改导入路径；模型客户端、消息、Tool、Session、状态、Team 模式与可观测 Hook 都需要显式映射和回归测试。
Microsoft Agent Framework 与 AG2 有什么区别？
Microsoft Agent Framework 由微软开发，是 AutoGen 与 Semantic Kernel 的后继路线，提供 Python 与 .NET SDK。AG2 是独立项目，延续经典 `autogen` 与 ConversableAgent 血统，并维护自己的路线图。两者的软件包和 API 不能互换。
什么时候应使用 Agent，什么时候使用 Workflow？
任务定义不完整、需要模型动态选 Tool 或对话探索时使用 Agent；步骤、路由、并行、审批或恢复边界必须显式时使用 Workflow。Workflow 可以把 Agent 与确定性 Executor 组合在一起，因此两种抽象是互补关系。
Workflow Checkpoint 能保证 exactly-once 执行吗？
不能。Checkpoint 记录可恢复的框架状态，却无法证明崩溃前外部支付、邮件、部署或数据库写入是否已经提交。高影响 Tool 需要幂等键、持久化 Effect Record、对账机制，以及在可逆场景中的补偿操作。
采用 Microsoft Agent Framework 前应验证什么？
先核对官方当前发布状态、Python 或 .NET 精确包版本、提供方支持、迁移覆盖、存储适配器、遥测与部署约束；再基于固定评测集验证任务成功率、越权 Tool 尝试、中断恢复、延迟、单次成功成本与回滚能力。