选型指南 架构设计 含可复制代码

把外部依赖管起来:供应商变更与退出预案

目录层用 SSG 加 ISR 拿收录,工具层用一份 JSON Schema 承接 91 个站内工具,密钥、计费与限流全部收口在国内业务后端,模型调用统一走一层薄适配。这篇把我们真实的目录结构、Schema 字段定义、路由闸门、预扣结算伪代码和合规清单完整摊开。

陈
陈默架构组
2026-09-28 · 14 分钟阅读 · 8,432 次浏览

没有退路方案的致命依赖,就是单点故障。

外部依赖是"会变的"

AI 功能几乎都依赖外部:模型服务、向量库、爬虫源、云厂商 ✔。

这些依赖会涨价、改接口、限流、下线 ✔ —— 如果没准备,某天早上系统就会大面积挂掉 ✔。

把外部依赖当风险来管 ✔:登记、监控、留退路 ✔。

一、依赖登记表(一张表能省很多事)

```

依赖名 | 用途 | 关键程度(致命/可降级/可替换 ✔)

| 当前版本/接口 | 计费口径 | 变更通知渠道 | 退路方案 | 负责人

```

要点:关键程度与退路方案最常被省 ✗ ——

没有退路方案的"致命依赖",就是单点故障 ✔。

二、四类变化的应对

| 变化 | 应对 |

|---|---|

| 涨价 | 成本上限告警;准备替代方案;按档位切换 ✔ |

| 接口变更 | 版本锁定 + 变更前灰度;沙箱先验 ✔ |

| 限流收紧 | 配额与排队;多供应商分流 ✔ |

| 服务下线 | 提前迁移(这是最需要预案的 ✔) |

"多供应商分流"是最实用的退路 ✗→✔:同一能力接两家 ✔,

平时按比例或按档位分流 ✔,一家出问题时能快速切换 ✔。

三、必须提前做的三件事

1. 抽象层 ✔:业务代码不直接调某家 SDK ✗ → 中间加一层适配 ✔(换供应商只改适配层 ✔);

2. 契约测试 ✔:用同一批样本测两家供应商,确认行为差异在可接受范围 ✔;

3. 切换演练 ✔:真的切一次(见断上游演习那篇 ✔),确认链路能跑 ✔。

四、监控什么

· 各依赖的错误率与延迟(分供应商 ✔);

· 配额使用率与限流触发次数 ✔;

· 计费口径变化的异常(单位成本突然抬升 ✔);

· 官方变更公告(订阅渠道,别靠新闻 ✗)。

五、一条务实建议

```

对每个"致命依赖"问三个问题:

① 它今天挂了,我们能撑多久?(小时/天 ✔)

② 有没有第二家能接?(有 → 演练过吗 ✔)

③ 迁移要多久?(人日量级 ✔ —— 超过一周就要提前立项 ✔)

```

判据

> 你的主力模型供应商明天宣布下线 ✔,你能否在两周内完成切换 ✔ 且质量不降 ✔?

> 答不出,说明外部依赖还只是"用着",没有被管理 ✗。

本文由云枢 AI导航整理,内容以官方来源为准。

相关文章

顺序阅读

← 上一篇:AI 功能的错误码设计:给机器看也给用户看
下一篇:把评测接进日常:四种改动各自的检查清单 →

第 117 / 171 篇

术语速查 · 本页出现的 12 个词展开看中文名与一句话解释,点术语看完整条目
  • token词元:模型处理文本的最小单位,中文约 1–2 个汉字;计费与上下文长度都按它算。
  • 转写 / 字幕Transcription:把音视频人声逐句变成带时间戳的文字稿,便于做字幕与章节切分。
  • SSE服务器发送事件:服务器通过长连接持续推送增量文本,是对白逐字出现的常见实现。
  • API应用编程接口:程序之间约定的调用方式;站内工具由服务端调用,浏览器里不出现密钥。
  • CDN内容分发网络:把静态资源缓存到离用户更近的节点,缩短加载时间。
  • 缓存Cache:把结果暂存复用,复用得越多平均耗时越低;需要约定过期与刷新策略。
  • 限流Rate Limit:限制单位时间内的请求次数,防止单用户或异常流量打满服务端。
  • SSG静态站点生成:构建阶段就生成 HTML,访问时直接返回,不必每次请求都渲染。
  • ISR增量静态再生:先返回静态页,再在后台按需重新生成,兼顾速度与更新时效。
  • 灰度发布Canary Release:先让一小部分用户用新版本,确认无误再放量,出问题的爆炸半径最小。
  • 提示词Prompt:交给模型的指令文本;写清角色、任务、输入与输出格式比反复试更省。
  • 积分Credits:站内计费单位:按工具单价预扣,调用失败自动退还;单价以定价页为准。

完整解释与站内出现处见 AI 术语表(40 条)。