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

定义输出模式

定义输出模式

模型即使被要求“只返回 JSON”,仍可能漏字段、改字段名或输出非法值。本课用数据模式把期望结果变成可检查的契约,明确字段类型、必填项、枚举范围和嵌套结构。

学习目标

  • 能用数据模式描述对象、数组和嵌套字段
  • 能区分必填约束、类型约束与取值约束
  • 能设计便于模型生成和程序消费的输出结构

从自然语言要求变成数据契约

“返回文章标题、难度和知识点列表”只是自然语言约定,模型与程序可能产生不同理解。数据模式则把每个字段的名称、类型和约束写成机器可读规则,后续可以直接用于提示模型、解析结果和执行校验。

设计模式时先确定最外层结构,再逐层补充字段。字段名应稳定、含义单一,避免同时使用 title、name、heading 表示同一概念,也不要让一个字段在不同情况下返回字符串或数组。

定义字段与嵌套结构

下面的 JSON Schema 描述一份课程卡片:title 和 difficulty 必填,难度只能取三个枚举值,topics 至少包含一个字符串,author 是带必填字段的嵌套对象。

json
{
  "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 用于拒绝模式之外的字段。嵌套对象应单独声明自己的必填项,不能依赖外层规则自动生效。

检查一个符合模式的结果

模型输出可以按同一结构返回数据:

json
{
  "title": "结构化输出入门",
  "difficulty": "beginner",
  "topics": ["字段类型", "必填项", "枚举值"],
  "author": {
    "name": "Anystack"
  }
}

预期结果:该对象包含全部必填字段,字段类型正确,difficulty 位于枚举范围内,topics 非空,且没有额外字段,因此能够通过模式校验。

设计模式时的关键边界

模式应尽量严格,但不要加入业务上无法稳定满足的限制。例如,模型可以可靠地产生枚举值,却不一定能保证自由文本精确满足复杂正则表达式。对日期、金额和标识符等关键字段,应优先使用明确格式,并在应用层继续做业务校验。

字段结构也不宜过深。嵌套层级越多,模型越容易遗漏闭合结构或混淆所属字段。能用一层对象表达的内容不要拆成多层;必须嵌套时,为每层提供清晰名称并限制额外字段。

本课总结

  • 数据模式把自然语言要求变成可解析、可校验的输出契约
  • 必填、类型、枚举、数组元素和嵌套对象需要分别声明
  • 模式应保持字段稳定、约束明确,并避免不必要的深层嵌套

下一课预告

下一课将把模式真正用于运行时校验,并处理解析失败、字段缺失、类型错误和非法枚举值。

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

目录与阅读设置

阅读设置

17

记录一个想法

定义输出模式

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

登录哪都通