什么是 Microsoft Agent Framework？
Microsoft Agent Framework 是微软开源的 Agent 与 Workflow 平台；Python 和 .NET 核心已发布 1.0，独立维护的 Go SDK 仍处于公开预览阶段。
快速了解
| 规范文档 | 官方规范 |
|---|
工作原理
区分稳定核心与预览能力
2026 年 4 月发布的 1.0 将 Python 与 .NET 的核心 Agent、中间件、Memory/Context Provider、Workflow 和常见编排模式设为稳定能力。DevUI、部分托管集成、Skill 等扩展仍可独立处于预览。Go SDK 在独立仓库开发，目前也属于公开预览，并明确缺少 Declarative Agent、部分 Hosting 和 Handoff 编排。
迁移前映射 AutoGen 行为
Microsoft AutoGen 由事件驱动 Core 与高层 AgentChat Team 组成；Agent Framework 则以 Agent 和类型化数据流 Workflow 为中心。迁移必须逐项映射模型客户端、消息、Tool Loop、Session State、Team 或 GraphFlow 行为、Checkpoint 与遥测，并让新旧实现运行同一任务及故障语料，不能把「官方后继」当作兼容性证明。
把业务副作用放在框架保证之外
Workflow Checkpoint 与 Hydration 可以保存框架状态，却无法证明崩溃前的支付、邮件、部署或数据库写入是否已经提交。审批应绑定规范化参数与资源版本；外部写入应使用持久化幂等键和 Effect Record，对未知结果进行对账，并在服务边界执行租户与对象级授权。
主要特点
- 稳定核心：Python 与 .NET 已发布 1.0 Agent 和 Workflow API
- 预览 Go 路线：独立 Go SDK 已覆盖核心能力，但明确存在功能缺口
- Agent 组合：整合模型客户端、Instructions、Tool、Session、Context Provider 与 Middleware
- 类型化工作流：通过图 Edge 与 Executor 路由数据，而不是只依赖自由对话
- 运行控制：支持 Checkpoint、暂停、流式事件、遥测和长任务
- 应用控制：协议适配器不能替代授权、隔离和副作用一致性
常见用途
- 基于稳定 1.0 API 构建 Python 或 .NET 助手
- 评估预览版 Go SDK 是否适合有边界的 Agent 与 Workflow
- 在同一类型化工作流中组合确定性函数与模型驱动 Agent
- 为长任务增加授权暂停，并从持久化状态恢复
- 通过显式行为映射迁移 AutoGen 或 Semantic Kernel 应用
示例
Loading code...常见问题
Microsoft Agent Framework 已经可以用于生产吗？
Python 与 .NET 核心已于 2026 年 4 月发布 1.0，承诺稳定 API 和长期支持；单项集成仍可能处于预览。独立 Go SDK 也仍是公开预览，因此团队必须记录实际部署的语言、软件包版本和功能状态。
Microsoft Agent Framework 会取代 AutoGen 吗？
微软把 Agent Framework 定义为 AutoGen 与 Semantic Kernel 面向新项目的直接后继，Microsoft AutoGen 则已进入维护模式。现有应用仍需显式映射客户端、消息、Tool、Session、状态、编排和遥测，不能只改导入路径。
Microsoft Agent Framework 支持 Go 吗？
支持，但由独立开源仓库提供，当前处于公开预览，尚未与 Python 或 .NET 的全部能力对齐。采用前需要逐项核对模型提供方、Workflow、Hosting、Declarative Agent 和编排模式是否覆盖真实需求。
什么时候应使用 Agent，什么时候使用 Workflow？
任务定义不完整、需要模型动态选择 Tool 时使用 Agent；路由、并行、审批或恢复边界必须显式时使用 Workflow。Workflow 可以把 Agent 与确定性 Executor 组合起来，两种抽象是互补关系。
Workflow Checkpoint 能保证 exactly-once 执行吗？
不能。Checkpoint 能记录框架状态，却无法证明崩溃前的外部副作用是否已经提交。高影响 Tool 需要稳定 Operation ID、幂等控制、持久化 Effect Record、结果对账、授权，以及可逆场景中的补偿操作。