快速开始

SillyStage 是一个用于 AI 交互叙事的多 agent 系统。你可以把它理解为一个可运行的叙事引擎：你提供角色、设定、故事资源和模型配置，系统会在一次次会话回合中组织规划、导演、表演、旁白和状态更新。

这篇文档的目标为跑通一次示例：启动服务，完成基础配置，创建一个故事，进入会话，并执行第一轮交互。

1. 安装并启动

准备一个可用的LLM API，之后进行配置（暂时只支持OpenAI兼容）:

配置预设

预设用于配置Agent的一系列参数，比如请求的temperature，提示词等。

进入预设页面，点击右上角的魔法棒按钮（创建样例预设）来创建一个基本预设。
（可选）配置状态结构

状态结构用于声明某个故事有哪些变量，变量的作用和类型，驱动剧情的跳转以及为Agent的响应提供参考。

进入状态结构页面，同样点击右上角魔法棒按钮来创建样例状态结构。
（可选）配置世界书

世界书（Lorebook）用于为故事背景提供更多细节描述，例如场景、历史和设定。可以辅助角色行为、对话，使故事更加连贯和真实。

进入世界书页面，点击右上角魔法棒按钮（创建样例世界书）来生成一个基础的世界书配置。
（可选）配置玩家档案

玩家档案用于为玩家角色提供更多的细节。

同样可以创建样例玩家档案，不再赘述。
添加角色卡

角色卡是故事的基本组成之一，用于描述某个角色的设定，例如角色的性格特点、背景故事和特定台词等。

样例提供了三张角色卡，按照自己的需要去添加。

故事资源是用于生成故事的重要部分，一个故事资源可以生成多个故事。

进入故事资源页面，之后点击右上角创建按钮来进入故事的创建向导。

输入原始剧情输入

原始剧情输入用于为规划师Agent提供一个剧本参考，来生成能够让架构师Agent更好生成故事图的剧本。

或者说你不想要让规划师来帮你规划剧本，那么这里输入完整剧本即可。
选择角色卡

选择参与故事的角色，按照你想要的来选择即可。
（可选）设定初始状态结构与世界书

配置初始状态结构和世界书为选择性步骤，可增强故事背景和运行逻辑。

初始状态结构用于为架构师Agent提供一个变量参考，让生成出来的状态结构更符合要求。
整理剧情

如果你需要规划师来帮你整理剧情，可以选择创建后交给规划师整理，反之选择先只保存原始输入。

这里建议选择规划师整理，这样生成的故事或许会更好（？）

进入故事页面，点击右上角创建按钮开始创建故事的流程。

故事可以手动创建或者是从资源生成，这里只介绍如何从资源生成。

选择API组，预设和故事名称
（可选）设定常用变量

常用变量会在舞台页面右侧栏中常驻显示，方便查看
进入故事生成流程

故事生成流程较慢，请耐心等待，且中途可能会发生错误，发生错误的概率取决于你使用的LLM。

如果发生了错误，你可以进去草稿页面，点击继续生成来继续中断的流程。

切换到舞台页面，点击左侧栏的新建按钮来创建新会话，选择配置后即可开始对话流程。