1. 为什么需要严格控制AI的JSON输出格式
在开发AI应用时,我们经常需要模型输出结构化的JSON数据。但实际使用中,模型可能会输出包含解释文本、Markdown代码块等非纯JSON内容,导致下游系统解析失败。这种情况在线上服务中尤为致命。
我曾在电商客服系统中遇到过这样的问题:当用户询问"帮我查订单状态"时,理想输出应该是{"intent":"check_order","order_id":"12345"},但模型有时会输出:
code复制好的,这是您要的订单信息:
```json
{
"intent": "check_order",
"order_id": "12345"
}
这种"解释+Markdown"的输出格式会让JSON解析器直接崩溃。更糟的是,这种问题往往在测试阶段不易发现,直到上线后才在特定场景下暴露。
需要模型API调用? 免费领10W Token,多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. 设计可靠的JSON输出提示词
2.1 基础提示词模板
最简单的提示词只需要明确要求纯JSON输出:
code复制你必须只输出一个JSON对象,不要输出任何额外文本,也不要使用Markdown。
信息不足的字段写null。
但这样的提示词在实际应用中仍然不够可靠。模型可能会因为各种原因(如输入不完整、指令理解偏差)输出非JSON内容。
2.2 增强版提示词模板
更可靠的提示词应该包含以下几个关键部分:
- 格式要求:明确禁止Markdown和解释文本
- Schema定义:详细说明每个字段的类型和格式
- 校验规则:定义字段必填、枚举值、长度限制等
- 错误兜底:指定当输入不满足要求时的统一错误格式
示例:
code复制你必须只输出JSON(不要Markdown,不要解释)。
必须满足:
1) 必须包含字段:intent, priority, summary, tags
2) priority只能是low/medium/high
3) tags必须是数组,最多5个
4) summary <= 60字
如果无法满足规则,请只输出:
{ "error": "原因", "need": ["缺少的信息"] }
这种提示词通过"唯一出口"设计,将模型可能输出的各种非结构化内容收敛到一个统一的错误结构中。
