GPTeam 协作智能体
让多个具备记忆的模型智能体在共享世界中并行协作完成预设目标。
- Star 数
- ★ 1.7k
- 最近更新
- 2 年前
- License
- MIT
- 主语言
- Python
- FA 评分
- 44/100 · 缺口较多
30 秒速览
- 运行形态
- 可在哪里用
- 兼容但需适配OpenAI API · Claude API
- 费用
- 软件免费，模型调用费用自付
- 上手难度
- 中 · 需要几步配置
- 开始前需要
- 典型场景
- 研究多智能体协作行为的开发者，可在预设目标下观察多个具备记忆的智能体如何分工和交流。
- 不适合
- 希望开箱即用、不想配置 Python 环境与 .env 密钥的用户
- 需要稳定可复现结果、不接受 --turbo 模式质量下降的团队
- 源码审查
- 44/100 · 缺口较多
这个 Agent 能做什么，适合哪些场景？
GPTeam 是一个以 GPT-4 为核心的开源多智能体模拟项目。它在“world”中运行多个各自拥有记忆的智能体，并让它们通过沟通协作处理预设指令。智能体会在不同地点移动、执行任务，并在需要时与其他智能体对话和并行协作。运行期间，agents/ 目录中的文本文件会提供各智能体当前状态的摘要。项目通过命令行启动，使用 .env 中的 API 密钥连接模型及可选服务。
使用者先运行 python setup.py 检查和配置环境，在 .env 中填写 OpenAI API key，然后以 poetry run world 启动模拟世界。世界会运行多个具有 memory 的智能体；它们可在地点间移动、执行任务、彼此沟通，并围绕共同目标并行协作。运行时可查看 agents/ 下每个智能体对应的 txt 文件，获取其当前状态摘要。可修改 config.json 中的 agents 或 locations，运行 poetry run db-reset 重置数据库后再次启动世界。
- 研究多智能体协作行为的开发者，可在预设目标下观察多个具备记忆的智能体如何分工和交流。
- 需要演示 GPT-4 多智能体模拟的技术团队，可启动 world 并通过
agents/目录查看各智能体状态。 - 想调整模拟参与者或地点的实验者，可编辑
config.json，重置数据库后运行新的世界配置。 - 预算有限、愿意接受较低结果质量的使用者，可用
poetry run world --turbo以 gpt3.5-turbo 运行全部 LLM 调用。 - 拥有 Anthropic 凭据的使用者，可设置
ANTHROPIC_API_KEY后通过poetry run world --claude使用文档说明的 Claude 调用路径。
如何安装或部署这个 Agent？
- 克隆仓库并进入项目目录：
cd gpteam。 - 运行
python setup.py检查并按提示配置环境。 - 在
.env中填写 OpenAI API key；可选服务的 API key 会启用相应工具。 - 使用 Poetry 运行
poetry run world。
如何使用这个 Agent？
首次可直接执行 poetry run world 观察智能体在世界中互动。需要降低成本时执行 poetry run world --turbo；文档说明该模式使用 gpt3.5-turbo，但结果预期较差。修改 config.json 的 agents 或 locations 后，执行 poetry run db-reset，再执行 poetry run world。如要使用 Claude，先设置 ANTHROPIC_API_KEY，然后执行 poetry run world --claude。
这个 Agent 有哪些优点和局限？
- 以共享世界、地点移动和智能体间通信呈现协作过程，而不只是单次模型调用。
- 每个智能体都有 memory，并在运行时提供
agents/状态文本，便于观察模拟过程。 - 提供 GPT-4 默认路径、
--turbo低成本路径，以及 Claude 和 Window 的文档化运行选项。
- 运行需要 OpenAI API key；启用可选工具还需要相应服务的 API key。
--turbo虽可降低成本，但文档明确提示结果会更差。- Window 模式依赖 Window extension，且由于提示词很长，部分模型可能响应缓慢。
- 修改世界配置后需要重置数据库，现有数据库状态会被清除。
这个 Agent 与同类方案有什么区别？
默认运行使用 GPT-4。poetry run world --turbo 会将全部 LLM 调用改为 gpt3.5-turbo，以更低成本换取预期更差的结果；--claude 则使用 claude-v1 和 claude-v1-instant 处理不同调用。
与相关度最高的同类 agent 并排比较关键指标。
| Agent | 源码审查 | 形态 / 费用 | Star | 最近更新 | 主语言 | 完整支持的平台 |
|---|---|---|---|---|---|---|
| GPTeam 协作智能体 当前 | 44 · 缺口较多 | 命令行工具免费 + 模型费 | ★ 1.7k | 2 年前 | Python | OpenAI API · Claude API |
| Obsidian Second Brain | 63 · 存在缺口 | Agent 插件 / 技能免费 + 模型费 | ★ 5.2k | 今天 | Python | Codex · Claude Code |
| Commonly | 70 · 存在缺口 | 自托管服务免费 + 模型费 | ★ 1.4k | 今天 | JavaScript | Codex · Claude Code |
| SwarmVault | 75 · 表现良好 | 命令行工具免费 + 模型费 | ★ 733 | 4 个月前 | TypeScript | Codex · Claude Code |
FollowAgents 如何评估这个 Agent？
查看各维度的扣分理由
README说明需在.env配置OpenAI及可选服务API密钥，main.py读取OPENAI_API_KEY并启动世界、Discord监听器和Web服务器；数据流、权限范围及外部影响有部分可见，但未说明密钥保护、启动确认、恢复或副作用控制，因此多数项目仅得1分。README链接研究论文和架构文章，提供有限归属线索；来源责任和维护更新路径不明确。
README给出启动命令和依赖环境，pyproject.toml列出Python范围及包版本约束；但没有锁文件或依赖可用性保证。main.py捕获异常并打印堆栈，错误处理有基础支持但用户导向信息较弱。README要求先运行setup.py，而所示CI覆盖setup脚本，未验证整体Agent运行，因此自洽性和可靠性支持有限。
README描述多Agent协作、预定义目标、地点及交流，并提供turbo、Claude、Window和Discord选项，场景和环境适配有具体说明。能力边界及适用限制较少，因而未给高分。
README按介绍、安装、运行、配置、集成和贡献组织内容，提供可操作的安装说明、命令示例和独立Discord文档指引。MIT许可证文本完整；但样本未见版本历史或变更日志，维护责任也只笼统说明贡献与PR审阅，得分相应扣减。
README说明世界中Agent协作及状态查看方式，并给出降低模型调用成本的turbo选项，输出可观察性和潜在价值有依据。但没有量化效果或完整成本说明，成本收益仅有有限描述。
功能与运行主张可在README和main.py、pyproject.toml中部分对应，CI文件只支持setup脚本跨系统运行这一有限事实。未提供Agent结果验证证据；评分反映静态材料的可追溯性有限，并区分了描述性主张与实际验证。
- 运行需要配置API密钥并会启动世界、Discord监听器和本地Web服务器；静态材料未说明密钥保护及这些组件的详细数据处理方式。
- 所示CI只运行setup.py，不能据此确认Agent运行结果、稳定性或可重复性。
你是这个项目的维护者？把 FARS 徽章加到 README
[](https://followagents.com/zh/agents/gpteam)<a href="https://followagents.com/zh/agents/gpteam"><img src="https://followagents.com/badge/gpteam.svg?lang=zh" alt="FARS 评测"></a>常见问题
运行 GPTeam 必须提供什么凭据？
.env。可选服务的 API key 会启用其他工具。怎样降低运行成本？
poetry run world --turbo，它会使用 gpt3.5-turbo 完成所有 LLM 调用，但文档提示结果会更差。如何查看智能体正在做什么？
agents/ 目录；其中每个智能体都有一个包含当前状态摘要的 txt 文件。能否使用 Claude？
ANTHROPIC_API_KEY 后运行 poetry run world --claude；文档说明它会对部分调用使用 claude-v1，对另一些调用使用 claude-v1-instant。修改 agents 或 locations 后需要做什么？
config.json 后运行 poetry run db-reset，再重新运行 world。谢谢反馈，我们会据此改进页面。