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 执行。
找到这行调用,继续往下看,接收文件的代码就在后面。
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 的数据,大家可以看下:
这里包含了两个元素对象
- 第一个元素对象是 世界观对象:来自
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 系统课》,
继续阅读本节剩余内容与后续课程。