游戏 AI / 系统课时
从游戏代码发起第一次模型请求
从游戏代码发起第一次模型请求
本篇从一个最小可运行链路开始:游戏代码准备提示词,调用大模型 HTTP API,读取模型响应,并对失败情况进行处理。完成后你可以把它直接作为后续游戏生成系统的调用基础。
学习目标
- 从游戏代码发起一次标准模型 API 请求
- 正确处理请求成功、HTTP 错误和网络异常
- 将模型响应转换为游戏逻辑可以继续处理的文本
先把模型调用缩成一条链路
最小生成链路可以拆成四步:准备输入、发送 HTTP 请求、解析响应、处理错误。第一版不要急着加入上下文记忆、工具调用或复杂状态机,先确保游戏代码能够稳定拿到一次可用的文本结果。
下面使用 Python 标准库发起 HTTPS 请求,接口采用 OpenAI 兼容的 Chat Completions 形式。示例通过环境变量提供密钥,避免把凭据硬编码进游戏源码。实际使用时,OPENAI_BASE_URL 和模型名应替换为你所接入服务实际提供的地址与名称。
发起第一次请求
先设置两个环境变量:OPENAI_API_KEY 保存 API 密钥,OPENAI_BASE_URL 保存兼容服务的基础地址,例如服务要求的 https://api.example.com/v1。下面的代码把基础地址与 /chat/completions 拼接成请求地址。
import json
import os
import urllib.error
import urllib.request
API_KEY = os.environ["OPENAI_API_KEY"]
BASE_URL = os.environ["OPENAI_BASE_URL"].rstrip("/")
MODEL = os.environ.get("OPENAI_MODEL", "<MODEL>")
payload = {
"model": MODEL,
"messages": [
{"role": "system", "content": "你是游戏 NPC 文案助手。"},
{"role": "user", "content": "为铁匠 NPC 写一句欢迎玩家的台词。"},
],
}
request = urllib.request.Request(
f"{BASE_URL}/chat/completions",
data=json.dumps(payload).encode("utf-8"),
headers={
"Authorization": f"Bearer {API_KEY}",
"Content-Type": "application/json",
},
method="POST",
)
try:
with urllib.request.urlopen(request, timeout=30) as response:
result = json.load(response)
text = result["choices"][0]["message"]["content"]
print(text)
except urllib.error.HTTPError as exc:
print(f"HTTP error: {exc.code}")
print(exc.read().decode("utf-8", errors="replace"))
except urllib.error.URLError as exc:
print(f"Network error: {exc.reason}")
except (KeyError, IndexError, json.JSONDecodeError) as exc:
print(f"Response format error: {exc}")预期输出
铁砧旁已经备好火候了,想打造什么装备就拿过来吧。实际生成文本会因模型、提示词和服务配置不同而变化,因此这里的输出只表示“成功从响应中取出文本”,不要求逐字一致。
处理成功与失败
成功并不只意味着 HTTP 请求返回了 200。游戏代码还需要确认响应结构存在目标字段,并把模型文本与错误处理分开。上面的示例将 HTTP 错误、网络错误和响应结构错误分别处理,这样日志能更快定位问题。
开发阶段尤其要关注 API 密钥是否缺失、基础地址是否写错、模型名称是否有效,以及服务是否真的支持 /chat/completions。不同供应商虽然可能兼容同一套接口风格,但可用模型、限流策略和响应字段仍应以实际服务文档为准。
让模型调用进入游戏逻辑
拿到 text 后,不要立刻把模型输出当成可信游戏状态。对于 NPC 台词,可以先做长度和内容校验再显示;对于任务、行为或数值决策,更适合要求模型返回受约束的数据结构,再由游戏代码验证字段和取值范围。
例如,UI 层只负责显示文本,业务层负责决定这个文本是否允许进入当前游戏状态。这样即使模型返回异常内容,也只会影响一次生成结果,不会直接破坏存档、库存或经济系统。
第一次请求跑通后,再增加超时、重试、缓存、限流和结果校验会更有价值。先把“请求成功能拿到结果,失败能够看懂原因”这条基础链路做稳定,后续的游戏生成能力才有可靠的承载点。