AutoGen 中文教程：先确认你是在维护还是新建
AutoGen 曾是 Microsoft 的主要多智能体框架，包含 AgentChat、Core、扩展包和 AutoGen Studio。官方仓库现在明确处于维护模式，不再接收新功能。维护存量应用可以继续固定版本；新项目应先评估官方继任者 Microsoft Agent Framework。
1. 先决定维护路线
如果现有系统已经使用 AutoGen 0.4+，先记录代理类型、团队编排、模型客户端、工具权限和回归样例。若尚未写代码，直接阅读 Microsoft Agent Framework 文档与迁移指南，避免在停止功能开发的框架上增加新依赖。
2. 在隔离环境固定依赖
python3 -m venv .venv source .venv/bin/activate python3 -m pip install -U "autogen-agentchat" "autogen-ext[openai]"
这是官方安装结构的示意。正式项目应由锁文件固定解析后的版本，并按实际模型提供方选择 extra。API key 使用测试项目和低额度账户，放在环境变量或密钥服务中。
3. 从最小 AgentChat 流程开始
from autogen_agentchat.agents import AssistantAgent from autogen_ext.models.openai import OpenAIChatCompletionClient # 使用测试模型客户端创建 AssistantAgent # 先给固定输入，不接外部写入工具
先验证可重复的文本任务，再逐个添加工具。读文件、浏览网页和调用外部服务要分别限定权限。发信、删除、付款或发布内容应保留人工批准，模型输出也要进入应用自己的日志与评估。
4. Studio 只负责原型入口
AutoGen Studio 能帮助搭建和观察流程，但不会替应用补齐生产身份、审计、密钥轮换和故障恢复。准备上线前，仍要对每个工具做允许列表、超时、重试和副作用测试。
与 Microsoft Agent Framework 对比
Microsoft Agent Framework 是官方指定的继任项目，面向 Python 和 .NET，并继续发展智能体、工作流以及 A2A、MCP 等互操作能力。AutoGen 适合维持已有 API 和实验；新系统应先用 Agent Framework 做小型原型。迁移不要一次替换全部代理，先挑一个有固定回归样例的流程比较结果。
这里仅补原教程没有展开的事实和边界。安装命令与操作步骤仍以前文为准。
先判断这个项目是否适合你
采用建议
AutoGen 仍有存量维护和学习价值，但官方路线已经改变。现有团队应锁定版本、补齐工具权限与回归评估，并制定迁移计划；新项目直接比较 Microsoft Agent Framework 的当前能力更合理。
原教程未展开的系统信息
核心功能
模型与工具扩展
autogen-ext 提供模型客户端和工具集成，包括 OpenAI 适配与 MCP 相关能力。
事件驱动运行时
底层 Core API 支持消息、运行时与分布式智能体模式，高层 AgentChat 建立在其上。
架构与数据流
AutoGen 采用分层包结构：autogen-core 提供事件驱动运行时和消息抽象，autogen-agentchat 提供面向应用的代理与团队 API，autogen-ext 接入模型客户端和工具，AutoGen Studio 提供可视化原型入口。模型调用和工具执行仍由应用开发者负责权限、日志与评估。
核验与使用边界
优势与限制
优势
- AgentChat API 能较快搭建多智能体原型
- Core 与扩展包分层清楚
- 支持多种模型和工具接入
限制
- 官方已进入维护模式，不再增加新功能
- 模型与工具行为必须由应用方评估和约束
- 旧版到 0.4+ 存在迁移成本
排错时先核对版本、运行环境和未覆盖范围。这里没有执行过的步骤不会写成实测结论。
常见问题
AutoGen 现在还适合新项目吗？
官方仓库已进入维护模式，并建议新用户采用 Microsoft Agent Framework。AutoGen 更适合维护存量系统、复现实验或准备迁移。
AutoGen python-v0.7.4 需要哪个 Python 版本？
官方安装说明要求 Python 3.10 及以上。模型扩展要按所选提供方另装对应的 autogen-ext extra。
AutoGen Studio 能直接当生产平台吗？
它适合搭建和调试原型，但生产权限、密钥、观测、评估和故障处理仍需应用方设计。不能因为使用图形界面就省略这些控制。
从 AutoGen 迁移到 Microsoft Agent Framework 要重写吗？
官方迁移指南给出概念和 API 的对应关系。实际改动取决于使用的代理、团队、工具和运行时，应该先做小范围迁移验证。