AIGuide中文教程 · 独立阅读版
先验证输出，再让应用使用它
在本地练习台检查正常数据、缺失字段和内容错误，设计失败处理。
进入互动版，练习并保存成果本篇目录
开始前准备 · 设备、账号与费用
先读API调用链课程，了解JSON对象与数组。本练习在当前页面完成，不需要API Key或模型账户。
1. 先约定业务数据
本课检查从模型文本中提取的业务对象；先看图中的字段，再展开完整约定。
- tasks：任务
title：事项 owner：负责人 due：时间
- questions：问题
原文没有明确的信息 留作待确认
本站教学结构，不是厂商原始响应。
tasks 与 questions 都是数组。 负责人或时间未知时，保留字段并填 null。
展开完整内容
输出校验练习（本地模拟，不调用模型）
业务：把一条通知整理为任务列表。
输入示例：小林周五前整理报名表，活动地点未定。
返回结构：{"tasks":[{"title":"整理报名表","owner":"小林","due":"周五前"}],"questions":["活动地点"]}
约束：tasks为数组，每项只含title、owner、due；title为1至200字的非空文本；owner、due缺失时为null；questions为非空文本数组。
长度：最多20个任务、20个问题；每个文本最多200字；原始响应最多12000字符。
空任务：tasks可以为空，但不能把无任务结果当作任务创建成功。
边界：结构校验不能证明事实正确，仍需对照原通知。
处理方案：格式错误不继续写入；401检查认证；429按服务说明有限等待；超时记录为结果未确认。null 与漏字段有什么区别？
null 表示已检查，但原文没给信息；漏字段表示对象没有按约定交付。tasks 可以为空，但不能把它当作已经创建了任务。
2. 亲手试三种返回结果
依次填入一个示例，点“检查这份数据”，再对照原通知。
- 有效数据：确认结构通过。
- 缺少字段：找到缺失的 due。
- 事实有误：结构虽通过，负责人仍需从小陈改回小林。
原通知：小林周五前整理报名表，活动地点未定。
本站教学样例 · 不调用模型，不是厂商原始响应。
有效数据
{
"tasks": [{ "title": "整理报名表", "owner": "小林", "due": "周五前" }],
"questions": ["活动地点"]
}结构符合约定：负责人是小林、时间是周五前；地点仍待确认。
缺少字段
{
"tasks": [{ "title": "整理报名表", "owner": "小林" }],
"questions": ["活动地点"]
}结构不符合约定：缺少 due 字段。本例原文有“周五前”，应补回；原文没给时间时才填 null。
事实有误
{
"tasks": [{ "title": "整理报名表", "owner": "小陈", "due": "周五前" }],
"questions": ["活动地点"]
}结构符合约定，但事实有误：“小陈”是合法文本，所以通过格式检查；原文负责人是“小林”，仍需纠正。
3. 把校验放在服务端
服务端先检查，合格后再进入业务；这个前端练习台只用于学习。
- 解析 JSON
解析失败就停止
- 检查结构
字段、类型、条数与长度
- 核对事实
对照原文，再决定使用
JSON 或字段错误？
停止业务写入，保留脱敏错误，修正后再检查。
认证、额度或超时错误？
401 核对认证；429 按文档区分限流与额度；超时先核对任务状态，避免重复操作。
结构正确，但内容有误？
对照原文纠正负责人、时间与引用，不能只凭格式通过就发布。
4. 保存接入与校验方案
写出你的应用需要哪些字段、如何处理失败、哪些事实还要核对。选择具体厂商后，再依据该厂商的当前文档接入服务，记录实际调用结果。
练习与核对
- 分别检查有效、缺字段和事实有误三种数据
- 解释结构校验无法覆盖的事实问题
- 保存失败处理与服务端校验方案
按实际操作自查，完成标记与成果草稿请在互动版保存。
打开练习与核对带走这一点
收到模型文本只是中间一步，业务数据需要经过明确校验。
资料与核对记录
本站通用练习这是一篇本站编写的通用方法与练习，官方资料用于解释产品关系和使用条件；日期反映所引用来源的最近核对。
练习提示、预期结果与检查表不代表官方承诺，也不代表在所列软件中逐一实操通过。
查看来源与日期
- OpenAI 官方 Node SDK
已核对资料 · 获取：2026年9月14日 · 来源更新：未披露
Responses 请求、环境变量及 output_text
- Claude Python SDK 使用示例
已核对资料 · 获取：2026年9月14日 · 来源更新：未披露
Messages 调用与 content 读取
- Claude SDK：Message 响应类型
已核对资料 · 获取：2026年9月14日 · 来源更新：未披露
content 内容块及 stop_reason 字段
- GLM Function Calling
已核对资料 · 获取：2026年9月14日 · 来源更新：未披露
工具定义、tool_calls、工具执行及结果回传