让 Qwen 按字段 Schema 输出 JSON
JSON 输出可解析的前提是 Schema 说全:字段名、类型、缺省值、禁前言四样写死,拿到的就不再是「看起来像 JSON 的散文」。
一、前提与适用
| 适用对象 | 前提 | 不适用 |
|---|---|---|
| 输出要进程序的调用方 | 能写出字段名与类型 | 输出只给人看(Schema 是多余负担) |
| 收到过「JSON 前面带一句客套话」的输出 | 保留了原始指令 | 模型故障导致输出整体损坏的排查 |
| 要稳定抽固定字段的批量任务 | 有真实数据样本可对照 | 字段需求每次都变的探索期 |
本节示例用 qwen3.7-max;示例参数 temperature=0.7、top_p=0.8 属选取默认值,不是官方推荐。字段标准化的官方示范是评测场景的选择题写法:answer 字段只放选项字母,如 "answer": "C"——字段里只放约定类型的东西,不夹解释。
二、怎么做
三步:定 Schema → 定缺省 → 禁前言。
第 1 步,定 Schema。 字段名、类型、约束逐个写进提示词:哪个字段是字符串、哪个是数字、数组上限几个。字段名用英文并给中文注释,方便下游引用。
第 2 步,定缺省。 数据里没有的字段填什么?写死(null 或「未提及」),模型才不会编。
第 3 步,禁前言。 写明「只输出 JSON,不要解释」,防止输出前带客套句。下面的判定器校验字段存在与类型。
## EXPECT: city=字符串合法 temp=数字合法
import json
d = json.loads('{"city": "杭州", "temp": 24}')
def check(v):
return "字符串合法" if isinstance(v, str) else "数字合法"
print(" ".join(f"{k}={check(d[k])}" for k in ("city", "temp")))
开工前先看一组反例与正例。
坏写法:
把今天的天气整理成 JSON 给我。
没字段名、没类型、没缺省——模型可能输出 {"weather": "晴 24度"} 这种把两件事挤一个字段的形状,也可能前面加一句「好的,以下是 JSON」。
改写后的完整提示词:
你是字段抽取助手。只输出一行 JSON,不要任何前言、解释或代码块围栏。字段:city(字符串)、temp(数字,摄氏度)。数据里没有的字段填 null。
数据:{{原始文本}}
最小可跑填法:原始文本 填真实数据,例如「今天杭州晴,气温 24 度,适宜出行」。随请求参数:模型 qwen3.7-max、enable_thinking=false、temperature=0.7、top_p=0.8——字段抽取关思考更稳也更省。
实测输出与判定:脚本实跑输出与首行注释一致。逐条判定:city 是字符串、temp 是数字,类型各归其位;判定器核的是「字段存在+类型正确」,值本身的对错要人工对照数据。
怎么看这个示例:判定器是本地脚本,上面那条提示词另在 qwen3.7-max(temperature=0.7、top_p=0.8) 上实测;脚本输出不等于模型输出,两者分别核对。
模型回复(真实输出节选):
{"city":"杭州","temp":24}

以上为模型真实回复的节选,实测日期 2026-11-16。
三、参数与边界
| 项 | 稳的写法 | 不稳的写法与后果 |
|---|---|---|
| 字段名 | 英文+注释,一次定死 | 中英混用:下游引用混乱 |
| 字段内容 | 只放约定类型 | 字符串里塞数字:解析端要二次清洗 |
| 缺省 | 写死 null 或「未提及」 | 不写:模型编造填充 |
| 前言 | 「只输出 JSON」写进提示词 | 不写:客套句混进输出 |
| 围栏 | 明确「不要代码块围栏」 | 不写:输出带 ``` 包裹,解析多一步 |
单行还是多行 JSON 都可解析;但「一行」便于日志核对,批量任务优先。
四、验收清单
| 现象 | 判断依据 | 下一步动作 |
|---|---|---|
| 解析报错 | 输出带前言或围栏 | 补禁前言+禁围栏条款,重跑 |
| 字段名每次不同 | Schema 没写死 | 字段名逐个列出,不用「等等」 |
| 数字字段是字符串 | 类型没写明 | 标注类型(数字/字符串/布尔) |
| 缺数据的字段被编造 | 缺省约定没写 | 补「没有的填 null」 |
| 字段值夹解释文字 | 违反「字段只放值」 | 对照评测示范:字段里只放约定内容 |
用这张清单前先确认一点:Schema 的字段清单要能被判定器逐项核对,写不进判定的字段先别上。
五、注意与相关
- Schema 四件套:字段名、类型、缺省、禁前言,缺一样就给解析端留坑。
- 「字段只放值」不是小事:评测示范里 answer 只放一个字母,就是这个原则的极端版。
- 来源:Qwen 官方文档
https://qwen.readthedocs.io/en/latest/(模型卡评测示范给出 answer 字段只放选项字母的标准化写法)。Schema 四件套与判定器是教程自己组织的方案。 - 相关:表格输出见 Qwen 输出怎么落进表格;XML 标签隔离见 Qwen 长输入用 XML 标签包;脚本级契约见 让 Qwen 生成脚本与测试;禁前言细则见 控制 Qwen 输出篇幅与禁前言。