## 周度销售管道汇总与停滞商机预警 {.case data-case-id="018"}

| 字段 | 值 |
| --- | --- |
| 案例编号 | `018` |
| 行业 / 部门 | SaaS / 销售 |
| 角色 | 销售总监 |
| 难度 | `进阶` |
| 调用来源 | `schedule`（定时由获授权 Agent 经 App/Extension 汇总 CRM 商机数据） |

<!-- slot: 目标 -->
周一早会前，销售总监要花半天从 CRM 手工导表拼管道周报，停滞商机更是要等复盘才被发现。目标：每周一早上定时由获授权 Agent 汇总各阶段商机金额与环比，把"停滞超 14 天"或"金额超阈值"的高价值商机单列成预警，经总监确认后分发管理层频道并通知商机 Owner（受控令牌）。指标：周一 09:30 前周报 100% 生成；金额或阶段字段缺失的商机 100% 标"待确认"不猜测；停滞超 14 天商机 100% 出现在当周预警名单里。

<!-- slot: 边界 -->
- **覆盖**：定时汇总各阶段商机金额与环比、按停滞天数与金额阈值筛出高价值停滞商机、总监确认后分发并通知 Owner（受控令牌）、零结果回执、取数失败告警。
- **不覆盖**：自动改商机阶段、自动催办 Owner、销售预测建模、跨产品线合并口径。
- **假设**：有一个经授权能读取 CRM 商机数据的 Agent（通过 App/Extension）；商机含阶段、金额、最近进展日期与 Owner 受控令牌；停滞阈值与金额阈值作为调用输入提供。

<!-- slot: 提示词 -->
把下面这段发给 Loop，它会在后台帮你创建这个 Workflow：

```text
帮我创建一个 Workflow：每周一早上定时由获授权的销售 Agent 经 App/Extension 汇总 CRM 商机数据，按阶段输出商机金额与环比变化，并把"停滞超 14 天"或"金额超阈值"的高价值商机单列成预警名单（含商机编号、阶段、金额区间、停滞天数、Owner 受控令牌）。App/Extension 在读取侧即完成聚合与脱敏，Agent 只接收商机编号、阶段、金额区间、停滞天数与 Owner 受控令牌（权限受控且 Agent 无法反查原值）等白名单字段，不接收客户名称、联系人、联系方式或精确合同金额等原始字段。
触发：定时（计划）发起调用，调用时带入 CRM 数据源的安全引用（令牌化）、停滞天数阈值、金额阈值、管理层频道、销售总监（审批人）与销售 Agent。
结果分流（按优先级从高到低依次判断）：
  存在预警商机：进入销售总监确认，总监能看到各阶段汇总、环比与预警名单（金额以区间呈现，Owner 以受控令牌呈现，由平台在发送侧回填展示）；确认后分发管理层频道，并逐条通知商机 Owner 受控令牌（由下游授权 App 按令牌回填跟进人），均留审计时间戳。金额或阶段字段缺失的商机在名单里标"待确认"，不猜测、不纳入环比计算，单独列出请总监核实。
  本期无停滞商机（汇总成功但预警名单为空）：正常分发各阶段汇总到管理层频道，另发一条"本期无停滞商机"零结果回执并留时间戳，不静默结束。
  取数失败（CRM 不可达或数据陈旧）：告警失败、留审计时间戳，按重试上限重试，仍失败则升级到值班频道；不当作"本期无停滞商机"，也不分发不完整的汇总。
审批：预警名单必须经销售总监确认才分发与通知 Owner（受控令牌），审批本身不设自动超时、无默认通过或否决；驳回则本次失败结束、留审计不发周报，要重发就再发起一次。
异常：销售 Agent 回传不合结构就停在等待点等它重新提交，不自动重跑；通知发送失败按重试上限重试，仍失败则升级到值班频道并保留待发内容供人工补发。
完成：各分支各自出回执后结束，全部留审计时间戳。
```

