旧的「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 标准库示例会拒绝一份缺少关键证据的计划:

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 可以携带策略上下文,但都不能独自成为权威。

可复现的迁移测试

让新旧实现在同一份版本化场景上运行:

  1. 已知答案的确定性读取。
  2. 外部副作用发生前的 Tool 超时。
  3. 下游可能已经提交后的超时。
  4. 使用同一 Operation ID 的重复投递。
  5. 在每个持久化边界重启 Worker。
  6. 修改参数后重放旧审批。
  7. 尝试跨租户访问。
  8. Tool Result 注入诱导执行后续动作。
  9. Tool 调用进行中的取消。
  10. 状态、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 放在框架回调之外,下一次迁移才仍然可测试。

一手资料