vpp-ai-platform/docs/07-scenario-walkthrough.md

# 07 · 端到端参考场景：日前现货申报

本篇用一个完整业务日验证 00–06 的全部构件。时间线中的市场时点为**占位假设**，
需按湖北现货实际规则修正（见文末待补充清单）。

**场景设定**：D-1 日，平台为 D 日的现货市场生成并提交申报（代理购电 + 虚拟电厂可调资源），
D 日执行与监测，D+1 复盘。

## 时间线

### D-1 06:00 · 周期触发：日前态势报告

1. Runtime 周期触发器实例化「日前态势」流程模板（不经 LLM 意图解析——周期任务直达模板）；
2. **智能分析 Agent** 调用工具：负荷预测（96 点 + 区间）、光伏预测、电价预测；
3. 异常检测扫描昨日遥测；归因工具解释显著波动（如「明日高温，空调负荷预计 +12%」）；
4. 产出 `SituationReport`（含风险等级）→ 事件总线 → 运营看板 + 下游 Agent。

*验证构件：周期触发、P2（预测数字来自工具）、对象化通信。*

### D-1 07:00 · 资源画像核定

1. **资源调度 Agent** 被 `SituationReport` 事件唤醒（流程模板：申报前容量核定）；
2. 调用可调潜力辨识：结合最近执行反馈（画像时效性约束），核定 D 日分时可调容量与置信度；
3. 更新 `ResourceProfile`；发现某储能站 SOC 异常 → 容量核减并标记，产生告警事件。

### D-1 08:00 · 申报策略与报价优化

1. **交易博弈 Agent** 启动申报流程模板：
   - RAG 检索规则库（当前生效版本的申报规则、价格上下限）；
   - 读取 `PositionLedger`：月度合约持仓 → 日前申报电量边界（P7 约束级联）；
   - 组装优化输入：电价预测区间、核定可调容量、持仓约束、风险偏好参数（配置项，人工维护）；
2. 调用**报价优化 MILP**：输出 96 点申报曲线 + 预期收益分布；
3. LLM 生成申报说明（策略解释，供审批人阅读），**数字原样引用求解器输出**；
4. 组装 `Proposal{type: BID, timescale: DAY_AHEAD}`，血缘含全部工具调用与账本版本。

### D-1 08:30 · 可信执行链

1. **规则校核**：申报格式 ✓、价格限值 ✓、账本一致性 ✓、血缘完整性 ✓；
2. **仿真验证**：收益情景回测——千组价格情景，极端亏损在容忍带内 ✓；
3. **包络检查**：本日申报曲线落在已批准的申报包络内（价格偏离预测基准 < 容差、电量在持仓偏差带内）→ `AUTO_APPROVED`；
   - *对照分支*：若明日有极端天气、优化结果越出包络 → `PENDING_HUMAN`，交易员在工单台看到申报说明 + 血缘展开 + 仿真结果，批准/修改/驳回；
4. 提交前**现势复核**：重验资源在线与账本一致 → 签发 `ExecutionPermit` → `AUTHORIZED`；
   - *对照分支*：若批准后某储能站离线 → `STALE`，容量核减后重走校核（03 篇 §2.2）；
5. `RELEASED` → 交易平台适配器凭许可提交申报；回执写入事件日志。

*验证构件：状态机全路径、包络自治、降级路径（若接口故障 → 导出文件人工上传）。*

### D-1 16:00 · 出清结果处理

1. 交易平台适配器收到出清：中标计划 + 出清价格 → 写 `PositionLedger`（日前层）；
2. 事件触发**资源调度 Agent**：中标计划分解 → 聚合/调度优化 → 调度方案 `Proposal`；
3. 走可信执行链（控制类：功率平衡仿真）→ 批准后执行引擎分解到聚合单元，
   连同包络参数下发边缘终端（本地副本原子更新）。

### D 日 · 执行与日内修正

1. 边缘终端按 96 点计划就地闭环执行，秒级；遥测经边缘预处理上送；
2. 10:42 某工业用户实际负荷偏离计划超阈 → 执行引擎**确定性快速路径**：
   聚合单元包络内再平衡（储能补偿），同时发事件给认知平面；
3. **负荷控制 Agent**（慢路径）生成日内修正计划 `Proposal` → 校核 → 仿真 → 包络内自动批准 → 更新设定值序列下发；
4. 若修正需突破包络（如需调用未承诺用户资源）→ 升级人工，同时**交互服务 Agent** 生成临时邀约 Proposal（默认人工审批的对外动作）。

*验证构件：P1 快慢路径分离、边缘自治、跨 Agent 协作全部经对象与事件。*

### D+1 · 计量到达，偏差复盘

1. 计量数据接入 → 触发复盘流程（智能分析 Agent 主导的跨 Agent 模板）；
2. 逐尺度对比账本：计划 vs 实际（申报 vs 出清 vs 执行 vs 计量）；
3. 归因工具分解偏差：预测偏差（高温敏感度低估）/ 响应偏差（用户 X 履约率 82%）/ 控制偏差；
4. 产出 `ReviewFinding` 回写：
   - 语义记忆：「高温日空调负荷预测系统性偏低 → 特征工程候选」；
   - `ResourceProfile`：用户 X 可靠性评分下调；
   - 包络建议：本月包络内执行 26/26 达标 → 建议价格容差放宽（触发包络重审工作流，人工批准生效）；
5. 报告生成 Skill 产出复盘报告，推送运营看板。

## 覆盖矩阵

| 构件 | 覆盖时点 |
|---|---|
| 三类任务触发 | 周期(06:00/复盘)、事件(出清/偏差)、人工(审批分支、专题追问) |
| 五类智能体 | 分析(06:00)、资源(07:00/16:00)、交易(08:00)、交互(D 日邀约分支)、负荷控制(D 日修正) |
| Proposal 状态机 | AUTO_APPROVED、PENDING_HUMAN、RELEASED→EXECUTING→COMPLETED |
| 持仓账本级联 | 月度→日前(08:00)、日前→日内(D 日)、对账(D+1) |
| 快慢路径分离 | 10:42 偏差处置 |
| 复盘回写三处 | 记忆/画像/包络 |

## 【待补充：湖北现货市场关键参数 —— 需要业务侧输入】

> **TODO(业务)**：本场景的时间线与规则细节按以下清单修正后，才能作为评审/开发的权威版本：
>
> 1. 日前申报窗口的实际开启/截止时间；出清结果发布时间；
> 2. 申报品种与格式：代理购电申报与虚拟电厂（可调资源）申报是否同一通道、是否分开建模；
> 3. 日内市场/滚动调整的实际机制（湖北是否开日内、频次、截止规则）；
> 4. 偏差考核规则：偏差带宽度、考核价格机制（直接决定报价优化的目标函数与风险测算口径）；
> 5. 中长期持仓对日前申报的实际约束形式（分解曲线偏差带的具体规定）。