Sunday面试指南

AI 剧情游戏 Agent 实战(中二):Subagent 任务委派

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

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

上一小节,咱们从“开始制作”按钮进入代码,跟到了总导演把任务交给世界观设计师。

世界观设计师拿到任务单以后,就可以读取制作要求,设计世界规则和人物,再把结果写进文件。

那么,这些文件写好以后,剧情策划怎么接着工作?大纲通过审核以后,场景编剧又该写哪些内容?

这一小节,咱们继续跟踪同一部作品,把世界观、人物、大纲和场景的制作过程串起来。

世界观和人物写好以后,程序怎样接收

先接着上一节的世界观任务往下看。

目前已知,world-designer 同时负责世界观和人物档案。

世界观设计师按照任务要求调用文件工具,把生成的 JSON 写到两个位置。

  • world.json 保存世界规则
  • characters.json 保存人物的姓名、目标和动机。

角色执行结束以后,agents.ts 中的 director.invoke() 返回。

runAI() 随后检查是否发起过委派、是否发起过指定 Skill 的读取,以及交付文件是否存在。

检查通过,runAI() 和调用它的 execute() 才会结束。

接下来,代码会回到哪里呢?

回到 story.service.ts 的 task() 方法。上一节就是它通过 await this.agents.execute(...) 启动了这次 Agent 执行。

AI 剧情游戏 Agent 实战(中二):Subagent 任务委派 配图 1

找到这行调用,继续往下看,接收文件的代码就在后面。

task() 会按照任务单里的交付路径,读取角色刚写好的 JSON:

// 读取任务交付文件并解析为 JSON 对象。
const values = await Promise.all(
  assignment.writeFiles.map((path) =>
    this.workspace.readJson(project.id, path)
  )
)
// 调用 validate 回调函数对产物进行校验,返回解析后的结果。
const result = validate(values)

这里的 values 是读取结果组成的数组,顺序和 writeFiles 一致,我在这里打印了 values 的数据,大家可以看下:

AI 剧情游戏 Agent 实战(中二):Subagent 任务委派 配图 2

这里包含了两个元素对象

  • 第一个元素对象是 世界观对象:来自 world.json,包含世界观标题 title、背景介绍 summary 和世界规则 rules。
  • 第二个元素对象是 人物档案对象:来自 characters.json,其中的 characters 数组保存了各个人物的档案。

那么下一行的 validate() 从哪里来?

它是调用 task() 时传入的校验函数。回到同一个文件的 prepareWorld(),找到 const [world, characters] = await this.task(...),完整调用是:

// 将任务交给 task 执行,并指定预期产物路径和解析校验回调。
const [world, characters] = await this.task(
  project,
  assignment,
  [`${base}/world.json`, `${base}/characters.json`],
  // validate 就是这个,作用是:分别校验世界观和人物档案;任一产物不符合 Schema 时抛出异常。
  ([rawWorld, rawCharacters]) =>
    [
      WorldSchema.parse(rawWorld),
      CharactersSchema.parse(rawCharacters)
    ] as const
)

第四个参数就是刚才的 validate。它把数组里的两个对象分别交给 WorldSchema 和 CharactersSchema 检查。

这两个 Schema 定义在 contracts.ts 中。

// 世界观数据结构:用于约束 Agent 最终生成的世界观内容。
export const WorldSchema = z
	.object({
		// 世界观标题,至少 2 个字符。
		title: z.string().min(2),
		// 世界观概要,避免生成过于简单的描述。
		summary: z.string().min(20),
		// 世界规则,要求 2~8 条,每条规则至少 8 个字符。
		rules: z.array(z.string().min(8)).min(2).max(8)
	})
	.strict()

// 单个角色的数据结构。

本节试读已结束

继续学习,解锁完整课程

购买《Agent 大模型 0 到 1 系统课》,
继续阅读本节剩余内容与后续课程。

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

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

解锁完整课程 ¥499

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

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

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

保存微信二维码