DP

DepthPilot AI

System-Level Learning

Assessment

输出契约实战:把结果做成接口,而不是做成一段看起来像 JSON 的话

这一课要求你把一个真实任务改造成机器可验证的输出接口。DepthPilot 关心的不是“模型会不会吐 JSON”,而是字段、类型、失败路径和下游消费方式是否已经明确。学完后你要交的是 contract spec、schema review 结果和失败策略,而不是一句“我已经要求它输出 JSON”。

最后要交什么

一份 output contract spec、一份 schema review checklist 结果,以及一套明确的失败策略。

真正的通过标准

不是模型大多数时候像 JSON,而是下游系统可以不靠猜测地验证字段、拒绝坏结果、并决定何时重试或停止。

我们的增值部分

这页把 framing 顺序、contract ladder、常见坏 schema 模式和交付模板变成了站内 runbook。

Framing order

先判断这到底是数据返回任务,还是工具动作任务。

先明确下游系统需要什么字段、什么类型、什么失败语义,再写 prompt。

把 style、policy 和 schema 分开,别混成一段模糊要求。

最后才决定该用 response schema 还是 function calling。

Contract ladder

先写字段表和约束,再写例子,不要反过来。

为每个高风险字段写必填、枚举或范围约束。

明确什么叫 invalid output,失败时系统要 loud fail 还是 retry。

用最小样例验证解析成功并不等于语义正确。

High-signal bad patterns

只写“请返回 JSON”,却没有字段、类型和失败规则。

输出契约明明给机器消费,却塞进大量自由文本说明。

应该调用工具的任务却先做成结构化回答,导致后续还得再猜。

把 validation failure 静默吞掉,坏结果继续进入系统。

上线前必须保留的证据

一份字段、类型、必填项和约束都写清楚的 contract spec。

一份 schema review 结论,说明哪里会让下游继续猜。

一组样例,证明 success 和 failure 都可被系统识别。

一段你自己的复盘:这个任务为什么不该继续依赖自由文本输出。

Search Cluster

把输出契约接进可搜索的可靠性路径

高意图用户常常先从 structured outputs、prompt engineering、workflow course 进入,再决定是否做真正的契约设计和验收。

参考附录

这些来源是方法锚点。课程主体是上面的 framing order、contract ladder、坏模式识别和交付模板。

输出契约实战:把模型结果变成可验证接口,而不是继续猜意思 | DepthPilot AI