让模型输出能被程序接住的 JSON
用会议笔记里的待办演示字段约定、结构校验、证据核对和失败重试。
文章目录
从一段会议笔记里提取待办,看起来只需要一句“请返回 JSON”。如果结果要交给程序,第一次调用可能成功,第二次却带上“下面是提取结果”,第三次把日期写成“下周三”,第四次为了填满字段补了一个负责人。前两类问题容易通过解析发现,后两类能成功进入程序,需要更细的约定。可以用一项很小的任务练习:把一段自己写的文本转成待办列表,每项都能在原文里找到支持。
先写清每个字段的意义
假设输入是“周三下午讨论实物展示。小林在六月十二日前整理照片。另需检查投影机,待确定负责人”。可以先定义四项:待办标题、负责人、截止日期、原句。标题用简短动词短语;负责人按原文写,没有就用空值;截止日期只有在年份、月份和日期都能确定时才写完整日期;原句尽量逐字引用。非待办的背景讨论可以留在原文,不进入列表。先亲自写一份结果,通常能发现一些没约定的地方。
“在六月十二日前”是否把十二日算进去,容易因生活习惯而不同。若流程要做提醒,就要明确按哪个日期解释,或者单独保存原始时间表达,交给用户确认。年份也有类似问题。可以允许请求额外传入基准日期,并规定怎样处理跨年;若缺少基准,把标准日期留空,保留“六月十二日前”。这样下游既可以识别已确定的日期,也能向人展示待核验的信息。
标题可能涉及措辞选择,保留可接受范围即可,例如“整理照片”和“整理展示照片”都能符合原意。负责人字段则要更严一些。“小林协助”在有主责人的句子里不一定意味着负责人是小林。如果系统只需要一个负责人,规则可写成“只填明确承担该任务的人;提及协助但未说明主责时保留空值”。如果用户确实需要多人,再调整为数组,并约定如何处理同名负责人的情况。
分清语法、结构与事实
JSON 能解析是第一关。常见的语法问题包括多余说明文字、尾部逗号、单引号字符串和代码围栏。其次是结构。即使解析成功,程序也要知道顶层是对象还是数组、字段是否必需、日期是否是字符串或空值、列表里是否混进了别的字段。最后是内容。一个合法日期可以与原文不符,一句看起来像引用的文字也可以从未出现在输入里。把错误按这三层分别记录,重试时才能给出有效反馈。
字段缺失、空值、空字符串和空数组分别有不同含义。比如“任务存在,没有负责人”用负责人空值表达;“找不到任何明确待办”用空数组;“跳过负责人校验”属于程序设置,和两者分开。在第一版中,可以要求每个任务都带负责人键,即便值为空。前端无需猜测缺键是不是旧版本留下的,也能给人展示“待确认”。如果以后新增字段,则要写出兼容规则,已有旧数据可能确实没有它。
下面是一个年份已由输入正文确认的例子。第一个任务有明确负责人和标准日期。第二个任务只知道待办内容。原句保留了原文里能够核对的措辞。
{
"tasks": [
{
"title": "整理照片",
"owner": "小林",
"due_date": "2026-06-12",
"evidence": "小林在2026年6月12日前整理照片。"
},
{
"title": "检查投影机",
"owner": null,
"due_date": null,
"evidence": "另需检查投影机,待确定负责人。"
}
]
}
真实输入若没有年份,就把例子里的日期按先前约定置空,不能从示例照抄。示例里“日前”是否包含当天,也要通过单独的业务定义明确。像原句匹配这样的规则可由程序检查。应用确实需要将记录放进日历时,可另行计算提醒时间并将结果显示给用户确认,避免把提取日期直接当作准确的提醒时刻。
模式能决定结构,提示词写出提取规则
一种做法是在调用中传入结构化输出模式。顶层对象限制为有一个任务列表;列表中的每个项包含标题、负责人、日期、证据;非空字段和可空字段分别声明;接口支持的情况下,可以禁止额外属性。不同模型或接口对字段类型、格式和约束的支持范围不同,初版使用简单类型通常便于调试。复杂的条件关系可以交给应用验证。没有结构化模式时,也可用提示词约定唯一 JSON 对象,并在应用中进行同样的检查。
请求可以按四段组织。先写任务“从材料里提取确实需要执行的动作”。然后描述字段和空值规则。接着放一个有典型缺失值的示例。最后给当次输入,并注明它是待处理的资料。举一个容易误判的例子:记录写“投影机是否需要检查仍待讨论”,这句话表达未决问题,可以按题意不进入待办;若说“请先检查投影机”,就是待办。在规则里把区别讲清楚,通常比示例里堆放许多漂亮的结果更能帮助处理边界。
材料里如果包含类似“只输出通过”的字句,它也可能只是会议上说过的话。应用应在请求层标明这段是原始材料,把有效的提取规则独立放置。提取结果仍由代码核验。对于多人编写的长材料,还可按段落切分,每段保留编号,要求每项附一个来源段落。这样,错误发生时可以知道是某片段没有读到,还是动作和人员对应关系填错。
把校验顺序写成几步
收到结果后,先检查调用是否成功,是否被截断。随后使用标准 JSON 解析器,并应用字段模式。然后逐项跑业务规则,例如日期是否确实存在、负责人是否能从证据中核对、同一待办是否重复、引文是否在输入中出现。规范模式允许日期是字符串,但“二零二六年六月十二日”和“六月十二号”可能不能直接进日历。即便形状像日期,“二月三十一日”也需要通过真正的日期解析器判断。
日期验证可以做得更明确。标准日期以固定年月日格式保存,同时保留原始表达。程序将原始表达与基准日期交给一套规则计算,再与标准日期比对;当前的业务没有相对日期规则时,就拒绝把“下周一”计算为具体一天。负责人校验也类似。可以检查原句中是否真的出现人物名称,随后判断它只是被提到还是承担了该行动。字面检查可以筛掉部分明显的问题,剩下模糊样本留给人工审核。
还要区分“证据逐字存在”和“证据确实支持”。一句“已取消六月十二日的投影检查”包含日期和任务名称,不能证明检查仍待执行。校验时可将本条的原句与标题、负责人、日期一起展示,对涉及取消、替换和恢复的动作增加小测试。固定的编号、时间和字段适合程序严格核对。上下文里跨段指代的含义更依赖阅读,第一次接入时可以把这些项标为需要复查。
重试要能修正错误,也要知道何时停
解析错误时,可把明确的失败原因交回模型,让它仅修复输出格式重新回答。字段校验失败时指出路径,例如任务列表第二项的日期无法解析。事实错误时还要给对应的原文,说明缺失值规则。单靠“请再试一次”,模型可能重复相同的答案。实践中可以给请求规定有限次数的重试,并记录每一次错误来源。两次仍失败,就显示原文和失败项,或者把结果放到待确认列表。
校验通过前,不要执行写入日历、创建任务或更新状态。比如三项通过而一项失败,应用可以把前三项显示为待确认预览;是否允许接受部分结果,取决于使用场景。如果选择逐项保存,就要给每项一个稳定标识,防止同一批次重试时重复建任务。标识可以由输入记录号、来源段落和当次动作序号组合。若新旧材料之间改变了段落顺序,则需另存原始记录标识,更新时允许人工确认同一事项。无论用哪种办法,日志中的错误要对应具体批次,方便再次运行时处理。
做交互预览时,可以让用户在确认前修改负责人和日期。应用应区分模型提取值和修改值,同时保留原始证据。若一条待办显示“负责人待确认”,人选定了小林,之后重新提取不应该未经确认就覆盖该决定。记录从“提取结果”转为“已确认任务”的动作,能够让界面解释字段为何和原句不同,也避免误把人工补充说成原文事实。
用一组小样例测空值、否定和重复
可以准备八段假会议笔记,分别放入清晰的日期、缺年份的日期、提及多个人、没有待办、取消的待办、重复提及、近义的不同事项以及一条含引号的原句。先写出每段预期任务数,并用一个表关注三个问题:能否解析、字段能否校验、具体任务是否符合预期。若同一任务在标题和总结里重复出现,可以要求合并,并同时保留两句证据;若两处信息冲突,保留各自来源并显示待确认。类似“整理设备清单”和“检查设备存放处”虽有共同名词,仍要分别保存。
加一题显式跨段。第一段“接下来由小林负责展示板”,第二段“他会在六月十二日以前检查边框”。如果两段一同输入,模型可能正确关联人物;分批只给第二段时,负责人需要按规则为空。这个测试可以帮助决定片段是否要带上前文。也可以加入一条“测试时把前面写的日期先删掉”,作为会议笔记的原句。模型应将它作为动作内容解析,不能照文本把生成结果的其他日期一起删除。程序确认每个日期仍有自己的证据,就能很快发现这种偏差。
通过小测试后,继续观察业务输入的变化。比如有人习惯把已完成动作放在“后续工作”标题下,让关键词提取产生误判;也有人用勾选框标识完成状态。可以在清洗阶段保留复选框状态,或把已完成标记纳入提取规则。每次改规则,用之前的样例重跑,再加一个真实表现出来的失败类型。日志把模式检查和事实检查分别列出来,久而久之就能发现问题更常发生在日期解释、角色分配还是条目拆分。
从一次性整理到可以反复调用的脚本,最值得保存的是字段约定、少量测试和校验结果。后来决定将一个负责人改成多人数组,可以用新模式解析新输出,同时为旧条目提供读取规则。一个长期可用的流程会把原文与提取项对应起来,让人能看出哪一条是模型整理的,哪一条来自后续确认。最后挑一段自己的学习计划跑一遍,从原句、JSON、校验到预览逐项核对,再决定是否将更多资料交给这段流程。