JSON Schema

一句话：用一套规则描述JSON应该长什么样，常用于校验AI输出和接口数据。

它是什么

JSON Schema是JSON数据的格式说明书。它可以规定字段名、类型、是否必填、数组结构和取值范围。做AI应用时，它常用来约束模型输出，避免AI返回一段无法解析的自由文本。

适合干什么

• 需要AI稳定输出JSON的人
• 做接口对接和数据校验的人
• 用工作流工具串联多个步骤的人
• 经常遇到JSON格式不稳定的人

不适合干什么

• 只做一次性聊天
• 不需要结构化数据
• 完全不理解字段含义
• 希望Schema自动判断业务正确性

普通人怎么用

• 先列出需要的字段
• 给每个字段定义类型
• 标出哪些字段必填
• 给AI明确要求只输出符合Schema的JSON
• 解析前先做校验

进阶用户怎么用

• 为数组对象定义嵌套结构
• 给字段设置枚举值和长度限制
• 把Schema用于前后端共享校验
• 结合模型的结构化输出能力减少解析失败

常见误区

• 字段设计太复杂，AI容易漏
• 没有禁止额外解释文字
• 字段名中英文混用
• 只校验格式，不校验业务逻辑

和相似工具的区别

• JSON vs JSON Schema：JSON是具体数据，JSON Schema是规定数据格式的规则。
• Schema校验 vs 业务校验：Schema检查格式对不对，业务校验检查内容是否合理。

入门步骤

• 列字段
• 定类型
• 标必填
• 写示例
• 让AI按格式输出
• 程序校验

推荐工具（第三方）

Ajv、Zod、TypeScript、OpenAI Structured Outputs、Dify