AI 剧情游戏 Agent 实战(中一):Workspace、Skills 与主 Agent
《Agent 大模型 0 到 1 系统课》 · 程序员 Sunday
你正在阅读本节的免费试读。完整课程 ¥499,可在文末添加作者微信购买。
上一小节,咱们已经把 AI 互动剧情游戏制作 Agent 运行起来了。
用户填写故事要求,点击“开始制作”,系统就会陆续设计世界观、人物和剧情大纲。制作过程中,页面还能看到角色的执行记录,以及它们保存下来的文件。
那么,这些角色是怎样启动的?它们去哪里读取用户要求,又怎么知道应该按照哪个 Skill 工作呢?
这一小节,咱们就从“开始制作”按钮进入代码,一直追到总导演发出第一份角色任务。
从点击“开始制作”开始
在页面点击“新建作品”,选择 AI 模式,填写故事要求(还是用太空站的这个就行),再点击表单中的“开始制作”。
按钮会执行 App.vue 中的 create() ,关键代码是:
const created = await request<Project>('', {
method: 'POST',
body: JSON.stringify(draft.value)
})
showCreate.value = false
await selectProject(created.id)
这里的 draft.value 就是用户正在填写的表单。里面保存了故事名称、故事设定、世界规则、角色数量、场景数量和运行模式等信息。
接口会请求到:
POST /api/projects
这个请求进入 story.controller.ts 的 `StoryController.create() 方法:
Controller 把表单数据交给了 this.stories.create()。这里的 stories 就是 StoryService,所以接下来打开 story.service.ts,找到 create() 方法。
方法一开始,先校验制作要求,再生成项目 ID:
// 校验并解析输入;不符合 Schema 的数据会直接抛出异常。
const brief = BriefSchema.parse(input)
// 中间还有 Replay 预设要求的校验,这里先跟踪 AI 分支。
const id = randomUUID()
brief 表示校验后的制作要求。比如角色数量、场景数量是否在项目支持的范围内,都会在这里检查。
接着,代码创建 project 对象,这个对象属性特别多,放的主要是用户填写的制作。后面再启动 Agent,根据这些要求生成世界观、人物和剧情大纲。
咱们这里只看与当前流程有关的字段,大致可以简化成这样:
const project = {
id, // 本次作品的唯一 ID
revision: 1, // 从第一版制作内容开始
mode: brief.mode, // 当前是 ai
brief, // 用户提交的制作要求
status: 'queued', // 等待启动
world: null,
characters: null,
outline: null,
tasks: []
}
继续往下看,create() 最后的调用顺序是:
// 根据项目 ID、初始版本和制作要求,准备工作区。
await this.workspace.prepare(id, 1, brief)
// 保存项目初始记录,确保后续制作流程可以读取项目。
await this.repo.create(project)
// 发送创建事件,说明本次使用的是预设演示还是 AI 真实制作。
await this.emit(id, 'created', `${brief.mode === 'replay' ? 'Replay 预设演示' : 'AI 真实制作'}已开始`)
// 将制作流程安排到后续事件循环执行,不在这里等待制作完成。本节试读已结束
继续学习,解锁完整课程
购买《Agent 大模型 0 到 1 系统课》,
继续阅读本节剩余内容与后续课程。