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

把 AI 输出接到业务系统:三种接线方式与各自代价

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

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

自动化程度不是越高越好,而是要与「写错的后果」匹配。

三种接线方式

AI 的输出最终要进入业务系统。常见接线方式有三种,代价完全不同:

| 方式 | 做法 | 代价 |

|---|---|---|

| 人工确认后写入 | AI 给建议,人点确认才落库 | 慢、要人盯;但最安全,适合高影响字段 |

| 校验后自动写入 | AI 直接写,但先过严格校验 | 需要把校验写扎实,否则脏数据进库 |

| 全自动直写 | 不校验,直接写 | 只适合低影响、可回滚的场景 |

选哪一种,取决于三件事:写错的后果有多大、能不能回滚、有没有旁路校验。

校验要写成"拒绝的理由"

· 逐字段校验类型与范围(金额、日期、枚举、外键存在性);

· 交叉校验(开始时间 ≤ 结束时间、总额 = 明细之和);

· 业务规则(这条记录是否与已有记录冲突);

· 不通过就拒绝整条,不要把"半个结果"写进去。

拒绝时返回可读理由,让人能一眼看出该改哪里;同时把这条样本收进评测集。

幂等与去重

自动写入最常见的坑是重复写:重试、并发、消息重投都会导致同一条被写多次。

· 用业务唯一键做幂等键(不是自增 id);

· 写之前先查、写之后校对;

· 允许"重复执行结果一致"(例如 upsert 语义),比"保证只执行一次"更现实。

可回滚

· 每次自动写入记录来源(哪次 AI 调用、哪个版本、什么时间),出问题能批量回滚;

· 高风险字段先写入"待审区",进入正式表前留一个人工窗口;

· 有反向操作(撤销/冲正)比"事后改数据"更可靠。

上线前的检查清单

1. 每个自动写入的字段,问一句"写错了会怎样";

2. 校验规则写成测试用例(正例 + 反例);

3. 幂等键选好;重复投递演练一次;

4. 记录来源版本,验证能按批次回滚;

5. 观察"拒绝率"——它突然升高通常意味着上游格式变了。

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

相关文章

顺序阅读

← 上一篇:多轮对话的上下文管理:摘要、锚点与按需检索
下一篇:检索质量差,先别怪模型:文档解析与切分的五个检查点 →

第 16 / 171 篇

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

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