大模型应用开发 / 系统课时
定义输出模式
定义输出模式
模型即使被要求“只返回 JSON”,仍可能漏字段、改字段名或输出非法值。本课用数据模式把期望结果变成可检查的契约,明确字段类型、必填项、枚举范围和嵌套结构。
学习目标
- 能用数据模式描述对象、数组和嵌套字段
- 能区分必填约束、类型约束与取值约束
- 能设计便于模型生成和程序消费的输出结构
从自然语言要求变成数据契约
“返回文章标题、难度和知识点列表”只是自然语言约定,模型与程序可能产生不同理解。数据模式则把每个字段的名称、类型和约束写成机器可读规则,后续可以直接用于提示模型、解析结果和执行校验。
设计模式时先确定最外层结构,再逐层补充字段。字段名应稳定、含义单一,避免同时使用 title、name、heading 表示同一概念,也不要让一个字段在不同情况下返回字符串或数组。
定义字段与嵌套结构
下面的 JSON Schema 描述一份课程卡片:title 和 difficulty 必填,难度只能取三个枚举值,topics 至少包含一个字符串,author 是带必填字段的嵌套对象。
{
"type": "object",
"additionalProperties": false,
"required": ["title", "difficulty", "topics", "author"],
"properties": {
"title": {
"type": "string",
"minLength": 1
},
"difficulty": {
"type": "string",
"enum": ["beginner", "intermediate", "advanced"]
},
"topics": {
"type": "array",
"minItems": 1,
"items": {
"type": "string"
}
},
"author": {
"type": "object",
"additionalProperties": false,
"required": ["name"],
"properties": {
"name": {
"type": "string",
"minLength": 1
}
}
}
}
}required 控制字段是否必须出现,type 控制数据类型,enum 限制可选值,items 描述数组元素,additionalProperties: false 用于拒绝模式之外的字段。嵌套对象应单独声明自己的必填项,不能依赖外层规则自动生效。
检查一个符合模式的结果
模型输出可以按同一结构返回数据:
{
"title": "结构化输出入门",
"difficulty": "beginner",
"topics": ["字段类型", "必填项", "枚举值"],
"author": {
"name": "Anystack"
}
}预期结果:该对象包含全部必填字段,字段类型正确,difficulty 位于枚举范围内,topics 非空,且没有额外字段,因此能够通过模式校验。
设计模式时的关键边界
模式应尽量严格,但不要加入业务上无法稳定满足的限制。例如,模型可以可靠地产生枚举值,却不一定能保证自由文本精确满足复杂正则表达式。对日期、金额和标识符等关键字段,应优先使用明确格式,并在应用层继续做业务校验。
字段结构也不宜过深。嵌套层级越多,模型越容易遗漏闭合结构或混淆所属字段。能用一层对象表达的内容不要拆成多层;必须嵌套时,为每层提供清晰名称并限制额外字段。
本课总结
- 数据模式把自然语言要求变成可解析、可校验的输出契约
- 必填、类型、枚举、数组元素和嵌套对象需要分别声明
- 模式应保持字段稳定、约束明确,并避免不必要的深层嵌套
下一课预告
下一课将把模式真正用于运行时校验,并处理解析失败、字段缺失、类型错误和非法枚举值。