大模型应用开发 / 系统课时
约束输出格式
约束输出格式
当模型结果要进入程序、数据库或工作流时,仅说“请按 JSON 输出”通常不够。本课将把结构、字段、长度、语言和禁止内容写成可执行约束,并用解析校验确认输出真正可用。
学习目标
- 能把模糊的格式要求拆成明确约束
- 能编写稳定、可解析的结构化输出提示词
- 能通过程序校验及时发现格式偏差
为什么格式约束必须具体
模型会优先完成语义任务,但不会自动理解下游系统的全部限制。若只要求“返回结果”,它可能添加解释、改变字段名、输出 Markdown 围栏,甚至在缺少信息时自行增加字段。
有效约束至少覆盖五个维度:
| 维度 | 应明确的内容 | 示例 |
|---|---|---|
| 结构 | 对象、数组或纯文本 | 返回一个 JSON 对象 |
| 字段 | 名称、类型、是否必填 | score 为 0~100 的整数 |
| 长度 | 字数、条数、数组上限 | tags 最多 3 项 |
| 语言 | 输出语言和术语要求 | 所有说明使用简体中文 |
| 禁止项 | 不允许出现的内容 | 不要解释,不要 Markdown 围栏 |
约束越接近机器校验规则,模型越容易稳定执行。避免使用“尽量简洁”“格式规范”这类无法直接判断的描述。
编写可解析的格式约束
下面的提示词把任务要求和输出协议分开,字段、类型和禁止内容都可以逐项检查。
任务:根据用户反馈判断情绪,并提取最多 3 个关键词。
输出要求:
1. 只返回一个标准 JSON 对象,不要添加解释或 Markdown 围栏。
2. 对象只能包含 sentiment、keywords、reason 三个字段。
3. sentiment 只能是 positive、neutral、negative。
4. keywords 必须是字符串数组,最多 3 项。
5. reason 使用简体中文,不超过 40 个汉字。
6. 无法判断时,sentiment 返回 neutral,keywords 返回空数组。预期结果
{"sentiment":"negative","keywords":["退款","等待时间"],"reason":"用户对退款等待时间表达了明显不满"}这里没有要求模型复述规则,而是直接限定最终产物。对固定枚举、数组上限和缺省行为的说明,可以显著降低下游分支判断的复杂度。
按层次组织约束
格式要求较多时,建议按“外层结构 → 字段规则 → 内容限制 → 异常处理 → 禁止项”的顺序书写。模型先确定输出骨架,再填充字段,执行路径更清晰。
字段之间存在依赖时也要明确说明。例如:当 sentiment 为 neutral 且没有关键词时,keywords 必须返回空数组,而不是省略字段。这样可以避免同一输入出现多种合法外形。
提示:不要同时要求“只返回 JSON”和“先解释判断过程”。两项指令相互冲突时,输出最容易混入额外文本。
用程序验证输出
提示词只能提高一致性,不能替代解析校验。下面的完整 Python 示例会检查 JSON 是否可解析、字段是否齐全,以及枚举值和数组长度是否符合约束。
import json
raw_output = '{"sentiment":"negative","keywords":["退款","等待时间"],"reason":"用户对退款等待时间表达了明显不满"}'
data = json.loads(raw_output)
required_fields = {"sentiment", "keywords", "reason"}
if set(data) != required_fields:
raise ValueError("字段集合不符合要求")
if data["sentiment"] not in {"positive", "neutral", "negative"}:
raise ValueError("sentiment 取值无效")
if not isinstance(data["keywords"], list) or len(data["keywords"]) > 3:
raise ValueError("keywords 必须是最多 3 项的数组")
print("格式校验通过")预期输出
格式校验通过实际项目还应继续校验字段类型、字符串长度和业务规则。动态输入、模型版本或温度变化都可能造成偏差,因此解析失败时应记录原始输出,并决定重试、修复还是转人工处理。
常见失败与修正
| 失败现象 | 常见原因 | 修正方式 |
|---|---|---|
| JSON 外出现解释 | 未明确“只返回” | 增加禁止解释和禁止围栏 |
| 字段名偶尔变化 | 只描述含义,未锁定名称 | 列出唯一允许的字段集合 |
| 缺少字段 | 未说明空值策略 | 指定空字符串、空数组或 null |
| 内容过长 | 使用“简短”等模糊词 | 给出明确字数或条数上限 |
| 枚举值不统一 | 没有限定候选值 | 明确列出所有合法值 |
本课总结
- 输出约束应同时覆盖结构、字段、长度、语言和禁止内容
- 缺省行为与字段依赖必须明确,避免同一任务产生多种外形
- 提示词负责减少偏差,程序校验负责阻止无效结果进入系统
下一课预告
下一课将学习如何用少样本示例展示输入与输出关系,让分类、抽取和固定格式生成更加稳定。