JSON 结构化输出速查表:场景、模板与禁忌一页看完
这是一份 JSON 结构化输出速查表,适合收藏后随用随查。结构化输出是让 AI 按照固定的字段和格式返回结果,例如 JSON、表格或固定标题的清单。
一句话理解
结构化输出 = 这样结果可以直接粘贴进表格、导入系统,或被程序自动处理。原理:自由文本每次结构都不同,后续整理很费时;预先定义字段相当于给 AI 一张要填的表,结果更一致,也更容易检查遗漏。
场景速查
| 场景 | 推荐做法 |
|---|---|
| 从大量文本里提取信息,比如简历、合同、反馈里的关键字段 | 给枚举字段列出可选值,能显著减少同义词混用,比如“高/中/低” |
| 需要把结果导入表格或数据库 | 在 JSON 里加一个“原文依据”字段,方便人工核对每个值从哪来 |
| 多人协作需要统一格式的输出 | 表格形式适合人看,JSON 适合程序处理,按用途选择 |
| 写程序调用 AI 接口,需要稳定解析结果 | 批量处理时保持字段顺序不变,方便后续合并 |
操作要点
- 第 1 步:先确定你需要哪些字段,以及每个字段的类型和含义。
- 第 3 步:说明缺失值怎么处理,例如找不到就填 null 或“未提及”
- 第 4 步:要求“只输出 JSON,不要任何解释”
- 第 6 步:如果通过接口调用,优先使用平台提供的结构化输出或 JSON 模式等功能,并在程序里做格式校验。
常用模板
示例场景:律师准备法律文书。
请从下面的法律文书片段中提取信息,只输出 JSON,不要解释。
字段要求:
{
"主题": "字符串,不超过 20 字",
"负责人": "字符串,原文未提及填 null",
"截止日期": "YYYY-MM-DD 格式,未提及填 null",
"风险点": ["字符串数组,最多 3 条"],
"需要合伙人决策的事项": ["字符串数组"]
}
原文:
[粘贴内容]
错误写法对照
| 错误写法 | 正确做法 |
|---|---|
| 字段名含糊,比如“信息”“备注” | 每个字段写清含义和格式,比如“截止日期,YYYY-MM-DD” |
| 不说明缺失值怎么处理 | 明确“未提及填 null”,否则 AI 可能自己编一个值 |
| 要求 JSON 却允许附带解释 | 写明“只输出 JSON”,程序解析时才不会因为多余文字报错 |
| 一次提取的字段过多 | 字段太多时拆成两次,先提取核心字段,再补充次要字段 |
| 拿到 JSON 不做校验就入库 | 用程序校验格式和必填字段,抽查内容是否与原文一致 |
速答
- AI 偶尔输出不合法的 JSON 怎么办? 在程序中加格式校验,失败时把错误信息连同原输出发回给 AI 修正,并保留人工兜底。
- 表格和 JSON 怎么选? 给人看选表格,给程序处理选 JSON;两者都要时,可以先输出 JSON,再让 AI 转成表格。
速记:结构化输出的第一步是“先确定你需要哪些字段”,结果一定要人工复核。所有提示词技巧都在解决同一个问题:减少 AI 的猜测空间。背景、目标和标准写清楚,比任何花哨的句式都重要。
怎么用这页
写提示词前先看“场景速查”找到对应做法,写完后对照“错误写法”自查一遍。也可以把整页复制到笔记里,加上你自己的模板和经验。