旧的「LangGraph 与 AutoGen」二选一,今天实际隐藏了四个不同决策。LangGraph 已进入稳定 1.x;Microsoft AutoGen 进入维护模式;Microsoft Agent Framework 为 Python 与 .NET 发布了 1.0;AG2 1.x 则成为独立治理的活跃框架,经典 autogen API 已迁到另一条维护线。
生命周期比语法更重要。新项目应比较仍在主动演进的 Runtime;现有 AutoGen 团队则要比较迁移路径、状态兼容性、运营风险和继续锁版的成本。
核心要点
- LangGraph 1.x 是面向显式状态、Persistence、Interrupt 与 Replay 的低层图运行时。
- Microsoft Agent Framework 1.0 是微软为 Python 与 .NET 支持的 AutoGen 与 Semantic Kernel 后继;独立 Go SDK 仍处于预览。
- Microsoft AutoGen 仍可用于既有系统,但官方仓库说明它不再增加新功能或增强。
- AG2 1.x 使用
ag2包和新协议导向 API;AG2 Classic 维护旧autogen与ConversableAgent路线。 - 迁移是围绕状态、Tool、副作用和恢复的行为重构,不是替换导入路径。
先识别正确的项目身份
「AutoGen」这个名字现在可能指向互不兼容的软件包路线:
| 路线 | 当前角色 | 软件包或导入 | 生命周期 |
|---|---|---|---|
| LangGraph | 低层有状态编排 Runtime | langgraph |
稳定 1.x |
| Microsoft AutoGen | AgentChat 与事件驱动 Core | autogen-agentchat、autogen-core、autogen-ext |
维护模式 |
| Microsoft Agent Framework | 微软后继,提供 Agent 与类型化 Workflow | agent-framework、Microsoft.Agents.AI |
核心稳定 1.0 |
| Microsoft Agent Framework for Go | 独立 Go 实现 | github.com/microsoft/agent-framework-go |
公开预览 |
| AG2 | 协议导向的活跃框架 | ag2、import ag2 |
活跃 1.x |
| AG2 Classic | ConversableAgent 与 GroupChat 血统 | autogen |
维护模式 |
不能从名称推断兼容性。每个生产服务都应记录仓库、Distribution、Import Path、精确版本、状态格式和路线图负责人。
比较架构,而不是比较品牌
LangGraph 把 Workflow 建模为状态转换。Node 返回部分 Update,Reducer 合并 Channel,Edge 选择后续工作;持久化 Checkpointer 配合稳定 Thread ID 才能暂停、Replay 与恢复。Runtime 可以混合确定性函数和模型驱动步骤,也不要求一定采用多 Agent。
Microsoft AutoGen 把底层事件驱动 Core 与高层 AgentChat Team 组合起来。这套架构仍可服务既有部署,但维护模式改变了风险判断:它已不再是与主动开发框架对等的新项目候选。
Microsoft Agent Framework 把 Agent 与类型化 Workflow 分开。Agent 负责模型交互和 Tool Use,Workflow 在 Agent 与确定性 Executor 之间路由类型化消息。1.0 已稳定 Python 与 .NET 核心;Go SDK 实现了许多相同概念,但官方仓库明确标记为预览,并维护功能差异表。
AG2 1.x 不是经典 AutoGen 对话 API 换了一个版本号。它在 v1 把协议导向 Runtime 迁到 ag2 包,并把 ConversableAgent、GroupChat 与 import autogen 移到 AG2 Classic。经典代码可以继续锁版运行,但采用活跃 AG2 需要规划 API 与状态迁移。
什么时候多 Agent 值得增加复杂度
只有当多个 Agent 形成真实边界时,协调成本才值得:
- 使用不同凭证或数据范围;
- 专业工作可以独立验收;
- 并行任务带来可测量的墙钟时间收益;
- 所有权或审批责任确实分离;
- 上下文隔离能减少意外泄露。
「有多个步骤」通常只意味着需要 Workflow,而不是更多 Agent。先从确定性代码或单个有边界的 AI Agent 开始,再由评测证明是否需要增加协作。更完整的架构判断见多智能体系统指南。
状态与恢复决定真实适配度
框架功能表经常把五类数据混在一起:
| 数据类别 | 必须具备的性质 |
|---|---|
| Run State | 有版本的状态转换与终态 |
| Checkpoint | 绑定稳定 Run Identity 的持久恢复点 |
| 长期 Memory | 同意、来源、保留与删除 |
| 外部 Effect | 幂等、回执、对账与补偿 |
| Audit Event | 带隐私控制的不可变证据 |
LangGraph Checkpoint 能保存 Thread State,但 Replay 从 Node 或 Entrypoint 开始,不会回到原代码行。Microsoft Agent Framework Checkpoint 能保留 Workflow 进度,却不能证明外部支付是否提交。AG2 的 Stream 与 Persistence Adapter 也仍需应用定义结果语义。任何框架都无法把远程副作用自动变成 Exactly-once 事务。
建立可执行的迁移清单
迁移前应先把决策写成数据。下面的 Go 标准库示例会拒绝一份缺少关键证据的计划:
package main
import (
"errors"
"fmt"
)
type MigrationPlan struct {
Source string
Target string
StateMapped bool
EffectsMapped bool
ReplayTested bool
RollbackPrepared bool
}
func validate(plan MigrationPlan) error {
if plan.Source == "" || plan.Target == "" || plan.Source == plan.Target {
return errors.New("distinct source and target are required")
}
if !plan.StateMapped {
return errors.New("state schema has not been mapped")
}
if !plan.EffectsMapped {
return errors.New("external effects have no migration contract")
}
if !plan.ReplayTested || !plan.RollbackPrepared {
return errors.New("replay and rollback evidence are required")
}
return nil
}
func main() {
plan := MigrationPlan{
Source: "microsoft-autogen",
Target: "microsoft-agent-framework",
StateMapped: true,
EffectsMapped: true,
ReplayTested: true,
RollbackPrepared: true,
}
if err := validate(plan); err != nil {
panic(err)
}
fmt.Printf("migration approved: %s -> %s\n", plan.Source, plan.Target)
}
清单还应固定模型客户端、Tool Schema、Prompt、中间件顺序、Persistence Adapter、部署拓扑与评估器版本。
选型矩阵
下面是待验证的起始假设,不是通用排行榜:
| 工作负载 | 优先验证的候选 | 必须验证的主要风险 |
|---|---|---|
| 显式分支、持久状态、Replay、审批 | LangGraph 1.x | Reducer 不变量、持久 Checkpointer、Replay 副作用 |
| 新建 Python 或 .NET 微软技术栈服务 | Microsoft Agent Framework 1.0 | Provider 对齐、Workflow 语义、托管集成成熟度 |
| 新建与微软技术栈对齐的 Go 服务 | MAF Go 预览版 | 缺失能力、API 变化、支持与回滚策略 |
| 新建协议导向 Agent 网络 | AG2 1.x | 集成成熟度、Stream 持久化、Tool 治理 |
| 既有 Microsoft AutoGen 应用 | 暂时锁版或迁移到 MAF | 维护负担与状态映射 |
| 既有经典 ConversableAgent 应用 | 留在 AG2 Classic 或迁移到 AG2 1.x | 非原地升级的 API 与编排变化 |
更广泛的 Runtime 与运营维度比较见 AI Agent 框架决策指南。
能跨迁移保留的生产控制
- 在模型之外认证 Principal 与 Tenant。
- 每次 Tool 调用都执行对象级授权。
- 把审批绑定到规范化参数与资源版本。
- 在没有环境默认凭证、且网络受限的环境中运行生成代码。
- 使用稳定 Operation ID,并对超时后的未知结果执行对账。
- 限制步骤、墙钟时间、Token、成本、并发和 Fan-out。
- 把模型输出、Agent 消息、检索文档与 Tool 结果视为不可信输入。
- 保留 Trace 证据,但不记录隐藏推理或不必要的个人信息。
这些控制属于应用与平台边界。Graph Edge、Middleware Hook、Prompt 或 Tool Schema 可以携带策略上下文,但都不能独自成为权威。
可复现的迁移测试
让新旧实现在同一份版本化场景上运行:
- 已知答案的确定性读取。
- 外部副作用发生前的 Tool 超时。
- 下游可能已经提交后的超时。
- 使用同一 Operation ID 的重复投递。
- 在每个持久化边界重启 Worker。
- 修改参数后重放旧审批。
- 尝试跨租户访问。
- Tool Result 注入诱导执行后续动作。
- Tool 调用进行中的取消。
- 状态、Artifact 与 Trace 的导出和回滚。
报告任务成功、越权成功、恢复成功、P95 延迟、模型与 Tool 调用数、运维投入和单次成功成本。只有目标 Runtime 保持必要行为并能安全失败,迁移才算通过。
常见问题
Microsoft AutoGen 已被弃用吗?
它进入了维护模式,而不是被删除。现有应用仍可运行,但项目不再增加新功能或增强,并由社区维护。应把它作为有明确迁移期限的遗留系统决策。
AG2 是 Microsoft AutoGen 的新名字吗?
不是。AG2 独立治理,活跃 1.x 使用 ag2 包;AG2 Classic 维护旧 autogen 包。Microsoft AutoGen 是另一个微软仓库,Microsoft Agent Framework 才是微软的后继。
LangGraph 只适用于多 Agent 吗?
不是。LangGraph 可以编排确定性函数、单个 Agent、多个 Agent、Tool 和人工步骤。只有独立能力或上下文能带来可测价值时才增加 Agent。
MAF 1.0 是否意味着所有集成都已稳定?
不是。Python 与 .NET 核心已稳定,单项集成仍可处于预览;独立 Go SDK 也仍为预览且有明确能力缺口。必须锁定并审阅实际部署的组件。
这些框架可以混用吗?
技术上可以通过 Tool、API、MCP 或 A2A 组合,但会增加身份、取消、状态、遥测和错误翻译边界。只有端到端评测证明收益时,才应引入第二套 Runtime。
总结
2026 年的选择已不再只是 LangGraph 与 AutoGen。新系统应比较 LangGraph 1.x、Microsoft Agent Framework 1.0 和 AG2 1.x;Microsoft AutoGen 与 AG2 Classic 则是两条不同的维护路线。把领域命令、授权、Effect Record 和评测 Fixture 放在框架回调之外,下一次迁移才仍然可测试。