<!-- slot: 流程 -->
![案例 018 周度管道汇总与停滞预警：定时让获授权 Agent 汇总 CRM 各阶段商机金额与环比；CRM 不可达或数据陈旧按取数失败告警留审计并重试升级，本期无停滞商机正常分发汇总另发零结果回执，有预警商机经销售总监确认后分发管理层频道并通知 Owner（受控令牌，驳回则失败结束不发周报），金额或阶段缺失标待确认，均留审计时间戳；回传不合结构停在原等待点](../../../media/cases/fig-case-018-01-flow.svg){#fig-case-018-01 width=92%}

如上图所示，正常路径、人工决策与异常同时可见，三条结果分支都有可见回执：

1. **定时触发**：每周一早上计划到点发起一次调用，带入 CRM 数据源安全引用（令牌化）、两类阈值、管理层频道、审批人与销售 Agent。
2. **汇总商机**：获授权 Agent 经 App/Extension 汇总各阶段金额与环比，并筛出预警名单；回传结构不合要求时停在原等待点，等其重新提交，不自动重跑。
3. **三路分流**：
   - **有预警商机**：进入总监确认（可见汇总、环比、名单与"待确认"项）；确认后分发管理层频道并逐条通知 Owner 受控令牌，均留审计时间戳。
   - **本期无停滞商机**：正常分发各阶段汇总，另发零结果回执并留时间戳，不静默结束。
   - **取数失败**：CRM 不可达或数据陈旧，告警失败并留审计时间戳，按重试上限重试，仍失败则升级到值班频道。

<!-- slot: 配置 -->
你不需要手写代码或配置。把上面的提示词发给 Loop，AI 会理解意图、在后台画出这个"定时汇总 + 三路分流"流程——它知道"汇总商机"需要一个发消息并等待回调的 Agent 环节、"有无预警"需要一个条件路由、"总监确认"需要一个审批环节、"分发与通知"各需要一个发消息环节，并把它们连起来。停滞天数与金额阈值不用写进流程，调用时作为输入传入，改口径不用改流程。AI 还会在后台校验流程结构是否完整，你不必关心这些技术细节。

<!-- slot: 异常 -->
- **CRM 不可达或数据陈旧**：不当作"本期无停滞商机"，也不分发不完整的汇总；告警失败、留审计时间戳，按重试上限重试，仍失败则升级到值班频道由人工确认。
- **金额或阶段字段缺失**：该商机标"待确认"，不猜测、不纳入环比计算，单独列出让总监核实，避免脏数据污染周报。
- **通知发送失败**：按重试上限重试投递；超过上限则升级到值班频道，并保留待发内容供人工补发。
- **预警名单为空（零结果）**：汇总照常分发，另发零结果回执并留时间戳，让"没预警"变成可核验的记录。
- **销售 Agent 回传不合结构**：本次完成请求被拒绝，停在等待点等其修正后重新提交，不自动重跑。
- **总监驳回**：本次失败结束、留审计不发周报；数据修正后下一周期正常生成，或由总监重新发起一次。

<!-- slot: 审批 -->
预警名单必须经销售总监确认才分发管理层并通知 Owner（受控令牌）——预警名单要指名道姓地找出停滞商机，确认一步既挡住误判（比如刚约了决策人会议被误标停滞），也让总监带着上下文进周一早会。确认时能看到各阶段汇总、环比、名单与"待确认"项。驳回即本次失败不发周报，没有"AI 自动放行"。审批本身不设自动超时，流程停在等待状态；若担心周报压着没人确认，由另一条定时检查的 Workflow 扫出超时项并提醒总监。

<!-- slot: 外部系统 -->
CRM 的商机汇总由获授权 Agent 通过 App/Extension 完成，工作流本身不直接调用外部系统。管理层频道与审批人作为调用输入提供；CRM 的访问凭据用 `<token>` 占位，由 Agent 运行时从密钥引用。进入 Agent 消息、Run/Activation/Effect 记录与 App/Extension 工具日志的字段以白名单为准（仅令牌化/白名单字段，原值不进入以上任何一层），可回溯个人的字段（姓名/邮箱/证件/联系方式等）在源头即被令牌化/伪名化，并按 10% 抽查四层实际记录。CRM 不可达或数据陈旧属于取数失败，走失败回执与升级，不当作"本期无停滞商机"。商机金额与 Owner 属敏感经营数据，通知只带商机代号、编号、阶段、金额区间与 Owner 受控令牌（权限受控且 Agent 无法反查原值，展示名由下游授权 App 发送时回填），最小披露。

<!-- slot: 验收 -->
- **回放集与基准**：取最近 8 周历史商机快照，人工基准答案为按口径整理的各阶段金额表与停滞商机清单；回放并记录汇总、分发时间戳。
- **分母与口径**：环比分母为上一周期同阶段商机总金额；金额或阶段缺失的商机不计入环比，单独计数核对 100% 标"待确认"。
- **指标**：各阶段金额与基准一致率 ≥ 99%；停滞超 14 天商机 100% 出现在当周预警名单（召回率 100%）；周报 100% 在周一 09:30 前生成；预警名单误报率 < 5%。
- **源头脱敏**：进入 Agent 消息、Run/Activation/Effect 记录与 App/Extension 工具日志的字段 100% 在白名单内（仅令牌化/白名单字段，原值不进入以上任何一层），并按 10% 抽查四层实际记录。
- **零结果与失败**：零结果周 100% 出回执不静默；取数失败 100% 出告警回执并留审计，无一例被当作零结果分发。

### 复用与变体
- **同构迁移**：招聘管道周报（候选人阶段停滞预警）、客户成功续约管道预警、渠道商进货节奏周报。
- **改阈值**：停滞阈值或金额阈值调整时只改调用输入，不动流程；也可对高客单价阶段单独设阈值。
- **写回 CRM**：确认后再加一个 Agent 环节，由获授权 Agent 经 App/Extension 给可信 CRM 中的预警商机打上"已预警"标记（仅预警标记这一业务维度），以商机编号加周期为稳定幂等键、响应未知先查后写，配有限重试、升级、待处理与审计，避免下周重复单列。

<!-- slot: 媒体槽位 -->
<!-- media: fig-case-018-01-flow.svg -->
