上线前
先把现状变成可核对的清单
不要从迁移全部应用开始。先选择一条边界清楚、能回滚、能观察结果的业务链路，并记录切换前的运行基线。
- 应用与负责人调用方、业务目的、环境、负责人和变更窗口。
- 模型与协议当前模型、接口类型、关键参数、流式响应和工具调用。
- 凭据与网络Key 持有人、出口路径、代理、防火墙和允许的模型域名。
- 数据分类请求可能包含的个人信息、内部资料、密钥或其他敏感内容。
- 运行基线成功率、错误类型、响应时延、成本和现有告警，由团队定义验收阈值。
协议接入
确认业务真正使用的接口能力
LinkyGateway 当前公开页面说明的接入范围包括以下模型协议。正式迁移前仍应以实际请求验证参数、事件和响应是否满足应用要求。
| 模型生态 | 需要验证的接口 | 重点检查 |
|---|---|---|
| OpenAI | Responses、Chat Completions | 参数、流式事件、工具调用和错误映射 |
| Anthropic | Messages | 消息结构、内容块、工具使用和流式事件 |
| Interactions、generateContent | 内容结构、函数调用、流式响应和安全设置 | |
| 私有模型 | 企业现有兼容接口 | 鉴权方式、能力差异、网络和数据边界 |
如果业务依赖厂商特有能力，应明确选择原生协议转发、受控适配或暂不迁移，避免在兼容层中静默丢失语义。
试点路径
四步完成一条可回滚链路
- 登记资源配置允许的模型、凭据、网络出口和健康检查，禁止未登记资源进入生产路径。
- 接入身份把应用、部门、用户或 Agent 身份映射到模型、数据、工具和预算范围。
- 启用基础策略先启用必要的访问、安全、成本和故障策略，避免首次切换同时改变所有决策。
- 切换单一场景保留原 endpoint 与回滚步骤，逐项比较成功、错误、时延、成本和结果质量。
现状盘点单场景试点治理上线 · 逐步扩展
验收证据
每个结论都要能回到请求记录
| 验收维度 | 需要保留的证据 | 失败时动作 |
|---|---|---|
| 功能 | 关键参数、流式事件、工具调用与原接口一致 | 停止迁移或调整适配 |
| 可用性 | 错误分类、回退目标、切换原因和恢复条件 | 回到原 endpoint |
| 安全 | 身份、策略命中、脱敏或阻断结果 | 收紧范围并复核数据流 |
| 成本 | 模型、Token、缓存、项目归属和预算动作 | 调整模型或预算策略 |
| 观测 | 统一请求 ID、各阶段耗时、上游响应和告警 | 补齐事件后再扩展 |
验收阈值应由企业根据业务风险和现有基线确定。没有真实测量前，不应把演示数据当成生产承诺。