AI把一段工作记录整理成JSON后,能够解析,只说明它符合JSON语法。少了负责人字段、把任务写成数字,甚至把“待确认”填进日期,仍可能混进后续流程。
本文由玄枢AI品牌运营方整理,使用AI辅助创作。下面用完全虚构的待办和本地Python演示校验方法;样本是为教程编写的,不是模型返回记录,没有调用模型或网络接口,不代表验证了玄枢的产品能力。
先约定输出契约,再接收结果
虚构输入:整理演示资料目录,由角色A负责,2026年11月20日到期;确认演示图的说明文字,负责人和时间均未确定。两项都尚未开始。角色只是演示标识,没有真实人员信息。
约定顶层为数组,每一项必须且只能有以下四个字段:
| 字段 | 类型与规则 |
|---|---|
task | 非空字符串,纯空白不算任务 |
owner | "role_a"、"role_b"或null,角色名单由业务提供 |
due | 严格的YYYY-MM-DD有效日期或null,本例不处理时刻和时区 |
status | "todo"、"doing"、"done"之一,不能为null |
“字段缺失”和“值未知”是两回事:未知负责人、日期保留字段并填null,不写"null"、空字符串或猜测值。状态不明则退回确认,本例不替它猜成todo。空数组[]在结构上允许,但不能据此证明原文没有待办。
可以把这个约定放进整理要求:“只返回符合上述契约的JSON数组;不得补造负责人或日期,不确定时用null;不添加解释或Markdown围栏。”这是输出要求,不能代替接收端校验,也不保证模型遵守。
用标准库写一个明确失败的检查器
将下面代码放在validate.py。它先解析JSON,再检查字段与值;拒绝重复键,避免同名字段被后值覆盖后悄悄通过。错误包含数组位置和字段路径。它不自动修补数据,也不执行JSON中的文本。
import json
import re
import sys
from datetime import date
from pathlib import Path
def unique_object(pairs):
result = {}
for key, value in pairs:
if key in result:
raise ValueError(f"duplicate key: {key}")
result[key] = value
return result
def validate(data):
if not isinstance(data, list):
return ["$: expected array"]
errors = []
required = {"task", "owner", "due", "status"}
owners = {"role_a", "role_b"}
statuses = {"todo", "doing", "done"}
for index, item in enumerate(data):
path = f"$[{index}]"
if not isinstance(item, dict):
errors.append(f"{path}: expected object")
continue
for key in sorted(required - item.keys()):
errors.append(f"{path}.{key}: missing")
for key in sorted(item.keys() - required):
errors.append(f"{path}.{key}: unexpected field")
for key in sorted(required & item.keys()):
value = item[key]
error = None
if key == "task":
if not isinstance(value, str) or not value.strip():
error = "expected non-empty string"
elif key == "owner" and value is not None:
if not isinstance(value, str) or value not in owners:
error = "expected role_a, role_b or null"
elif key == "status":
if not isinstance(value, str) or value not in statuses:
error = "expected todo, doing or done"
elif key == "due" and value is not None:
if not isinstance(value, str) or not re.fullmatch(
r"[0-9]{4}-[0-9]{2}-[0-9]{2}", value
):
error = "expected YYYY-MM-DD or null"
else:
try:
date.fromisoformat(value)
except ValueError:
error = "invalid calendar date"
if error:
errors.append(f"{path}.{key}: {error}")
return errors
def main():
if len(sys.argv) != 2:
print("usage: python validate.py FILE.json", file=sys.stderr)
return 2
try:
text = Path(sys.argv[1]).read_text(encoding="utf-8")
data = json.loads(text, object_pairs_hook=unique_object)
errors = validate(data)
if errors:
raise ValueError("\n".join(errors))
except (OSError, UnicodeError, ValueError) as exc:
print(f"FAIL: {exc}", file=sys.stderr)
return 1
print(f"OK: {len(data)} item(s)")
return 0
if __name__ == "__main__":
sys.exit(main())
这里先检查类型再检查集合成员,数组、布尔值等错误类型不会触发成员检查异常。日期先限定格式,再检查实际日历日期;2026-02-30不会因长得像日期而通过。JSON的null会被Python解析成None。
正反样本与实际本地结果
正确样本valid.json:
[
{"task": "整理演示资料目录", "owner": "role_a", "due": "2026-11-20", "status": "todo"},
{"task": "确认演示图的说明文字", "owner": null, "due": null, "status": "todo"}
]
故意写错的invalid.json:
[
{"task": "整理演示资料目录", "due": null, "status": "waiting", "priority": 1},
{"task": 7, "owner": "role_c", "due": "2026-02-30", "status": ["todo"]}
]
三个文件放在同一目录,在该目录运行:
python -B validate.py valid.json
python -B validate.py invalid.json
2026年11月17日在本地Python 3.15.0环境实际运行,无需安装依赖。第一条命令的标准输出为:
OK: 2 item(s)
退出码为0。第二条命令的标准错误输出为:
FAIL: $[0].owner: missing
$[0].priority: unexpected field
$[0].status: expected todo, doing or done
$[1].due: invalid calendar date
$[1].owner: expected role_a, role_b or null
$[1].status: expected todo, doing or done
$[1].task: expected non-empty string
退出码为1,不能把这批数据继续当作校验成功。结构问题一次汇总;语法错误或重复键会在解析阶段直接失败。命令参数数量错误返回2,文件读取或编码错误同样会明确报告并返回1,没有用空数组掩盖失败。
通过之后,仍要回查原始材料
这段代码能发现“缺少owner字段”,发现不了“原文有三项,结果只整理了两项”。负责人即使在允许名单中,也可能分配错;日期合法,也可能不是原文约定的日期。
因此把失败数据退回修正,把通过的数据与原始材料逐项核对,再决定是否进入业务流程。未知值也不等于已解决:null是待确认信息的明确表示,不是自动安排负责人或到期提醒的依据。本例没有实现事实比对、任务去重、权限控制或生产环境的输入大小限制,结构合规只是其中一道检查。