SAG / ARCHITECTURE NOTE

外部采集适配器与 fallback：替代响应何时算成功？

这是将外部服务的输入、错误和原文转换为通用观测的边界。若用示例替代 API 调用失败并标记为成功，就会被误认为实际采集。调用恢复与结果替代并不相同。

SAG编辑 · 2026-10-08 · 更新 2026-10-08

什么是采集适配器？

这是将外部服务的输入、错误和原文转换为通用观测的边界。 本文从输入、转换和输出各自承担的职责来理解采集适配器，而不是把它仅仅看作一个功能名称。要信任分析结果，就必须能够追溯输入了哪些资料、核实了什么，以及结论能够成立到什么范围。

若用示例替代 API 调用失败并标记为成功，就会被误认为实际采集。调用恢复与结果替代并不相同。

返回提供方、条件、原文和有效状态，并区分重试、替代提供方和未观测。示例与实测存储路径分开。

外部提供方 → 通用观测验证 → 实测·未观测

每个阶段都不应把前一阶段的成功称为下一阶段的成果。连续记录资料标识符、时间段和验证状态，就能找到遗漏和错误发生的位置，并确定需要重新核查的范围。

SAG 观测会记录提供方和原文条件。实际调用需要运营连接配置；未连接时使用的示例并非实测。

SAG 的运营价值在于将这些关系连接到页面、问题、对比结果和改进工作。客户不必只看数字，还可以一并审查需要补强的对象和判断依据。对于需要进一步应用的模式，应根据相关段落的范围来理解。

说明用的键未设置表示配置不足，不是排名第 0。若通过获准的替代提供方发起调用，则必须将该提供方和原文作为新的观测记录。

以上示例用于说明结构和计算，并非特定客户的实测成果。实际报告必须关联所选时间段、对象、观测条件和原文记录，才能重新核查同一判断。

请确认在资料为空、资料重复以及条件不同的情况下，含义仍保持一致，而不仅限于正常输入。将验证项目纳入工作完成标准，有助于缩小功能说明与实际运营之间的差距。

更换提供方也可能改变对比条件。必须分别确认恢复成功和条件相同。

外部资料是上述设计主题的背景材料，并不认证 SAG 的所有实现或客户成果。本文的应用解读和说明性示例依据 SAG 运营结构整理。资料核查日期：2026-10-06。