vpp-ai-platform/docs/07-scenario-walkthrough.md
stewart hu 11f19a661a Integrate peer review findings into architecture docs
- 01: add eight testable hard invariants (self-approval ban, duty
  separation, digest-bound approvals, permit-only effects, LLM-less
  degraded operation)
- 03: approval staleness model — proposal digest, FRESH_CHECK/STALE
  states, APPROVED→AUTHORIZED split with revocable ExecutionPermit;
  gateways accept permits, never bare plans
- 05: rules packaged as versioned, testable Policy Packs pinned in
  proposal lineage
- 02: approval workbench reshaped into a Case Desk (DecisionCase as
  the operator's accountability unit)
- 10 (new): cross-province federation boundary — signed artifacts
  only, plus three phase-1 no-rework reservations
- 08: add M5 shadow-run milestone as phase-1 acceptance form
- 00/04/07: object table, doc map, and walkthrough consistency updates
- add brainstorming.md (peer review source document)

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_019u5SLNweVio6ozJX7yfxQr

🔮 View transcript: https://logs.lojong.info/s/e8u90k3t33w590r7b5y7yzqh
2026-09-01 20:44:12 -04:00

96 lines
6.3 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# 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. 中长期持仓对日前申报的实际约束形式(分解曲线偏差带的具体规定)。