codecamp

让 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}

Qwen 输出卡片

以上为模型真实回复的节选,实测日期 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 输出篇幅与禁前言。
Qwen 输出怎么落进表格
Qwen 长输入用 XML 标签包
温馨提示
下载编程狮App,免费阅读超1000+编程语言教程
取消
确定
目录

关闭

MIP.setData({ 'pageTheme' : getCookie('pageTheme') || {'day':true, 'night':false}, 'pageFontSize' : getCookie('pageFontSize') || 20 }); MIP.watch('pageTheme', function(newValue){ setCookie('pageTheme', JSON.stringify(newValue)) }); MIP.watch('pageFontSize', function(newValue){ setCookie('pageFontSize', newValue) }); function setCookie(name, value){ var days = 1; var exp = new Date(); exp.setTime(exp.getTime() + days*24*60*60*1000); document.cookie = name + '=' + value + ';expires=' + exp.toUTCString(); } function getCookie(name){ var reg = new RegExp('(^| )' + name + '=([^;]*)(;|$)'); return document.cookie.match(reg) ? JSON.parse(document.cookie.match(reg)[2]) : null; }