vpp-ai-platform/docs/01-principles.md
2026-09-01 19:46:59 -04:00

80 lines
4.1 KiB
Markdown
Raw 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.

# 01 · 架构原则
以下九条原则是全部设计决策的裁判标准。评审任何模块设计、任何 PR 时,先对照本篇。
## P1 两平面分离
认知平面(LLM 智能体,分钟~天)与控制平面(确定性执行,秒级)严格分离,
唯一通道是可信执行链。**LLM 永远不出现在秒级控制路径上。**
*推论:* 边缘终端断连时依然能在最近一次批准的包络内自治运行(见 P9)。
## P2 LLM 不算数
大模型负责意图理解、约束组装、工具选择、流程编排与结果解释;
**申报价格、调度量、控制设定值等一切数字,必须来自专业模型工具层**
(预测模型、优化求解器、仿真引擎),且工具输出原样进入 Proposal,不经 LLM 转写。
*反例判据:* 若某个申报数字的来源无法追溯到某次工具调用的输出,即为架构违规。
## P3 包络自治(分级授权)
化解「事事人工审批」与「协同决策响应 ≤ 3 分钟」的矛盾:
- 人工审批的对象是**包络(Envelope)**——策略级授权(价格/电量边界、可控用户集、有效期),走多级审批高规格流程;
- 包络**内**的单笔动作经规则校核 + 仿真验证后自动放行,全程留痕;
- 包络**外**或校核/仿真告警的动作,升级人工审批。
*先例:* 与电网调度对 AGC 机组的「调节死区内自治」授权模型同构——不是新信任模型,是既有模型向 VPP 资源的延伸。
*自治拨盘:* 新业务上线初期包络可设为空集(等价于全人工),随复盘数据积累逐步放宽。
## P4 对象化通信
智能体之间**不进行自由文本对话**。协作只通过事件总线上的类型化、带版本号的业务对象
(`Proposal`、`ResourceProfile`、`PositionLedger` 等,见 00 篇 §4),由 Runtime 统一路由。
*收益:* 协作即数据,数据即审计;事件日志直接成为复盘的原始材料。
## P5 一切皆可审计
事件溯源(event sourcing)为默认持久化模式。每个 Proposal 携带完整血缘:
发起 Agent、触发源、引用的工具调用及其版本、命中的规则、仿真结果、审批人/包络、执行反馈。
满足等保合规「操作留痕、合规可审计」要求。
## P6 提供商抽象
所有 LLM 调用经统一抽象层(模型路由器),面向能力(语义理解/规划/生成)而非厂商 API 编程。
开发期用商用 API,交付期切换光明电力大模型适配器(预期本地化部署),业务代码零改动。
提示词、工具定义、评测集均按可迁移标准维护(见 08 篇)。
## P7 约束级联(多时间尺度协同)
年度 → 月度 → 日前 → 日内 → 实时不是五套系统,而是一条**约束级联**:
上层的决策成为下层的约束。级联状态集中于共享的 `PositionLedger`(持仓账本),
所有 Agent 经 Runtime 读写,禁止在各 Agent 内部私存持仓状态。
*推论:* 偏差复盘 = 逐时间尺度对比账本计划值与计量实际值,账本天然是结算对账主干。
## P8 数据分层存储
不用一个库解决所有问题:时序库(遥测曲线)、关系库(合同/用户/市场结果)、
向量库(规则/政策/设备约束文档,RAG)、特征库(喂预测模型)、事件日志(审计与复盘)。
各库有明确的写入方和消费方(见 05 篇)。
## P9 边缘自治
边缘控制终端在包络内就地闭环(秒级响应、断连续行),
仅接受经可信执行链下发的计划/包络更新,并持续回传执行反馈。
省级平台失联 ≠ 资源失控。
---
## 原则间的张力与取舍备忘
| 张力 | 取舍 |
|---|---|
| P3 自治效率 vs 安全底线 | 包络审批规格从严,包络内动作从宽;仿真告警一票升级人工 |
| P4 对象化 vs 大模型灵活性 | 自由文本仅存在于「人 ↔ Agent」交互面;「Agent ↔ Agent」一律对象化 |
| P6 抽象层 vs 光明大模型特有能力 | 抽象层按能力最小公倍数设计;光明特有能力(电力语义)以可选扩展点接入,降级可运行 |