游戏 AI / 系统课时
模型输出格式突然失效怎么办
模型输出格式突然失效怎么办
结构化输出一旦从 JSON 变成缺字段、类型错误或非法动作,最危险的做法是直接执行。可靠处理链应先解析,再做结构校验与业务校验;失败后只重试可恢复的问题,最终仍失败就进入受控降级,而不是把坏数据写进剧情状态。
学习目标
- 能区分 JSON 解析失败、字段缺失和业务参数非法三类错误。
- 能建立“解析 → Schema 校验 → 业务规则校验 → 重试/降级”的执行门。
- 能让非法动作在进入游戏状态机前被拒绝并记录原因。
先区分三种失败
语法失败包括残缺 JSON 或带自然语言前缀。结构失败包括缺字段、错误类型或未允许的动作形状。业务失败则是格式合法,但权限、场景、目标位置或版本不允许。业务失败走确定性降级,避免擅自修改坐标或请求目标。

把校验门写成可执行规则
保存为 output_gate.py,运行 python output_gate.py。例子只允许带整数坐标的 move_to,限制返回体积,拒绝重复键以及 Python JSON 解码器默认接受的 NaN、Infinity 等扩展。每个请求最多生成两次,只对解析和结构错误提供一次受控修正机会。真实调用还应受同一请求的剩余时限和费用限制。Python json · RFC 8259
import json
class InvalidOutput(ValueError):
pass
def strict_object(pairs):
result = {}
for name, value in pairs:
if name in result:
raise InvalidOutput("duplicate_key")
result[name] = value
return result
def reject_constant(_):
raise InvalidOutput("nonfinite_number")
def parse(raw):
if not isinstance(raw, bytes) or len(raw) > 4096:
raise InvalidOutput("invalid_size")
try:
payload = json.loads(raw.decode("utf-8"), object_pairs_hook=strict_object,
parse_constant=reject_constant)
except (UnicodeError, json.JSONDecodeError, RecursionError) as error:
raise InvalidOutput("parse_error") from error
if not isinstance(payload, dict) or set(payload) != {"dialogue", "action"}:
raise InvalidOutput("schema_error")
if not isinstance(payload["dialogue"], str) or not 1 <= len(payload["dialogue"].strip()) <= 280:
raise InvalidOutput("schema_error")
action = payload["action"]
if (not isinstance(action, dict) or set(action) != {"type", "x", "y"}
or action["type"] != "move_to"
or type(action["x"]) is not int or type(action["y"]) is not int):
raise InvalidOutput("schema_error")
return action["x"], action["y"]
def prepare(generate, read_state, expected_version):
reason = None
for attempt in range(1, 3):
try:
target = parse(generate(reason))
except InvalidOutput as error:
reason = str(error)
continue
state = read_state()
if state["version"] != expected_version:
return "stale_state", None, attempt
if not state["movement_allowed"] or target not in state["allowed_tiles"]:
return "rule_denied", None, attempt
return "candidate_ready", target, attempt
return reason, None, 2
if __name__ == "__main__":
invalid = b"{"
valid = b'{"dialogue":"I can move.","action":{"type":"move_to","x":40,"y":75}}'
denied = valid.replace(b"75", b"999")
state = {"version": 7, "movement_allowed": True, "allowed_tiles": {(40, 75)}}
for samples in ((invalid, valid), (denied,), (invalid, invalid)):
replies = iter(samples)
print(prepare(lambda reason: next(replies), lambda: state, 7))('candidate_ready', (40, 75), 2)
('rule_denied', None, 1)
('parse_error', None, 2)重试提示只附受控原因码。供应商拒答、传输失败、超时和中断由调用层分类处理。候选就绪后还需在实际提交时比较版本和前置条件。动作被拒绝时,由程序从权威状态选择回应,不展示会让玩家误认为动作已完成的候选文案。
不要让修复逻辑越过权威状态
模型可以建议 action,但不能因为格式正确就获得写入权。执行前仍需检查当前 questState、角色权限、目标实体存在性以及重复执行条件。即使 JSON 完全符合 Schema,只要当前状态不允许该动作,也必须拒绝。
当所有校验通过后才进入执行器;当重试耗尽后,使用明确且可预测的本地回复或安全动作,例如保持当前位置、结束本轮对话或转人工脚本。这样“格式失效”不会进一步演化成剧情状态污染。
用故障样例做回归验证
回归覆盖非法 JSON、缺字段、重复键、布尔坐标、越界、无权限、状态版本变化以及重试耗尽。断言解析失败和拒绝时都不产生可提交动作,且业务拒绝不会触发第二次模型调用。下一课将用请求日志复现一次失败。