MetaGPT：基于多智能体的软件开发框架使用指南

MetaGPT：基于多智能体的软件开发框架使用指南

介绍

随着大语言模型（LLM）技术的快速发展，AI 智能体（Agent）在自动化任务执行方面展现出巨大潜力。MetaGPT 是一个开源的多智能体框架，旨在模拟真实软件公司的运作模式。它内部包含了完整软件团队所需的所有角色，如产品经理、架构师、项目经理、工程师等。

通过输入一句话需求，MetaGPT 能够自动输出用户故事、竞品分析、需求文档、数据结构设计、API 接口定义以及最终的文件代码。这种协作模式极大地降低了软件开发的门槛，使得个人开发者也能利用 AI 完成复杂的项目构建。

核心角色分工

MetaGPT 将开发流程拆解为多个专业角色，每个角色拥有特定的职责和权限：

1. 老板（User）：提出初始需求，例如'写一个红心'或'开发一个简单的待办事项应用'。
2. 产品经理（Product Manager）：负责需求分析，撰写和修改产品需求文档（PRD），确保需求清晰可执行。
3. 架构师（Architect）：根据 PRD 进行系统设计，编写技术选型方案，审核产品需求文档，并制定代码规范。
4. 项目经理（Project Manager）：负责任务分解与分配，协调各角色进度，参与需求与设计审核。
5. 开发工程师（Software Engineer）：根据设计文档编写实际代码，进行自查和调试。
6. QA 质量保障（Quality Assurance）：负责编写和执行测试用例，验证功能是否符合预期。

这种多角色协作机制确保了输出结果的专业性和完整性，模拟了人类团队协作的 SOP（标准作业程序）。

安装与环境准备

官方提供了多种安装方式，包括 Docker 容器化部署、Python 包安装以及 Git Clone 本地运行。对于大多数开发者，推荐使用 Python 环境进行安装，以便灵活配置。

前置条件

• Python 版本：必须为 3.9 或以上版本。建议使用 3.10 或 3.11 以获得最佳兼容性。
• 依赖管理：建议创建独立的虚拟环境以避免依赖冲突。

安装步骤

1. 创建虚拟环境（推荐）：

   python -m venv metagpt_env
   source metagpt_env/bin/activate  # Linux/Mac
   # metagpt_env\Scripts\activate  # Windows
   

2. 安装 MetaGPT：

   pip install metagpt
   

3. 可选扩展功能：

   • Mermaid：用于生成流程图和图表。可通过 npm 安装：

     npm install -g @mermaid-js/mermaid-cli
     

   • Pyppeteer：用于将 Mermaid 文本转换为图片，需配合浏览器环境使用。

配置说明

安装完成后，必须配置对应的大模型 API 才能运行。MetaGPT 支持多种 LLM 提供商，默认配置通常位于 config/config2.yaml。

配置文件结构

在项目根目录创建 config 文件夹，并在其中添加 config2.yaml 文件。基础配置示例如下：