AgentVerse

编排多智能体协作,搞定复杂任务与模拟场景

AgentVerse 是一个用于部署和管理多个基于大语言模型(LLM)的智能体的开源框架,主要提供两种核心框架:任务解决(task-solving)和模拟(simulation)。任务解决框架将多个智能体组织成协作团队,共同完成复杂任务,通过动态选择与协作机制提升问题解决效率;模拟框架则用于构建多智能体交互环境,模拟真实场景下的社会行为或系统演化。该项目解决了单个LLM在复杂任务中能力受限、以及多智能体协作缺乏统一编排的问题,核心能力包括智能体角色分配、动态通信、工具调用集成、以及可视化监控界面。它支持与主流LLM(如GPT、Claude等)对接,并提供Python和JavaScript接口,便于开发者快速集成到现有应用中。

开源 free 开源模型
访问官网 ↗ GitHub ↗ 文档 ↗
GitHub 星标 ★ 5138
维护状态 低维护
是否开源 是
定价模式 free

项目数据

分类开源模型
开发团队OpenBMB
所属国家
官网地址
定价模式free
价格说明开源项目,Apache-2.0 许可证,可免费使用和部署。
访问状态
是否开源是
开源协议Apache-2.0
主要语言JavaScript
技术栈/模型agent,ai,gpt,gpt-4,llm
GitHub 星标★ 5138
30天Star增速
HF 下载量
上线时间2023-05-06 00:00:00
最近更新2026-09-22 00:00:00
维护状态低维护
中文支持
访问方式
移动端支持
综合评分
收录时间2026-08-09
浏览次数2

使用教程

难度:进阶 约 15 分钟 部署方式:本地安装 8 步

环境要求

  • Python >= 3.9
  • 如需运行前端相关命令,需先安装 npm(README 提示:未安装 npm 需先安装)
  • 使用本地模型(如 LLaMA)需额外安装 requirements_local.txt 中的依赖
  • 使用工具调用类任务需先自行构建并启动 XAgent 的 ToolServer
  • 能访问所使用的大模型服务(如 gpt-3.5)

安装与启动步骤

  1. 1克隆仓库

    README 推荐手动安装方式,先拉取源码。使用 --depth 1 只取最新一次提交,体积更小。

    git clone https://github.com/OpenBMB/AgentVerse.git --depth 1
  2. 2进入项目目录

    后续安装命令都需要在 AgentVerse 根目录下执行。

    cd AgentVerse
  3. 3以可编辑模式安装

    手动安装方式,把当前目录的 AgentVerse 装进当前 Python 环境,改动即时生效。

    pip install -e .
  4. 4本地模型附加依赖

    仅当你要搭配 LLaMA 等本地模型使用时执行;只用在线大模型可跳过此步。

    pip install -r requirements_local.txt
  5. 5或改用 pip 安装

    不想克隆源码时可用 pip 直接从 PyPI 安装 agentverse,与手动安装二选一即可。

    pip install -U agentverse
  6. 6跑 Humaneval 基准

    用 gpt-3.5 配置跑 Humaneval 基准测试,指定数据集路径并覆盖已有结果。

    agentverse-benchmark --task tasksolving/humaneval/gpt-3.5 --dataset_path data/humaneval/test.jsonl --overwrite
  7. 7跑单个任务

    运行 brainstorming 单次查询任务,具体任务内容在对应 config.yaml 中定义。

    agentverse-tasksolving --task tasksolving/brainstorming
  8. 8跑工具调用任务

    多智能体调用浏览器、Jupyter、Bing 搜索等工具,需先按 XAgent 文档构建并启动 ToolServer。

    agentverse-tasksolving --task tasksolving/tool_using/24point

关键配置

配置项必填说明示例
--task是指定要运行的任务配置目录(相对 agentverse/tasks 的路径)tasksolving/brainstorming
--dataset_path否基准测试所用数据集文件路径data/humaneval/test.jsonl
--overwrite否覆盖已有的运行结果--overwrite
config.yaml是每个任务目录下的配置文件,任务内容与模型配置在此定义agentverse/tasks/tasksolving/humaneval/gpt-3.5/config.yaml

如何确认成功

安装时 pip 无报错;执行 agentverse-tasksolving --task tasksolving/brainstorming 后能正常输出运行日志或结果。

常见问题

Q:手动安装和 pip 安装该选哪个?

A:README 推荐手动安装(git clone 后 pip install -e .),便于直接看和改源码;只想快速用则执行 pip install -U agentverse。

Q:想用 LLaMA 等本地模型怎么办?

A:额外执行 pip install -r requirements_local.txt 安装本地模型所需依赖,之后即可搭配本地模型使用。

Q:工具调用任务(tool_using)跑不起来?

A:需先按 XAgent 仓库的说明构建并启动 ToolServer,启动成功后再执行 agentverse-tasksolving --task tasksolving/tool_using/24point。

Q:提示找不到任务或路径报错?

A:--task 后面的路径要对应 agentverse/tasks/tasksolving 下的实际目录,如 tasksolving/humaneval/gpt-3.5。

注意事项

  • 环境需 Python 3.9 及以上,否则可能安装失败。
  • README 提示若未安装 npm,需先安装 Node.js/npm 再执行相关命令。
  • 本地模型相关依赖是可选项,只用在线大模型时无需执行。
  • 工具调用类任务依赖 XAgent 的 ToolServer,需要单独构建和启动。

核心亮点

  • 提供任务解决与模拟双框架,覆盖协作与仿真两类典型应用场景
  • 支持动态智能体选择与协作,能根据任务需求灵活调整团队构成
  • 内置可视化监控界面,方便观察智能体交互与任务进度

不足之处

  • 项目文档相对简略,高级用法需阅读源码理解
  • 社区活跃度一般,示例和教程资源有限

适用场景

  • 多智能体协作完成复杂推理或代码生成任务
  • 模拟社会现象或群体行为,用于研究或教育
  • 构建客服或助手系统,多个专业智能体分工响应

替代项目

AutoGen、MetaGPT、ChatDev

项目介绍

AgentVerse 是开发框架领域的开源项目,由 OpenBMB 开发,2023 年首次发布。

在全站 13,090 个收录项目中,它的 GitHub 星标数(5,138)位列前 9%,在开发框架分类的 803 个项目里位列前 10%。

近 41 天,它的 GitHub 星标从 5,101 增加到 5,138,净增 37。

项目已超过三个月没有代码更新,维护节奏明显放缓,最近一次代码更新于 2026-09-22。Apache-2.0 许可证,可免费使用和部署。

它主要面向的使用场景是:多智能体协作完成复杂推理或代码生成任务。同类可对比的替代方案包括 AutoGen、MetaGPT、ChatDev。

上一篇:lms

下一篇:poml

同类项目推荐

langchain 开源

组装 AI 应用的乐高积木,从想法到上线不换工具

The agent engineering platform.

★ 146874 2026-08-09
transformers 开源

全球最大的模型仓库全家桶,想用的模型一把抓

Transformers: the model-definition framework for state-of-the-art machine learning m···

★ 166529 2026-08-09
pi 开源

一套 TypeScript 工具包,快速搭出能写代码的 AI agent

AI agent toolkit: unified LLM API, agent loop, TUI, coding agent CLI

★ 108504 2026-09-12