microsoft/autogen skill 本地安装使用教程(新手)

microsoft/autogen 现在最需要先看清的不是安装命令，而是项目状态。README 顶部已经提示 AutoGen 进入 maintenance mode，不再接收新功能增强，新用户被建议从 Microsoft Agent Framework 开始。

所以这个 skill 教程适合两类人：一类是在维护已有 AutoGen 项目，另一类是想用 AgentChat 小例子学习多代理编排。若你正在开全新的生产项目，先评估 Microsoft Agent Framework，再决定是否继续装 AutoGen。

确认仍要用 AutoGen，再安装 AgentChat

AutoGen 要求 Python 3.10 或更高版本。README 里的基础安装路径是安装 AgentChat 和 OpenAI 扩展：

python3 --version
pip install -U "autogen-agentchat" "autogen-ext[openai]"

如果要使用 README 的 OpenAI 示例，还需要先设置 OPENAI_API_KEY。没有 Key 时，安装可以完成，但示例模型调用不会跑通。

export OPENAI_API_KEY="sk-..."

第一次只跑 Hello World

新手不要一开始就写多代理团队。先建一个 AssistantAgent，用 OpenAIChatCompletionClient 发一句小任务，确认包、Key、模型和异步运行都没问题。

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

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

asyncio.run(main())

需要界面原型，再装 AutoGen Studio

AutoGen Studio 适合快速原型和演示，不适合直接当生产后台。README 也提醒，生产部署要自己处理认证、安全和应用层能力。

pip install -U "autogenstudio"
autogenstudio ui --port 8080 --appdir ./my-app

MCP 和多代理放到第二轮

Hello World 通过后，再试 MCP 或多个专家代理。MCP 示例需要先安装 Playwright MCP：npm install -g @playwright/mcp@latest。如果你的目标是长期新项目，别忽略维护模式提醒；如果目标是迁移旧项目，先把当前 AutoGen 版本跑稳，再逐步对照迁移指南。