# 方案取舍记录

在比较系统方案、准备试点或条件改变时使用。只记录影响选择的差异；不把全部技术清单填满。依据见[架构](/methods/architecture)。

## 可填写结构

- 任务与成功证据：谁完成什么，哪个业务结果证明成功。
- 已知约束：事实来源、授权、速度、错误后果与可接管方式。
- 候选方案：至少保留现实基线；分别说明解决的缺口与新增负担。
- 当前选择与理由：决定性条件，而不是技术流行程度。
- 验证与改变条件：用什么任务比较，什么结果会使选择变化。
- 关联版本：数据、规则、模型、工具及负责人。
- 外部服务与退出：发送哪些数据，保留与训练用途，处理区域与下游处理方，删除／导出办法，版本和切换条件；未确认项保留为`unknown`。

## 填好样例：合成卡片配送客服

任务：客户查询卡未收到，取得可信状态，完成必要调查或带上下文转人工。成功证据：状态有后台事实ID，后续动作有业务记录；查询结束不等同补卡完成。

约束：已有认证和配送API；地址修改需客户确认；后台故障时有客服接续。暂用合成任务集测试，不设公司实际指标。

| 候选 | 能解决的问题 | 新增负担 |
| --- | --- | --- |
| 状态页面 | 可靠展示配送状态 | 复杂例外仍靠人工 |
| 固定调查流程＋模型表达 | 解释状态并完成已知分支 | 维护例程与错误输出 |
| 有界工具选择 | 随客户回答选择调查路径 | 额外测试循环与停止 |

当前选择：先用固定流程加模型表达；已知分支足够覆盖首期范围，补卡由确认界面和业务API执行。保留状态页面作为失败回退。若多类真实例外无法合理列举，再比较有界工具选择。

验证：在同一30条合成任务上比较状态页面与流程方案；含地址未变、配送过期、工具超时、用户取消和转人工。记录错误类型、用户往返与耗时。30条是教学样本，不支持生产成效估计。

改变条件：流程遗漏导致无法继续、模型反复追问、恢复无法解释时先修流程和契约；只有确认瓶颈来自路径动态性时才增加模型自由度。关联：`delivery-demo-1`、例程v2、工具v1；示例负责人为角色“产品负责人／接口负责人”。

完成判断：另一位评审能解释为何当前方案优于基线，并指出哪些证据会推翻它。此样例只做文档推演，未运行模型或业务系统。

## 外部服务试填：商品建档的两个候选

本例对应[商品建档练习](/examples#商品建档实操包)：`case_id=CATALOG-01`、`task_id=CAT-017`、`dataset_version=2026-10-09.1`，为SUP-08／SKU-017便携杯读取规格、形成草稿、由人确认并保存，不发布。下面的服务A、B及条款都是合成候选条件，不代表实际供应商政策；与上面的卡片配送例分开。

业务边界先固定：模型只接收获准规格摘录和任务规则，返回字段、来源与缺项；商品身份、草稿确认和写入由应用控制。联系人、成交价和无关供方文件不发送给模型服务。

| 影响选择的条件 | 服务A：企业API候选 | 服务B：共享文档助手候选 |
| --- | --- | --- |
| 发送的数据 | 应用先抽取SKU-017的获准规格段落；不上传整份文件 | 默认上传整份PDF；必须先移除联系人与无关条款，才符合本任务输入边界 |
| 保留 | 请求内容不写供应商持久日志；运维元数据保留7天；应用自行保存字段来源与确认版本 | 上传文件和会话默认保留30天；删除后备份清理时间`unknown` |
| 训练与改进用途 | 拟定合同明确请求内容不用于模型训练，也约束下游处理方 | 界面有关闭训练选项；合同是否涵盖支持人员及下游用途`unknown` |
| 处理区域与下游处理方 | 推理与运维元数据限定在合成区域CN-East；列明计算基础设施处理方A-Infra-1，变更需通知 | 自动路由的实际处理区域、OCR处理方与跨区域备份`unknown` |
| 导出与删除 | 任务、输入引用、草稿、状态及版本由应用导出JSON；服务返回元数据删除回执，备份7天到期清理 | 能下载草稿文本；来源定位、任务状态及批量删除接口`unknown` |
| 版本、限流与恢复 | 固定模型快照`a-text-2026-09-28`；示例限流30次／分钟，429带重试时间，超时保留原任务 | 模型版本滚动更新，快照不可锁定；限流与变更通知条件`unknown` |
| 接入负担 | 维护模型适配器、摘录器和本地任务存储；保留人工录入原流程 | 上传步骤少，但需要补数据过滤与来源导出；不开放助手直接写商品权限 |

**当前取舍。** 选择服务A这类可控制数据范围的API形态作为接入候选，先用离线练习检查任务边界；本地练习使用确定性规则与合成回执，没有连接服务A或B。服务B的默认上传范围不合适，且区域、用途和删除条件未定，暂不用于真实供方材料。真实接入还需核对服务A的拟定条件，并由业务材料owner确认供方资料授权与应用保存期限；后两项当前均为`unknown`。

**验证与改变条件。** 在同一版本练习上检查正常资料、缺项、冲突、材料改版和写入未知，核对输出是否保留来源、未确认字段和已接受约束。替换服务后再跑同一组任务；不能因字段能解析就认定语义质量通过。若区域、训练用途或下游处理方变化后不能重新确认边界，停止发送新增真实材料；若新版本不能通过任务回归，保留原快照或转人工流程。

**退出的具体动作。** 应用停止新增模型请求，导出CAT-017的材料引用、已确认草稿、版本与状态；`write_unknown`继续按原业务键查询，由负责人接续，不能换服务后重复新建。撤销服务凭据，关闭上传入口，取得适用的删除回执并记录备份到期时间；应用内业务记录按自身期限处理。任务与状态由应用掌握，换模型服务不要求重新调查已确认事实。接续步骤见[迁移与退出](/methods/transfer-exit)。

## 商品任务怎样接到本表

参见[CAT-017发现与产物接续](/downloads/examples/product-catalog-workshop/discovery-to-design.md)，用于把商品工作蓝图转成候选架构。本表原有配送、调价等样例保留为不同条件的对照；不要把它们的字段、动作或数字直接当成CAT-017配置。填写后标明输入依据、产物版本、接收者与尚缺证据。

## 保存完整上下文的入口

[商品构建练习](/downloads/examples/product-catalog-workshop/construction.md)维护实际装配文件及候选适配边界；本表只记录为何这样选。修改模型或适配器时保留原始请求、响应、校验结果与输入版本，不在此复制第二套Prompt。