游戏 AI / 系统课时
用结构化输出表示剧情动作
用结构化输出表示剧情动作
这一课把自由文本生成改造成游戏代码可执行的结构化结果。核心目标不是让模型写得更像程序,而是让输出字段、类型和允许动作都足够明确,使解析、校验、执行和日志记录可以形成稳定链路。
学习目标
- 设计包含对白、意图和候选事件的最小输出结构
- 在游戏代码中先解析和校验,再执行剧情动作
- 用允许值和字段约束限制模型输出越权状态
为什么不要直接解析自然语言
如果模型只返回一句“商人同意让玩家通过”,游戏代码还需要从自然语言中猜测意图、参数和事件类型。不同措辞可能表达同一动作,模型偶尔还会把解释文字混进结果,导致执行逻辑不稳定。
运行时可以约定固定字段。dialogue 保存候选对白,intent 表示角色交流意图,action 表示一项可选动作。动作使用明确的类型,参数按类型定义。游戏服务拥有动作执行的最终决定权。

先定义允许的输出边界
本章协议只允许 greet、request-proof、offer-help 三种意图。action 必须显式出现,可以为 null,也可以是只有 type: "open-gate" 的对象。这个动作只允许与 offer-help 搭配。门、玩家和任务由当前已认证场景决定,模型既不传目标阶段,也不传权限、前置条件和版本。若接入 JSON Schema,每层对象需要同时声明必填字段并禁止额外属性。JSON Schema 对象约束
运行结构校验与业务校验
把以下代码保存为 story_protocol.mjs,与上一节的 gate_rules.mjs 放在同一目录。示例只用 Node.js 内置接口。JSON 解析成功后仍需检查顶层类型、字段、长度和动作形状。通过结构校验的动作才交给游戏规则。
import { pathToFileURL } from "node:url";
import { applyGate } from "./gate_rules.mjs";
const intents = new Set(["greet", "request-proof", "offer-help"]);
function exactKeys(value, keys) {
return value !== null && typeof value === "object" && !Array.isArray(value)
&& Object.keys(value).length === keys.length
&& keys.every((key) => Object.hasOwn(value, key));
}
export function parseStory(rawText) {
if (typeof rawText !== "string" || Buffer.byteLength(rawText, "utf8") > 4096) {
throw new Error("invalid-size");
}
const result = JSON.parse(rawText);
if (!exactKeys(result, ["dialogue", "intent", "action"])) {
throw new Error("invalid-result");
}
if (typeof result.dialogue !== "string" || !result.dialogue.trim() || result.dialogue.length > 280) {
throw new Error("invalid-dialogue");
}
if (!intents.has(result.intent)) {
throw new Error("invalid-intent");
}
const action = result.action;
if (action !== null && (
!exactKeys(action, ["type"]) || action.type !== "open-gate" || result.intent !== "offer-help"
)) {
throw new Error("invalid-action");
}
return result;
}
if (process.argv[1] && pathToFileURL(process.argv[1]).href === import.meta.url) {
const raw = '{"dialogue":"我可以帮你开门。","intent":"offer-help","action":{"type":"open-gate"}}';
const result = parseStory(raw);
const state = { stateVersion: 7, questStage: "meet-merchant", gateUnlocked: false };
console.log(applyGate(state, 7, result.action).outcome);
try {
parseStory(raw.replace('"open-gate"', '"open-gate","questStage":"complete"'));
} catch (error) {
console.log(error.message);
}
}node story_protocol.mjsmissing-prerequisite
invalid-action标准 JSON.parse 对重复对象键使用后出现的值,示例的结构检查发生在解析后。若同一原始载荷会由多个系统解析,统一解析入口和重复键策略。生产中可拒绝重复键,并只将已验证的对象交给执行层。服务商提供的结构约束可改善模型输出,但业务规则仍需独立验证。ECMAScript JSON.parse
让输出便于记录和重放
日志保留请求 ID、协议版本、动作类型、校验结果与状态版本。只有明确需要且在允许保留范围内才保存模型文本。重放校验时把候选与原快照配对;实际执行应重新经过当前状态与幂等检查。下一节将根据权威结果选择玩家看到的对白。