autogen

环境要求

• Python 3.10 或更高版本
• 可用的 pip 包管理器
• 用于运行示例的 OpenAI 账户与 API Key
• （运行 MCP 示例时需要）Node.js/npm，用于安装 Playwright MCP 服务器

安装与启动步骤

1. 1确认 Python 版本

   AutoGen 要求 Python 3.10 或以上，先确认本机版本满足要求，否则先升级 Python。

   python --version

   复制

2. 2安装 AgentChat 与扩展

   从 Extensions 安装 AgentChat 和 OpenAI 客户端扩展，这是使用 AutoGen 的核心依赖包。

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

   复制

3. 3配置 OpenAI Key

   示例代码会调用 OpenAI API，需要先注册账号并把 Key 导出为环境变量 OPENAI_API_KEY。

   export OPENAI_API_KEY="sk-xxxxxxxx"

   复制

4. 4安装 MCP 服务器

   官方快速开始示例使用 Playwright MCP 服务器，需先通过 npm 全局安装该服务器。

   npm install -g @playwright/mcp@latest

   复制

5. 5运行快速开始示例

   把 README 的示例代码保存为 quickstart.py（含 AssistantAgent、McpWorkbench），然后执行它查看智能体输出。

   python quickstart.py

   复制

6. 6安装 AutoGen Studio

   如需无代码 GUI，可额外安装 autogenstudio 包，它提供可视化界面来搭建与调试智能体。

   pip install -U "autogenstudio"

   复制

7. 7启动 AutoGen Studio

   用命令行启动本地 Web UI，指定端口 8080 和应用数据目录，随后在浏览器访问即可使用。

   autogenstudio ui --port 8080 --appdir ./my-app

   复制

关键配置

如何确认成功

执行示例后在控制台看到智能体运行消息；AutoGen Studio 启动后浏览器打开 http://localhost:8080 能看到界面。

常见问题

注意事项

• AutoGen 已处于维护模式（Maintenance Mode），不会再收到新特性，长期项目建议评估 Microsoft Agent Framework。
• 示例代码会真实调用 OpenAI API 并产生费用，请妥善保管 API Key，不要提交到代码仓库。
• MCP 服务器可能在本机执行命令或读取敏感信息，仅连接可信来源。
• AutoGen Studio 启动命令中的端口与 appdir 路径可按本地情况调整。