能源电网优化器部署

部署 4 个智能体：sensor-mesh、forecaster、optimizer 和 controller。

角色说明

部署流程

步骤 1： 向用户询问该智能体应承担的角色及所用前缀（prefix）。

步骤 2： 安装对应角色所需的技能：

# sensor-mesh 使用：
clawhub install pilot-stream-data pilot-metrics pilot-gossip
# forecaster 使用：
clawhub install pilot-dataset pilot-task-router pilot-cron
# optimizer 使用：
clawhub install pilot-consensus pilot-event-filter pilot-audit-log
# controller 使用：
clawhub install pilot-webhook-bridge pilot-receipt pilot-alert

步骤 3： 设置主机名，并将配置清单写入 ~/.pilot/setups/energy-grid-optimizer.json。

步骤 4： 提示用户针对其角色，与对等节点（peers）发起握手（handshake）。

步骤 5： 使用 pilotctl --json trust 验证节点间连通性。

各角色对应的清单模板

sensor-mesh

{"setup":"energy-grid-optimizer","role":"sensor-mesh","role_name":"Sensor Mesh","hostname":"-sensor-mesh","skills":{"pilot-stream-data":"Ingest real-time readings from smart meters, solar panels, and batteries.","pilot-metrics":"Track grid voltage, frequency, and power quality metrics.","pilot-gossip":"Share sensor health status across mesh nodes."},"data_flows":[{"direction":"send","peer":"-forecaster","port":1002,"topic":"grid-reading","description":"Timestamped grid readings"},{"direction":"receive","peer":"-controller","port":1002,"topic":"device-ack","description":"Device execution confirmations"}],"handshakes_needed":["-forecaster","-controller"]}

forecaster

{"setup":"energy-grid-optimizer","role":"forecaster","role_name":"Load Forecaster","hostname":"-forecaster","skills":{"pilot-dataset":"Store historical demand and weather data for model training.","pilot-task-router":"Route forecast jobs across time horizons.","pilot-cron":"Run scheduled forecast updates every 15 minutes."},"data_flows":[{"direction":"receive","peer":"-sensor-mesh","port":1002,"topic":"grid-reading","description":"Real-time grid readings"},{"direction":"send","peer":"-optimizer","port":1002,"topic":"demand-forecast","description":"Demand forecasts with confidence intervals"}],"handshakes_needed":["-sensor-mesh","-optimizer"]}

optimizer

{"setup":"energy-grid-optimizer","role":"optimizer","role_name":"Grid Optimizer","hostname":"-optimizer","skills":{"pilot-consensus":"Coordinate optimization decisions across distributed sources.","pilot-event-filter":"Filter forecasts by confidence threshold before acting.","pilot-audit-log":"Log all dispatch decisions with cost and reasoning."},"data_flows":[{"direction":"receive","peer":"-forecaster","port":1002,"topic":"demand-forecast","description":"Demand forecasts from forecaster"},{"direction":"send","peer":"-controller","port":1002,"topic":"dispatch-command","description":"Device setpoint commands"}],"handshakes_needed":["-forecaster","-controller"]}

controller

{"setup":"energy-grid-optimizer","role":"controller","role_name":"Device Controller","hostname":"-controller","skills":{"pilot-webhook-bridge":"Interface with inverter and battery management APIs.","pilot-receipt":"Generate execution confirmations for each command.","pilot-alert":"Emit alerts on device failures or safety threshold breaches."},"data_flows":[{"direction":"receive","peer":"-optimizer","port":1002,"topic":"dispatch-command","description":"Dispatch commands to execute"},{"direction":"send","peer":"-sensor-mesh","port":1002,"topic":"device-ack","description":"Execution status confirmations"}],"handshakes_needed":["-optimizer","-sensor-mesh"]}

数据流向

• sensor-mesh → forecaster：包含电压、电流和功率指标的电网读数（端口 1002）
• forecaster → optimizer：含置信区间的负荷预测结果（端口 1002）
• optimizer → controller：设备设定点（setpoint）的调度指令（端口 1002）
• controller → sensor-mesh：设备执行状态确认（端口 1002）

握手命令

pilotctl --json handshake -forecaster "setup: energy-grid-optimizer"
pilotctl --json handshake -sensor-mesh "setup: energy-grid-optimizer"
pilotctl --json handshake -optimizer "setup: energy-grid-optimizer"
pilotctl --json handshake -controller "setup: energy-grid-optimizer"

工作流示例

# 在 sensor-mesh 上 — 发布电网读数：
pilotctl --json publish -forecaster grid-reading '{"source":"solar-array-1","power_kw":5.1,"battery_soc":0.73}'
# 在 forecaster 上 — 发布负荷预测：
pilotctl --json publish -optimizer demand-forecast '{"horizon":"1h","predicted_kw":42.8,"confidence":0.91}'
# 在 optimizer 上 — 发布调度指令：
pilotctl --json publish -controller dispatch-command '{"device":"battery-bank-1","action":"discharge","setpoint_kw":10.0}'
# 在 controller 上 — 发布设备确认：
pilotctl --json publish -sensor-mesh device-ack '{"device":"battery-bank-1","status":"executing","actual_kw":9.8}'

依赖项

需安装 pilot-protocol 技能、pilotctl 可执行文件、clawhub 可执行文件，并确保后台守护进程（daemon）正在运行。