AIGuide中文教程 · 独立阅读版
先验证输出，再让应用使用它
在本地练习台检查正常数据、缺失字段和内容错误，设计失败处理。
进入互动版，练习并保存成果开始前准备
先读API调用链课程，了解JSON对象与数组。本练习在当前页面完成，不需要API Key或模型账户。
1. 先约定业务数据
模型服务有自己的响应格式；你的应用也需要约定从文本中解析出的业务对象。这是两层检查。这里假设已经取出模型返回文本，只检查其中的任务对象。
owner、due缺失时显式写null；这比漏掉字段更方便调用方处理。空任务数组是合法数据，但不能当作创建了一个任务。
输出校验练习（本地模拟，不调用模型）
业务：把一条通知整理为任务列表。
输入示例：小林周五前整理报名表，活动地点未定。
返回结构：{"tasks":[{"title":"整理报名表","owner":"小林","due":"周五前"}],"questions":["活动地点"]}
约束：tasks为数组，每项只含title、owner、due；title为1至200字的非空文本；owner、due缺失时为null；questions为非空文本数组。
长度：最多20个任务、20个问题；每个文本最多200字；原始响应最多12000字符。
空任务：tasks可以为空，但不能把无任务结果当作任务创建成功。
边界：结构校验不能证明事实正确，仍需对照原通知。
处理方案：格式错误不继续写入；401检查认证；429按服务说明有限等待；超时记录为结果未确认。2. 亲手试三种返回结果
先用有效数据检查一次；再填入缺少字段的数据，观察due缺失的提示。最后选择事实有误，看看结构校验为什么仍能通过。
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、工具执行及结果回传