AutoGen 快速上手教程（GitHub README 中文整理）

是什么

AutoGen 是微软推出的多智能体 AI 应用开发框架，支持 AI 智能体自主运行或与人类协作完成任务。目前该项目已进入维护模式（不再添加新功能），微软推荐新用户转向新一代企业级框架 Microsoft Agent Framework（MAF），现有用户可参考官方迁移指南进行升级。

能干什么

• 构建单智能体助手：基于 GPT-4o 等大模型创建对话助手
• 集成 MCP 服务器：连接外部工具（如 Playwright 浏览器自动化）
• 多智能体编排：通过 AgentTool 让多个智能体协同工作
• 无代码界面：提供 AutoGen Studio 图形化操作工具
• 跨运行时互操作：支持 A2A 和 MCP 协议

怎么装

环境要求：Python 3.10 或更高版本

# 安装核心包和 OpenAI 扩展
pip install -U "autogen-agentchat" "autogen-ext[openai]"

# 安装无代码 GUI 工具（可选）
pip install -U "autogenstudio"

从 v0.2 升级的用户请查阅官方迁移指南。

怎么用（第一个例子）

以下示例调用 OpenAI API，需先设置环境变量（国内访问受限，推荐使用国产替代模型）：

export OPENAI_API_KEY="sk-..."

Hello World 示例

创建一个基于 GPT-4.1 的助手智能体：

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

async def main() -> None:
    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())

浏览器助手示例（需安装 Playwright MCP）

npm install -g @playwright/mcp@latest

import asyncio
from autogen_agentchat.agents import AssistantAgent
from autogen_agentchat.ui import Console
from autogen_ext.models.openai import OpenAIChatCompletionClient
from autogen_ext.tools.mcp import McpWorkbench, StdioServerParams

async def main() -> None:
    model_client = OpenAIChatCompletionClient(model="gpt-4.1")
    server_params = StdioServerParams(
        command="npx",
        args=["@playwright/mcp@latest", "--headless"],
    )
    async with McpWorkbench(server_params) as mcp:
        agent = AssistantAgent(
            "web_browsing_assistant",
            model_client=model_client,
            workbench=mcp,
            model_client_stream=True,
            max_tool_iterations=10,
        )
        await Console(agent.run_stream(
            task="Find out how many contributors for the microsoft/autogen repository"
        ))

asyncio.run(main())

⚠️ 仅连接可信的 MCP 服务器，避免执行恶意命令或泄露敏感信息。

社区资源

• 📖 官方文档
• 💬 Discord 社区
• 🐦 Twitter @pyautogen
• 📝 官方博客
• 🔄 Microsoft Agent Framework（推荐新用户使用）

翻译整理自 GitHub README，原文：https://github.com/microsoft/autogen