大模型应用开发 / 系统课时

约束输出格式

约束输出格式

当模型结果要进入程序、数据库或工作流时,仅说“请按 JSON 输出”通常不够。本课将把结构、字段、长度、语言和禁止内容写成可执行约束,并用解析校验确认输出真正可用。

学习目标

  • 能把模糊的格式要求拆成明确约束
  • 能编写稳定、可解析的结构化输出提示词
  • 能通过程序校验及时发现格式偏差

为什么格式约束必须具体

模型会优先完成语义任务,但不会自动理解下游系统的全部限制。若只要求“返回结果”,它可能添加解释、改变字段名、输出 Markdown 围栏,甚至在缺少信息时自行增加字段。

有效约束至少覆盖五个维度:

维度 应明确的内容 示例
结构 对象、数组或纯文本 返回一个 JSON 对象
字段 名称、类型、是否必填 score 为 0~100 的整数
长度 字数、条数、数组上限 tags 最多 3 项
语言 输出语言和术语要求 所有说明使用简体中文
禁止项 不允许出现的内容 不要解释,不要 Markdown 围栏

约束越接近机器校验规则,模型越容易稳定执行。避免使用“尽量简洁”“格式规范”这类无法直接判断的描述。

编写可解析的格式约束

下面的提示词把任务要求和输出协议分开,字段、类型和禁止内容都可以逐项检查。

text
任务:根据用户反馈判断情绪,并提取最多 3 个关键词。

输出要求:
1. 只返回一个标准 JSON 对象,不要添加解释或 Markdown 围栏。
2. 对象只能包含 sentiment、keywords、reason 三个字段。
3. sentiment 只能是 positive、neutral、negative。
4. keywords 必须是字符串数组,最多 3 项。
5. reason 使用简体中文,不超过 40 个汉字。
6. 无法判断时,sentiment 返回 neutral,keywords 返回空数组。

预期结果

json
{"sentiment":"negative","keywords":["退款","等待时间"],"reason":"用户对退款等待时间表达了明显不满"}

这里没有要求模型复述规则,而是直接限定最终产物。对固定枚举、数组上限和缺省行为的说明,可以显著降低下游分支判断的复杂度。

按层次组织约束

格式要求较多时,建议按“外层结构 → 字段规则 → 内容限制 → 异常处理 → 禁止项”的顺序书写。模型先确定输出骨架,再填充字段,执行路径更清晰。

字段之间存在依赖时也要明确说明。例如:当 sentiment 为 neutral 且没有关键词时,keywords 必须返回空数组,而不是省略字段。这样可以避免同一输入出现多种合法外形。

提示:不要同时要求“只返回 JSON”和“先解释判断过程”。两项指令相互冲突时,输出最容易混入额外文本。

用程序验证输出

提示词只能提高一致性,不能替代解析校验。下面的完整 Python 示例会检查 JSON 是否可解析、字段是否齐全,以及枚举值和数组长度是否符合约束。

python
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("格式校验通过")

预期输出

text
格式校验通过

实际项目还应继续校验字段类型、字符串长度和业务规则。动态输入、模型版本或温度变化都可能造成偏差,因此解析失败时应记录原始输出,并决定重试、修复还是转人工处理。

常见失败与修正

失败现象 常见原因 修正方式
JSON 外出现解释 未明确“只返回” 增加禁止解释和禁止围栏
字段名偶尔变化 只描述含义,未锁定名称 列出唯一允许的字段集合
缺少字段 未说明空值策略 指定空字符串、空数组或 null
内容过长 使用“简短”等模糊词 给出明确字数或条数上限
枚举值不统一 没有限定候选值 明确列出所有合法值

本课总结

  • 输出约束应同时覆盖结构、字段、长度、语言和禁止内容
  • 缺省行为与字段依赖必须明确,避免同一任务产生多种外形
  • 提示词负责减少偏差,程序校验负责阻止无效结果进入系统

下一课预告

下一课将学习如何用少样本示例展示输入与输出关系,让分类、抽取和固定格式生成更加稳定。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

约束输出格式

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通