游戏 AI / 系统课时
为模型不可用准备降级路径
为模型不可用准备降级路径
当 NPC 对话遇到超时、限流、断网或无效模型输出时,玩家不应一直停留在“思考中”,更不能因为回退台词而自动完成任务。本课让请求在规定时间内成功显示或进入固定降级界面,并通过安全选项和重试入口保持对话可退出、剧情可恢复。
学习目标
- 为在线故障与离线状态分别设计固定台词、选项和可用操作。
- 实现有超时上限和响应校验的异步回退逻辑。
- 处理重试冷却、过期回包与权威任务状态,避免重复执行剧情动作。
先规定故障时保留哪些能力
游戏后端应控制选项和任务操作,模型只负责提供经校验的台词。在线时,即使模型不可用,仍可从游戏服务读取已确认的任务记录;离线时无法验证任务进度,就只能显示说明和退出入口,不能发放奖励或提交完成状态。
- 请求超时、连接异常、模型服务错误:结束本轮等待,显示固定台词与“查看任务记录”“结束对话”。
- 限流或额度不足:立即走降级,不自动连续重试;恢复入口服从服务端冷却时间。
- 结构化响应缺字段、含无效意图:拒绝执行模型建议的动作,改用固定选项。
- 客户端断网:显示离线提示,隐藏需要服务器授权的任务操作。
例如把交互等待上限设为 1.5 秒,超时后显示“我暂时无法回答,你可以查看任务记录”。这只是产品体验预算,实际阈值应结合设备网络与后端延迟分布调整。
用明确的状态阻止故障卡住界面
对话可以从 Idle 进入 Requesting,收到合法文本后到 Showing;超时、限流或校验失败则到 Degraded。玩家退出时返回 Idle,新的请求才允许再次进入 Requesting。

每次发送都分配 requestId 和递增的 generation。关闭窗口、切换 NPC 或主动重试后,旧请求即使迟到也不能覆盖当前台词。客户端取消仅停止本地等待;后端仍须用请求幂等标识与授权检查防止重复剧情提交。
用异步超时和固定选项实现最小回退
以下 Python 3.10+ 示例用协程模拟模型返回。测试超时设为 0.01 秒、慢请求设为 0.05 秒,便于立即看到降级;生产应使用实测等待预算。quest_active 在真实项目中必须来自服务端权威任务快照,不能相信客户端传入的布尔值。
import asyncio
def fixed_options(quest_active, retry):
items = ["查看任务记录"] if quest_active else []
if retry:
items.append("重新询问")
return items + ["结束对话"]
async def mock_model(case):
if case == "slow":
await asyncio.sleep(0.05)
if case == "error":
raise ConnectionError("模型服务不可用")
if case == "invalid":
return {"line": ""}
return {"line": "去北门请沿着河岸往前走。"}
async def answer(case, *, online, quest_active):
if not online:
return "FALLBACK", "目前离线,无法确认任务状态。", ["结束对话"]
try:
# 在后端为单轮模型调用设置截止时间。
data = await asyncio.wait_for(mock_model(case), timeout=0.01)
line = data.get("line") if isinstance(data, dict) else None
if not isinstance(line, str) or not line.strip():
raise ValueError("无效台词")
return "MODEL", line, fixed_options(quest_active, False)
except (TimeoutError, ConnectionError, ValueError):
return "FALLBACK", "我暂时无法回答,你可以查看任务记录。", fixed_options(quest_active, True)
async def main():
for case, online in [
("ok", True), ("slow", True), ("error", True),
("invalid", True), ("ok", False),
]:
mode, line, choices = await answer(
case, online=online, quest_active=True
)
print(f"{case}: {mode} | {line} | {', '.join(choices)}")
asyncio.run(main())预期输出:
ok: MODEL | 去北门请沿着河岸往前走。 | 查看任务记录, 结束对话
slow: FALLBACK | 我暂时无法回答,你可以查看任务记录。 | 查看任务记录, 重新询问, 结束对话
error: FALLBACK | 我暂时无法回答,你可以查看任务记录。 | 查看任务记录, 重新询问, 结束对话
invalid: FALLBACK | 我暂时无法回答,你可以查看任务记录。 | 查看任务记录, 重新询问, 结束对话
ok: FALLBACK | 目前离线,无法确认任务状态。 | 结束对话示例只校验台词存在,实际还应验证结构化字段、内容限制和业务授权。出现 HTTP 429 时,“重新询问”可继续显示,但应由后端决定何时解锁;若服务返回明确的重试等待信息,应遵守该等待时间。
让玩家恢复而不重复推进任务
回退界面应保留玩家已输入的问题与当前 NPC 标识,允许网络恢复后重新询问,但不能自动重复任何写操作。重新请求前重新读取任务版本;若玩家已完成任务,就应移除旧选项。固定选项携带受控动作标识,由服务端再校验其前置条件,而不是把模型生成的 intent 直接执行。
最少覆盖五种验收:正常回复、超时、服务错误、非法响应、离线;另加“关闭对话后旧回复抵达”的竞态测试。记录降级原因、等待时长、重试次数和丢弃的过期回包数,日志只保留必要的请求标识与状态,不记录密钥或完整私人对话。降级完成的判据是玩家仍能退出、查看可信信息,并且故障期间没有任何未经授权的剧情状态变化。