如何快速搭建WorldSeed：10分钟从零运行你的第一个AI多智能体世界完整教程

• 人工智能
• AI Agent
• 多智能体
• Agent 编排
• 后端
• 前端
• 自主智能体

只要10分钟，你就可以在本地跑起来一个属于自己的AI 多智能体世界。WorldSeed 是一个开源的 AI 多智能体世界引擎（multi-agent world engine）：AI Agent 们在同一个世界里生活、交谈、竞争、结盟，并产生意想不到的涌现行为。这篇 WorldSeed 搭建教程将从零带你完成全部配置，新手也能轻松上手。

WorldSeed 是什么？为什么值得试试？

WorldSeed 的核心理念只有一句话：

规则 + 不同的 Agent + 后果 → 涌现

你不需要手写一个死板的流程，只需要用一份 YAML 文件描述角色、规则、每个角色能"看到"什么、能做什么、后果是什么。剩下的交给引擎：AI Agent 们会按"世界钟声"（tick）一步步行动，同一间屋子里的三个角色，脑子里装着三幅完全不同的图景。

同一个引擎可以运行完全不同的世界——谍战茶馆、裁员办公室、AI 研究实验室……换一份 YAML，就是换一个人间。

开始前的环境准备（3分钟清单）

WorldSeed 的后端是 Python，前端是 React 仪表板，准备工作如下：

💡 任何 LiteLLM 支持的模型都能当 DM，包括 OpenAI、Anthropic、Gemini，甚至本地 Ollama，只需要在.env里配置一个 Key 即可（详见 .env.example）。

WorldSeed 快速安装：5步完成部署

第一步：克隆仓库

git clone https://gitcode.com/gh_mirrors/wo/WorldSeed cd WorldSeed

第二步：安装后端依赖

uv sync --extra dm

--extra dm会额外安装 DM（AI 裁判）所需的litellm依赖，这一步不能省略。

第三步：构建 Web 前端

cd frontend && npm install && npm run build && cd ..

前端代码位于 frontend/，构建产物会被后端服务直接托管，无需单独部署。

第四步：配置 API Key

cp .env.example .env

打开.env，把你手里的 Key 填进去（三选一，取消对应注释）：

OPENAI_API_KEY=sk-... # ANTHROPIC_API_KEY=sk-ant-... # GEMINI_API_KEY=...

可选：指定默认 DM 模型，会显示在大厅下拉框中：

WORLDSEED_DM_MODEL=你的模型名

第五步：启动你的世界

仓库内置了两个完整场景，推荐新手先跑ai_layoffs（AI 裁员办公室）：

uv seed play configs/ai_layoffs.yaml

即：

uv run worldseed play configs/ai_layoffs.yaml

看到服务启动日志后，浏览器打开http://localhost:8000——你的 AI 多智能体世界已经运转起来了 🎉

第一次进入世界：你会看到什么？

启动后 WorldSeed 会自动渲染两张"名片"：

世界简报（Briefing）——从 YAML 配置自动生成的房间卡片和场景概述，帮你快速建立世界观：

角色入场（Cast）——每位 Agent 的肖像、身份、性格、目标，甚至秘密，都可以逐页翻看：

与多智能体世界互动的3种玩法

WorldSeed 仪表板提供了三种体验模式，同一份世界可以反复玩出不同花样：

1. 👀 旁观（Watch）：上帝视角俯瞰全场，包括每个 Agent 的内心状态和私语。
2. 🗣️ 介入（Intervene）：私下对任意 Agent 耳语，悄悄推一把剧情走向。
3. 🎭 扮演（Play）：化身其中一位角色，以第一视角和 AI 共处同一个世界。

还有一个隐藏福利：每次运行都是不同的。所有历史局都会完整保留，随时可以打开"编年史"回放，查看时间轴上每个 tick 的决策、对话与后果：

从零创建你的世界

内置场景玩腻了？WorldSeed 是场景无关的（scene-agnostic），换个 YAML 就是新世界：

# 先校验配置是否正确 uv run worldseed validate configs/my_scene.yaml # 验证通过，直接开跑 uv run worldseed play configs/my_scene.yaml

• 完整配置规范：configs/SCENE_CONFIG.md
• 规则 DSL 参考：configs/SCENE_DSL.md
• 想看一个真实场景怎么写，打开 configs/teahouse.yaml 或 configs/ai_layoffs.yaml 照着模仿即可
• 也可以把想法写成一句话 prompt，用create-world技能让 AI 直接生成整套 YAML（含 UI 配置），见 skills/create-world/

常用命令速查表

更多参数详见 src/worldseed/cli/play.py；中文文档入口是 docs/README.zh-CN.md，想深入了解引擎原理可以读 docs/ARCHITECTURE.md。

写在最后

从git clone到打开仪表板，整个流程不到 10 分钟。你现在拥有的不只是几个演示场景，而是一台"世界生成器"——定义角色、规则和后果，然后退后一步，看 AI 多智能体自己活出一个世界。

去种下你的第一颗世界的种子吧 🌱

• 人工智能
• AI Agent
• 多智能体
• Agent 编排
• 后端
• 前端
• 自主智能体