如何强制输出有效的JSON(不带markdown)

把数据提取并转换成严格JSON的提示词模板:写明字段、类型、null规则和校验步骤,让输出可以直接解析。

最后更新: · Markdown版本

有效的规则

  • 告诉它:“只输出JSON”,并禁止任何多余的文字。
  • 定义一个schema(键、类型、允许的取值)。
  • 说明缺少字段时怎么办(用null还是省略)。
  • 要求再检查一遍:校验并修正JSON。

改写前→改写后:从“给我JSON”到一份契约

  • 改写前:“把这封邮件里的联系人信息以JSON格式给我。”典型结果:一句开场白、一个markdown代码块,而且每次运行的键都不一样。
  • 改写后:“提取联系人信息。只返回有效的JSON,不要markdown。Schema:{name: string, email: string|null, phone: string|null}。缺少的信息一律用null;不要猜测。”
  • 改了什么:输出变成了一个确定的schema,规定了缺失值的处理方式,并禁止多余的文字,所以同一个提示词每次都会给出相同的结构。

用代码校验,别靠运气

  • 使用之前,先用真正的JSON解析器解析响应,并对照schema检查(必填键、类型、允许的取值)。
  • 校验失败时,附上错误信息重试一次:“你之前的输出没有通过校验:[错误]。只返回修正后的JSON。”
  • 如果模型或API提供原生的结构化输出模式,就使用它:这样格式会在生成时被强制执行,而不是靠文字去请求。Promptea的模型页面会标明当前哪些模型提供这一模式。
  • 有效的JSON不等于内容正确。要对照原文抽查取值,尤其是数字和日期。

想在运行前确认JSON提示词写明了字段、类型和null规则,请使用提示词分析器。

模板

提取结构化JSON

从下面的文本中提取数据。
只返回有效的JSON(不要markdown,不要注释)。

Schema:
{
  "people": [
    {
      "name": "string",
      "role": "string|null",
      "email": "string|null"
    }
  ],
  "dates": ["YYYY-MM-DD"]
}

规则:
- 如果缺少信息,使用null(不要编造)。
- 如果日期有歧义,就省略它。

文本:
"""[粘贴到这里]"""

最终输出之前,校验输出是有效的JSON,并且符合schema。
将在分析器中打开,并预先填入该提示词。

把JSON转换成新的schema

你会收到JSON输入。把它转换成下面的输出schema。
只返回有效的JSON。

输入JSON:
"""[粘贴JSON]"""

输出schema:
{
  "items": [
    { "id": "string", "title": "string", "tags": ["string"] }
  ]
}

规则:
- 保留原意;不要编造新的条目。
- 如果某个输入字段无法对应,就忽略它。
- 确保tags全部为小写。

输出之前先校验JSON。
将在分析器中打开,并预先填入该提示词。

常见问题

为什么模型还是会加上多余的文字?
因为这条约束对它来说分量还不够。重复这条约束,提供schema,并要求它校验。
我应该用JSON Schema吗?
如果是严格的系统集成,应该用。即使是简化的schema(键+类型)也很有帮助。
值缺失时,模型应该返回什么?
选定一条规则并写明:缺失的值用null,或者省略这个键。两种混用,会迫使你的代码同时处理两种情况。还要告诉它不要猜测。
可以在同一个回答里同时要JSON和解释吗?
把两者分开:把解释放进一个专门的键,例如"notes",或者另发一次请求。JSON之外的文字会导致解析失败。