Sunday面试指南

AI 剧情游戏 Agent 实战(中一):Workspace、Skills 与主 Agent

《Agent 大模型 0 到 1 系统课》 · 程序员 Sunday

你正在阅读本节的免费试读。完整课程 ¥499,可在文末添加作者微信购买。

上一小节,咱们已经把 AI 互动剧情游戏制作 Agent 运行起来了。

用户填写故事要求,点击“开始制作”,系统就会陆续设计世界观、人物和剧情大纲。制作过程中,页面还能看到角色的执行记录,以及它们保存下来的文件。

那么,这些角色是怎样启动的?它们去哪里读取用户要求,又怎么知道应该按照哪个 Skill 工作呢?

这一小节,咱们就从“开始制作”按钮进入代码,一直追到总导演发出第一份角色任务。

从点击“开始制作”开始

在页面点击“新建作品”,选择 AI 模式,填写故事要求(还是用太空站的这个就行),再点击表单中的“开始制作”。

AI 剧情游戏 Agent 实战(中一):Workspace、Skills 与主 Agent 配图 1

按钮会执行 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() 方法:

AI 剧情游戏 Agent 实战(中一):Workspace、Skills 与主 Agent 配图 2

Controller 把表单数据交给了 this.stories.create()。这里的 stories 就是 StoryService,所以接下来打开 story.service.ts,找到 create() 方法。

AI 剧情游戏 Agent 实战(中一):Workspace、Skills 与主 Agent 配图 3

方法一开始,先校验制作要求,再生成项目 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 系统课》,
继续阅读本节剩余内容与后续课程。

扫码添加作者微信,备注「Agent 课程」

添加作者微信 · 购买完整课程

解锁完整课程 ¥499

《Agent 大模型 0 到 1 系统课》
扫码添加微信,备注「Agent 课程」,购买后由 Sunday 提供完整内容的学习方式。

扫码添加作者微信 LGD_Sunday,购买 499 元 Agent 课程

微信昵称:LGD_Sunday
手机上可长按保存二维码,再用微信扫一扫识别。

保存微信二维码