microsoft/autogen skill 新用户还该不该从 AutoGen 开始

你准备从 microsoft/autogen 开一个新的多代理项目时，先停一下。仓库 README 已经把 AutoGen 标成 maintenance mode，并建议新用户从 Microsoft Agent Framework 开始。这个信息比安装命令更影响后续选择。

这份 skill 教程的答案很直接：新生产项目别默认从 AutoGen 起步；维护旧项目、学习 AgentChat、迁移前验证行为，仍然可以本地安装 AutoGen。把这三种场景分开，才不会把短期样例当长期架构。

新项目先看继任框架

AutoGen README 说它后续由社区维护，不会继续接收新功能增强。新项目如果关心稳定 API、长期支持、多提供商和跨运行时互通，应先看 Microsoft Agent Framework。AutoGen 更适合已有代码维护、概念学习和迁移准备。

如果你只是要理解多代理写法，可以继续用 AutoGen 的 AgentChat。安装路径很短，但前提是 Python 版本和模型 Key 都准备好。

pip install -U "autogen-agentchat" "autogen-ext[openai]"
export OPENAI_API_KEY="sk-..."

第一次只验证 Agent 能返回

最小验证用一个 AssistantAgent 就够了。看到它能调用模型并返回结果，再谈多代理、工具和 MCP。

import asyncio
from autogen_agentchat.agents import AssistantAgent
from autogen_ext.models.openai import OpenAIChatCompletionClient

async def main():
    client = OpenAIChatCompletionClient(model="gpt-4.1")
    agent = AssistantAgent("assistant", model_client=client)
    print(await agent.run(task="Say 'Hello World!'"))
    await client.close()

asyncio.run(main())

Studio 和 MCP 不要当成生产保证

AutoGen Studio 可以用 autogenstudio ui --port 8080 --appdir ./my-app 快速起界面，但 README 明确说它更偏原型和演示，生产所需的认证、安全等能力要自己做。MCP 示例也一样，先装 Playwright MCP，再控制好工具权限和迭代次数。

如果你的目标是上线一个新系统，把 AutoGen 当学习材料会更稳；如果你接手的是旧 AutoGen 项目，先把本地最小示例跑通，再整理迁移清单。这样能把框架状态、代码兼容和业务风险分开处理。