游戏 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 解析成功后仍需检查顶层类型、字段、长度和动作形状。通过结构校验的动作才交给游戏规则。

js
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);
  }
}
bash
node story_protocol.mjs
text
missing-prerequisite
invalid-action

标准 JSON.parse 对重复对象键使用后出现的值,示例的结构检查发生在解析后。若同一原始载荷会由多个系统解析,统一解析入口和重复键策略。生产中可拒绝重复键,并只将已验证的对象交给执行层。服务商提供的结构约束可改善模型输出,但业务规则仍需独立验证。ECMAScript JSON.parse

让输出便于记录和重放

日志保留请求 ID、协议版本、动作类型、校验结果与状态版本。只有明确需要且在允许保留范围内才保存模型文本。重放校验时把候选与原快照配对;实际执行应重新经过当前状态与幂等检查。下一节将根据权威结果选择玩家看到的对白。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

用结构化输出表示剧情动作

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通