AIAI学习站
继续学习
本章进度 13 / 18
72%
Prompt 工程·理解·10 分钟
正文已完成

输出格式其实是一份接口契约

理解字段、类型、必填项和失败返回怎样决定结果能否被下一步使用。

L108
为什么现在学

先用本课建立“格式约束”的基本直觉，后面的判断和练习才不会只靠记结论。

本课会用什么
  • 无需安装新工具
  • 直接阅读并完成本页理解检查

输出不是只给人阅读时，格式就不再是审美偏好。字段名、数据类型、缺失值和错误返回会决定结果能否进入表格、程序或下一位协作者。

这一课的结果

能用接口契约视角解释为什么“请用表格输出”仍然不够明确。

核心概念

先把关键判断说清楚

01

形状与含义缺一不可

字段名规定形状，字段说明规定含义；只有 `score` 而不说明范围和依据仍不可用。

02

缺失值要显式

用 null、空数组或待确认状态表示缺失，不能让模型为了填满格式而猜。

03

失败也是合法响应

输入不完整或无法判断时，应返回规定的错误结构，而不是破坏 Schema。

案例拆解

“用表格列行动项”为何导入失败

不同运行有时输出三列，有时把日期写进事项文本，自动导入无法稳定解析。

  1. 01

    固定字段为 task、owner、due_date、evidence、status。

  2. 02

    规定 due_date 使用 YYYY-MM-DD，原文无日期时为 null。

  3. 03

    无法确认负责人时 status=needs_review，并在 evidence 保留原句。

案例结果

格式同时规定了字段、类型和不可判断时的返回，自动导入不再依赖人工猜列。

提交前练习

现在轮到你

把一个“用表格或 JSON 输出”的旧要求改成接口契约。

选做练习：本节练习可用于加速你巩固，但不影响继续学习。

内容会自动保存在当前设备
查看参考答案与评分标准

参考答案

字段，claim=string，source_quote=string，confidence=high|medium|low，status=verified|needs_review；source_quote 缺失时为 null 且 status 必须 needs_review；解析失败返回 error_code 和 missing_fields。

评分标准

  • 字段语义和类型齐全
  • 缺失值不会诱导模型猜测
  • 失败响应保持固定结构

本课收口 · 理解检查

用 30 秒确认你理解了

用 30 秒理解检查确认你抓住了重点；阅读标记、练习和总结都不设硬门槛。

0 / 1
02完成练习（选做）0 / 3 项已填写，不影响完成03通过理解检查点此去回答，约 30 秒
04补一句总结（可选）可以留空，不影响完成本课。
下面哪项最能防止模型为填满字段而编造？
你现在更接近哪一种状态？
尚有必填项未完成，请补齐后再继续。

资料来源

继续核对与延伸阅读

本课内容最近更新于 。