autogen

用代码编排多智能体，搞定复杂AI任务

AutoGen 是一个用于构建智能体（Agent）应用的编程框架，由微软推出。它解决了开发复杂多智能体协作系统时面临的编排、对话管理和工具调用难题。核心能力包括：支持定义多个具备不同角色和能力的智能体，通过对话或事件驱动的方式协同完成任务；提供灵活的工作流模式，如顺序对话、分组聊天和嵌套对话；内置与 OpenAI、Azure OpenAI 等大模型的无缝集成，并支持自定义模型；同时提供可观测性工具和调试界面，方便开发者追踪智能体间的消息流。该框架强调模块化和可扩展性，适合从简单聊天机器人到复杂自动化工作流的快速原型开发与生产部署。

开源 free 对话助手

访问官网 ↗ GitHub ↗ 文档 ↗

GitHub 星标 ★ 61115

维护状态低维护

是否开源是

定价模式 free

项目数据

分类对话助手

开发团队microsoft

所属国家

官网地址https://microsoft.github.io/autogen

GitHubhttps://github.com/microsoft/autogen

定价模式free

价格说明开源框架，基于CC-BY-4.0许可证，完全免费，可自行部署使用。

访问状态

是否开源是

开源协议CC-BY-4.0

主要语言Python

技术栈/模型agentic,agentic-agi,agents,ai,autogen,autogen-ecosystem,chatgpt,framework,llm-agent,llm-framework

GitHub 星标★ 61115

30天Star增速

HF 下载量

上线时间2023-08-18 00:00:00

最近更新2026-09-22 00:00:00

维护状态低维护

中文支持

访问方式

移动端支持

综合评分

收录时间2026-08-09

浏览次数3

使用教程

难度：入门约 10 分钟部署方式：库/依赖 7 步

环境要求

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

安装与启动步骤

1确认 Python 版本

AutoGen 要求 Python 3.10 或以上，先确认本机版本满足要求，否则先升级 Python。
```
python --version
```
2安装 AgentChat 与扩展

从 Extensions 安装 AgentChat 和 OpenAI 客户端扩展，这是使用 AutoGen 的核心依赖包。
```
pip install -U "autogen-agentchat" "autogen-ext[openai]"
```
3配置 OpenAI Key

示例代码会调用 OpenAI API，需要先注册账号并把 Key 导出为环境变量 OPENAI_API_KEY。
```
export OPENAI_API_KEY="sk-xxxxxxxx"
```
4安装 MCP 服务器

官方快速开始示例使用 Playwright MCP 服务器，需先通过 npm 全局安装该服务器。
```
npm install -g @playwright/mcp@latest
```
5运行快速开始示例

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

如需无代码 GUI，可额外安装 autogenstudio 包，它提供可视化界面来搭建与调试智能体。
```
pip install -U "autogenstudio"
```
7启动 AutoGen Studio

用命令行启动本地 Web UI，指定端口 8080 和应用数据目录，随后在浏览器访问即可使用。
```
autogenstudio ui --port 8080 --appdir ./my-app
```

关键配置

配置项	必填	说明	示例
`OPENAI_API_KEY`	是	OpenAI API 密钥，示例程序调用模型时使用	`sk-xxxxxxxx`
`model`	否	OpenAIChatCompletionClient 使用的模型名	`gpt-4.1`
`--port`	否	AutoGen Studio 服务监听端口	`8080`
`--appdir`	否	AutoGen Studio 应用数据存放目录	`./my-app`

如何确认成功

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

常见问题

Q：AutoGen 现在还能正常使用吗？

A：可以，但项目已进入维护模式，不再增加新功能，转为社区维护。新用户建议直接使用 Microsoft Agent Framework，老用户可参考官方迁移指南迁移。

Q：需要什么 Python 版本？

A：README 明确要求 Python 3.10 或更高版本，低于该版本无法安装。

Q：从 AutoGen v0.2 升级要注意什么？

A：需要参考官方 Migration Guide，按文档说明更新代码和配置。

Q：运行示例前还需要装什么？

A：示例用到 Playwright MCP 服务器，需先执行 npm install -g @playwright/mcp@latest 安装。

Q：连接 MCP 服务器有安全风险吗？

A：README 警告只连接可信的 MCP 服务器，因为它们可能在本地执行命令或暴露敏感信息。

注意事项

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

核心亮点

多智能体对话编排灵活，支持顺序、分组和嵌套工作流
与主流大模型API深度集成，开箱即用
提供可视化调试和监控工具，降低排查成本

不足之处

学习曲线较陡，概念多，上手门槛高
文档更新频繁，部分示例与最新版本不一致

适用场景

构建多角色协作的复杂任务自动化流程
开发需要工具调用和代码执行的AI助手
快速原型验证多智能体交互逻辑

替代项目

LangChain、CrewAI、MetaGPT

项目介绍

autogen 是智能体领域的开源项目，由 microsoft 开发，2023 年首次发布。

在全站 13,014 个收录项目中，它的 GitHub 星标数（61,115）位列前 1%，在智能体分类的 2,499 个项目里位列前 1%。

近 44 天，它的 GitHub 星标从 60,330 增加到 61,115，净增 785。

项目已超过三个月没有代码更新，维护节奏明显放缓，最近一次代码更新于 2026-09-22。基于CC-BY-4.0许可证，完全免费，可自行部署使用。

它主要面向的使用场景是：构建多角色协作的复杂任务自动化流程。同类可对比的替代方案包括 LangChain、CrewAI、MetaGPT。

上一篇：SKILLS_All-in-one

下一篇：agent-skill-lecture-builder