AutoGen

AutoGen 是一个用于创建多智能体 AI 应用的框架，这些智能体既可以自主行动，也可以与人类协同工作。

[!CAUTION] ⚠️ 维护模式 (Maintenance Mode)

AutoGen 目前处于维护模式。它将不再接收新功能或增强，未来将由社区进行管理。

新用户建议从 Microsoft Agent Framework 开始。现有用户请参考 AutoGen → Microsoft Agent Framework 迁移指南 进行迁移。

Microsoft Agent Framework (MAF) 是 AutoGen 的企业级继任者。Microsoft Agent Framework 现已发布生产就绪版本，提供稳定的 API 和长期支持承诺。无论您是构建单个助手还是编排一组专业智能体，Microsoft Agent Framework 1.0 都能通过 A2A 和 MCP 提供企业级多智能体编排、多模型提供商支持以及跨运行时互操作性。

安装

AutoGen 需要 Python 3.10 或更高版本。

# Install AgentChat and OpenAI client from Extensions
pip install -U "autogen-agentchat" "autogen-ext[openai]"

当前稳定版本可在 Releases 中找到。如果您是从 AutoGen v0.2 升级而来，请参阅 迁移指南 以获取更新代码和配置的详细说明。

# Install AutoGen Studio for no-code GUI
pip install -U "autogenstudio"

快速入门

以下示例调用了 OpenAI API，因此您首先需要创建一个帐户并将您的密钥导出为 export OPENAI_API_KEY="sk-..."。

Hello World

使用 OpenAI 的 GPT-4o 模型创建一个助手智能体。查看 其他支持的模型。

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())

MCP Server

创建一个使用 Playwright MCP server 的网页浏览助手智能体。

# First run `npm install -g @playwright/mcp@latest` to install the MCP server.
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, # For multiple MCP servers, put them in a list.
            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 服务器，因为它们可能会在您的本地环境中执行命令或暴露敏感信息。

多智能体编排 (Multi-Agent Orchestration)

您可以使用 AgentTool 创建基本的多智能体编排设置。

import asyncio

from autogen_agentchat.agents import AssistantAgent
from autogen_agentchat.tools import AgentTool
from autogen_agentchat.ui import Console
from autogen_ext.models.openai import OpenAIChatCompletionClient


async def main() -> None:
    model_client = OpenAIChatCompletionClient(model="gpt-4.1")

    math_agent = AssistantAgent(
        "math_expert",