游戏 AI / 系统课时

模型输出格式突然失效怎么办

模型输出格式突然失效怎么办

结构化输出一旦从 JSON 变成缺字段、类型错误或非法动作,最危险的做法是直接执行。可靠处理链应先解析,再做结构校验与业务校验;失败后只重试可恢复的问题,最终仍失败就进入受控降级,而不是把坏数据写进剧情状态。

学习目标

  • 能区分 JSON 解析失败、字段缺失和业务参数非法三类错误。
  • 能建立“解析 → Schema 校验 → 业务规则校验 → 重试/降级”的执行门。
  • 能让非法动作在进入游戏状态机前被拒绝并记录原因。

先区分三种失败

语法失败包括残缺 JSON 或带自然语言前缀。结构失败包括缺字段、错误类型或未允许的动作形状。业务失败则是格式合法,但权限、场景、目标位置或版本不允许。业务失败走确定性降级,避免擅自修改坐标或请求目标。

结构化输出失败后的校验与降级链路

把校验门写成可执行规则

保存为 output_gate.py,运行 python output_gate.py。例子只允许带整数坐标的 move_to,限制返回体积,拒绝重复键以及 Python JSON 解码器默认接受的 NaN、Infinity 等扩展。每个请求最多生成两次,只对解析和结构错误提供一次受控修正机会。真实调用还应受同一请求的剩余时限和费用限制。Python json · RFC 8259

python
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))
text
('candidate_ready', (40, 75), 2)
('rule_denied', None, 1)
('parse_error', None, 2)

重试提示只附受控原因码。供应商拒答、传输失败、超时和中断由调用层分类处理。候选就绪后还需在实际提交时比较版本和前置条件。动作被拒绝时,由程序从权威状态选择回应,不展示会让玩家误认为动作已完成的候选文案。

不要让修复逻辑越过权威状态

模型可以建议 action,但不能因为格式正确就获得写入权。执行前仍需检查当前 questState、角色权限、目标实体存在性以及重复执行条件。即使 JSON 完全符合 Schema,只要当前状态不允许该动作,也必须拒绝。

当所有校验通过后才进入执行器;当重试耗尽后,使用明确且可预测的本地回复或安全动作,例如保持当前位置、结束本轮对话或转人工脚本。这样“格式失效”不会进一步演化成剧情状态污染。

用故障样例做回归验证

回归覆盖非法 JSON、缺字段、重复键、布尔坐标、越界、无权限、状态版本变化以及重试耗尽。断言解析失败和拒绝时都不产生可提交动作,且业务拒绝不会触发第二次模型调用。下一课将用请求日志复现一次失败。

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

目录与阅读设置

阅读设置

17

记录一个想法

模型输出格式突然失效怎么办

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

登录哪都通