模块 1模型原理与 Agent 基础

结构化输出契约

从消费者失败方式反推 Schema

典型消费者

  • 前端动态组件
  • Workflow 分支
  • 写入 API
  • 下游 Agent

自由文本进入程序的风险

  • 解析歧义
  • 字段缺失和类型漂移
  • 协议文本混入解释
  • 消费者静默猜测

Schema 不只是字段类型

结构约束

  • object、array 与基础类型
  • required、enum、范围和长度
  • additionalProperties

语义约束

  • 字段名与描述
  • 单位、时区和格式
  • 缺失、null 与默认值
  • 可判别联合类型

跨字段业务不变量

  • 不能只靠 JSON Schema
  • 需要领域校验器或确定性代码

选择生成模式而不是迷信 JSON

  • JSON Mode 只保证语法形态时的边界
  • Structured Output 对 Schema 的支持范围与限制
  • Tool Call 适合动作意图，不自动代表已执行
  • 复杂 Schema 可能降低成功率并增加 Token

四层校验链不能合并

传输完整性

  • 流是否完成
  • 是否截断

JSON 解析

  • 编码和转义
  • 重复键策略

运行时 Schema

  • TypeScript 类型不能替代运行时事实

业务语义

  • 引用对象存在
  • 权限与状态允许
  • 数值和时间关系合法

修复策略必须避免静默数据腐化

  • 可重试的格式错误与不可重试的业务冲突分开
  • 把明确的校验错误回注模型，而不是模糊说“重试”
  • 关键字段缺失时拒绝猜测
  • 限制修复次数并保留原始输出与错误证据

生产者和消费者需要协同演进

兼容变更

  • 新增可选字段
  • 扩展枚举前检查旧消费者

破坏性变更

  • 显式版本
  • 双读、适配与迁移窗口
  • 回滚时同时考虑模型 Prompt、Schema 和消费者版本

用三类测试证明契约可用

  • Schema 与领域校验器单元测试
  • 模型正常、边界、截断和对抗样本回归
  • 消费者契约测试与未知字段测试
  • 指标分开记录解析率、Schema 合法率和业务正确率