模型适配层

把供应商消息、流、工具和usage转换为应用可控接口。

模型适配层让应用用稳定接口处理不同供应商，但不能把差异抹平。接口通常覆盖message、tool request、tool result、structured output、usage、error、stream和cancel；同时保留受控native扩展。企业可以更换模型服务，而不必重写业务工具和证据数据模型。

OpenAI Agents SDK公开Model接口要求工具调用有稳定非空call ID，并提供provider资源管理与重试建议边界。这比把base_url替换后请求成功更具体。真实兼容还涉及消息角色、工具结果序列、并行调用、finish reason、refusal、reasoning参数以及断流后能否安全恢复。

内部事件模型应区分文本delta、完整工具调用、usage更新、最终输出和错误。不要假设所有供应商在同一时刻给出完整参数，也不要把未知停止原因默认为成功。原始provider metadata可受限保存，统一字段用于业务逻辑；缺少信息应标未知，而不是虚构一个默认值。

能力检测与适配分开。adapter转换协议，capability registry记录某模型能否使用严格schema、原生搜索、缓存和compaction。不能支持的能力应明确失败或降级，例如改用应用检索，而非静默丢弃工具。跨模型的opaque reasoning状态通常不可移植，需要从可读事件和证据重建输入。

连接池、WebSocket生命周期、超时和关闭同样属于adapter。失效连接的自动恢复要受业务重放合同约束；已产生工具效果后不能盲目重送整个请求。usage映射应保留缓存读写和输出分类，才能与账单核对。

契约测试使用同一组非敏感样例覆盖中文参数、日期、数值、多工具、空输出、拒绝、截断与取消，再在真实harness任务上评估。通过协议测试只说明接口能工作，不说明该模型足以完成金融、教育或法律任务。

适配错误应独立归因。例如一个模型没有返回usage，并不意味着本次费用为零；缺少某种finish reason也不能转换成正常完成。应用应保留未知，供监控和计费对账处理，避免统一接口制造错误确定性。

实践重点：统一基础事件，保留native能力与错误；管理连接和关闭。

验证抓手：对工具、schema、stream、取消与token核算跑conformance。

常见误区：base_url能回答你好就认定完整Agent兼容。

Agents SDK：Model接口和call ID约束；OpenAI Agents SDK：模型与provider。