Industry Vocabulary Reference
Energy & Utilities
Energy and utilities fields cover grid assets, outages, demand response, markets, maintenance, and emissions workflows. They describe recorded activity without authorizing changes to operational systems.
Back to industry coverage library
This page shows selected examples and categories. Download the JSON for the complete vocabulary, including every field, permitted value, and policy pattern in this catalog.
How to use this reference
- Start with the core file if you need the cross-industry governance baseline.
- Choose an industry file for its workflow fields and permitted values.
- Match the OTel attributes to the policy paths your rules use, then verify the recorded fields in a test session.
Catalog context
Start with a bounded workflow such as outage review or maintenance planning. Record the requested action, responsible operator, and confirmed result.
Risk note: Preserve operational safety and access controls outside the tracing system. Assess critical-infrastructure requirements against the affected assets and intended use of the AI system.
Vocabulary file
- Download filename: 08_vertical_energy_utilities.json
- Kind: vertical
OTel namespaces
Referenced standards
These references explain the catalog's context. A listed standard does not establish that a configured application meets its requirements.
- IEC 61968, Application Integration at Electric Utilities, System Interfaces for Distribution Management
- IEC 61970, Energy Management System Application Program Interface (EMS-API), Common Information Model (CIM)
- IEC 61850, Communication Networks and Systems for Power Utility Automation
- IEC 61400-25, Wind Turbines, Communications for Monitoring and Control
- IEC 62351, Power Systems Management and Associated Information Exchange, Data and Communications Security
- NERC CIP v7, Critical Infrastructure Protection Standards (CIP-002 through CIP-014)
- NERC FAC-001/FAC-002, Facility Connection and Planning Standards
- NERC EOP-004, Event Reporting
- OpenADR 2.0b, Open Automated Demand Response (OpenADR Alliance)
- IEEE 1547-2018, Standard for Interconnection and Interoperability of DERs with Electric Power Systems
- FERC Order 2222, Participation of Distributed Energy Resource Aggregations in Organized Energy Markets (2020)
- FERC Order 881, Managing Transmission Line Ratings (2021)
- FERC Order 3052, Cybersecurity Incentives (2024)
- ENTSO-E Network Codes, EU transmission network operational standards
- EU Electricity Directive 2019/944, Internal market for electricity
- EU Renewable Energy Directive III (RED III) 2023/2413, 42.5% renewable target by 2030
- EU ETS (Emissions Trading System), EU Allowance Registry under EU ETS Directive 2003/87/EC (as amended)
- EPA 40 CFR Part 75, Continuous Emissions Monitoring Systems (CEMS)
- EPA Clean Power Plan / Good Neighbor Rule (2024 revisions)
- API RP 1173, Pipeline Safety Management Systems
- PHMSA 49 CFR Part 192/195, Pipeline Safety Regulations
- AWWA Cybersecurity Guidance, Water sector OT security
- EPA EPCRA Section 313, Toxic Release Inventory reporting
Source references
- https://cimug.ucaiug.org/
- https://www.nerc.com/pa/Stand/Pages/CIPStandards.aspx
- https://www.openadr.org/
- https://www.ferc.gov/
- https://www.entsoe.eu/network_codes/
- https://www.epa.gov/airmarkets
- https://www.phmsa.dot.gov/pipeline
Subdomains
| Subdomain | Categories | Sample attributes |
|---|---|---|
| Grid Asset & Outage Management (IEC CIM) | 4 | energy.asset.operational_status, energy.switching.state, energy.outage.lifecycle_state |
| Demand Response & OpenADR | 3 | energy.demand_response.event_status, energy.demand_response.curtailment_type, energy.vpp.dispatch_state |
| NERC CIP Critical Infrastructure Protection | 3 | energy.nerc_cip.standard, energy.nerc_cip.bcs_impact_level, energy.nerc_cip.evidence_type |
| Renewable Energy & DER Management | 3 | energy.renewable.asset_type, energy.battery_storage.operation_mode, energy.renewable.forecast_confidence |
| Energy Market Operations & Settlement | 3 | energy.market.product_type, energy.market.bid_offer_status, energy.market.congestion_method |
| Emissions Monitoring & Environmental Compliance | 3 | energy.cems.data_quality_flag, energy.eu_ets.compliance_status, energy.ghg.emission_scope |
| Pipeline Integrity & Oil and Gas Operations | 2 | energy.pipeline.integrity_threat_category, energy.pipeline.anomaly_severity |
| Water & Wastewater Operations | 2 | energy.water.treatment_process_state, energy.water.quality_compliance_status |
Implementation examples
- Grid Asset & Outage Management (IEC CIM): Grid Asset Operational Status. AI energy management agent monitors all BES asset statuses via CIM. 'Forced_outage' on a high-impact asset triggers automatic NERC EOP-004 assessment, initiates restoration workflow, and escalates to grid operations HITL. AI agent may not autonomously re-energise a 'de_energized' asset, crew clearance confirmation required. (Nerc Eop 004: NERC EOP-004, Disturbance reporting: 'forced_outage' on BES elements meeting reporting thresholds must be reported to NERC and regional entity)
- Grid Asset & Outage Management (IEC CIM): Switching Equipment State. AI distribution management agent executes fault isolation switching sequences. Each switching step is logged with the pre- and post-state. OPA policy blocks AI from closing a 'grounded' switch, crew clearance confirmation from safety system is required first. (Nerc Cip 010: NERC CIP-010, Configuration change management: autonomous AI switching on BES Cyber Systems requires approved change documentation)
- Grid Asset & Outage Management (IEC CIM): Outage Lifecycle State. AI outage management agent receives outage reports from AMI (Advanced Metering Infrastructure), customer calls, and SCADA alarms. Agent correlates reports, confirms outage boundary, and dispatches crew. OPA policy enforces that 'fully_restored' state requires meter-verified restoration confirmation, not just switch state change.
- Grid Asset & Outage Management (IEC CIM): Protection Relay Operation Status. AI grid monitoring agent detects relay operation from SCADA and classifies status. 'Reclose_failed_lockout' triggers immediate crew dispatch. 'Protection_inhibited_ai_action' is a critical flag indicating an AI agent has interfered with protection, requires immediate HITL escalation and is a NERC compliance event. (Nerc Prc 023: NERC PRC-023, Transmission relay loadability: relay settings affected by AI optimisation must comply with NERC PRC-023 loadability criteria)
Control ideas
These patterns describe possible controls, not active rules. Confirm applicability, implement the control, and test its effect on the application.
Require operator approval before grid switching
Hold a proposed switching action until an authorized system operator approves it. Keep the authorization with the request to change a bulk electric system asset's energized state.
Regulatory basis: Utility-defined switching authorization and operating procedures.
Enforce nerc cip evidence generation for bcs actions
Require that every AI agent action on a BES Cyber System automatically generates a tagged compliance evidence record linking the action to the applicable NERC CIP standard and requirement ID. Enables automated audit evidence package assembly for NERC Regional Entity compliance audits.
Regulatory basis: NERC CIP-007-6 R4, Log management: access logs must be reviewed within 35 days for high/medium impact BCS; NERC CIP-010-4 R1, Baseline configuration documentation; NERC CIP-013-2 R2, Supply chain risk assessment documentation
Enforce before the action
Pass the request and your business action to this function. The core SDK checks policy before the action runs and again before its result is released. A deny or review decision means the action never runs.
import { Veriproof } from '@veriproof/sdk-core';
import type { GovernedResult, IndustryFact, JsonValue } from '@veriproof/sdk-core';
const veriproof = Veriproof.fromEnv();
export async function runProtectedAction<TInput extends JsonValue, TValue>(
request: TInput,
action: (input: TInput, signal: AbortSignal) => Promise<TValue>,
): Promise<GovernedResult<TValue, TInput>> {
// Catalog values for this vertical. Replace them with facts from the current workflow.
const industry: IndustryFact[] = [
{ attribute: "energy.asset.operational_status", policyInput: "energy_asset_operational_status", value: "in_service" },
{ attribute: "energy.switching.state", policyInput: "energy_switching_state", value: "closed" },
{ attribute: "energy.outage.lifecycle_state", policyInput: "energy_outage_lifecycle_state", value: "reported" },
];
// Policy runs before action() and again before the result is released.
// A deny or review decision means action() never runs.
return veriproof.govern(
"energy.utilities.evaluate",
request,
({ input, signal }) => action(input, signal),
{ industry },
);
}- Replace the sample values with facts from the current workflow. Rules read them under
input.snapshot.industry. - Test both permitted and blocked actions. Confirm that a blocked action never reaches your business function.
- Only
completed,completed_with_warning, andtransformedresults carry a released value.
For review decisions, follow the Human Review guide to configure continuation. Observe remains available when you need to record activity without enforcing a decision.
Set up the Energy & Utilities example. See the API reference for TypeScript, Python, or .NET.
Try a simulator to see a governed decision in context. To connect your own workflow, verify your work email and start Developer free for 60 days. You can also review the relevant controls with our team.
Live demo → Start free for 60 days → Request coverage workshop →
Selected vocabulary categories
GridAssetOperationalStatus
IEC CIM 61970 operational status of a grid asset (generator, transformer, transmission line, substation bus). These values map directly to IEC CIM OperationalLimitSet and Equipment.inService semantics. AI grid management agents must use these values when reading or setting asset status via EMS APIs.
Workflow area: Grid Asset & Outage Management (IEC CIM)
- OTel attribute
energy.asset.operational_status- Permitted values
in_serviceout_of_servicede_energizedplanned_outageforced_outageunder_maintenancecommissioningdecommissioned
SwitchingEquipmentState
IEC CIM 61970 / IEC 61850 state of a switching device (circuit breaker, disconnector, load break switch). AI grid switching agents must log every state transition. Autonomous switching on BES assets without HITL authorisation is a NERC CIP-010 change management violation.
Workflow area: Grid Asset & Outage Management (IEC CIM)
- OTel attribute
energy.switching.state- Permitted values
closedopengroundedlocked_openlocked_closedtransitingunknownfault_interrupt
OutageLifecycleState
Outage Management System (OMS) lifecycle state for a grid outage event. AI outage management agents track outages from initial report through restoration confirmation. Maps to IEC CIM 61968 Outage and PlannedOutage class state semantics.
Workflow area: Grid Asset & Outage Management (IEC CIM)
- OTel attribute
energy.outage.lifecycle_state- First 8 permitted values
reportedconfirmedcrew_en_routecrew_on_siteisolatingrestoringpartially_restoredfully_restored
ProtectionRelayOperationStatus
Status of a protection relay operation as logged by AI grid monitoring agents. Protection relay events are among the highest-priority signals for grid operators, AI agents must never suppress or delay relay operation notifications.
Workflow area: Grid Asset & Outage Management (IEC CIM)
- OTel attribute
energy.protection.relay_operation_status- First 8 permitted values
normal_no_operationpickup_conditiontrip_initiatedtrip_confirmedreclose_initiatedreclose_successfulreclose_failed_lockoutprotection_inhibited_ai_action
DemandResponseEventStatus
OpenADR 2.0b demand response event status. These values map to OpenADR 2.0b oadrRequestEvent and oadrCreatedEvent response states. AI DR orchestration agents (VTN role) must use these values to track event lifecycle.
Workflow area: Demand Response & OpenADR
- OTel attribute
energy.demand_response.event_status- First 8 permitted values
pendingactivecancelledcompletedopt_out_receivednon_compliance_detectedfarnear
DRResourceCurtailmentType
Type of demand response curtailment or dispatch action requested of a resource. AI DR dispatch agents use this to select the correct control action for each asset type.
Workflow area: Demand Response & OpenADR
- OTel attribute
energy.demand_response.curtailment_type- First 8 permitted values
load_shed_direct_controlload_shed_price_signalhvac_setpoint_adjustmentev_charging_curtailmentbattery_discharge_dispatchder_export_increaseinterruptible_load_interruptindustrial_process_delay
VPPDispatchState
Operational dispatch state of a Virtual Power Plant (VPP) or DER aggregation managed by an AI dispatch agent. FERC Order 2222 DER aggregations participating in organised markets must maintain accurate dispatch state for market settlement.
Workflow area: Demand Response & OpenADR
- OTel attribute
energy.vpp.dispatch_state- First 8 permitted values
standbypre_dispatch_forecastingdispatched_chargingdispatched_dischargingdispatched_curtailingdispatched_exportingrampingat_target
NERCCIPStandard
NERC CIP v7 standard identifier. AI compliance monitoring agents tag every action on a BES Cyber System with the applicable CIP standard(s) for automated audit evidence collection. Used to link AI agent actions to specific CIP requirements in the compliance evidence package.
Workflow area: NERC CIP Critical Infrastructure Protection
- OTel attribute
energy.nerc_cip.standard- First 8 permitted values
CIP_002_bes_cyber_system_categorizationCIP_003_security_management_controlsCIP_004_personnel_and_trainingCIP_005_electronic_security_perimeterCIP_006_physical_securityCIP_007_systems_security_managementCIP_008_incident_reporting_responseCIP_009_recovery_plans
BESCyberSystemImpactLevel
NERC CIP-002-5.1a BES Cyber System impact level classification. Determines the set of CIP requirements applicable to a BCS asset. AI agents must not take configuration or change actions on high or medium impact BCS assets without meeting CIP-010 change management requirements.
Workflow area: NERC CIP Critical Infrastructure Protection
- OTel attribute
energy.nerc_cip.bcs_impact_level- Permitted values
high_impactmedium_impactlow_impactnot_bes_cyber_system
CIPComplianceEvidenceType
Type of NERC CIP compliance evidence generated by an AI agent action. AI compliance monitoring agents auto-generate evidence packages; this enum classifies the evidence type for the audit record.
Workflow area: NERC CIP Critical Infrastructure Protection
- OTel attribute
energy.nerc_cip.evidence_type- First 8 permitted values
access_log_reviewconfiguration_baseline_snapshotchange_management_recordvulnerability_assessmentpatch_application_recordincident_response_activationrecovery_plan_test_recordsupply_chain_vendor_assessment
RenewableEnergyAssetType
Classification of a renewable or distributed energy asset type. AI energy management agents use this to select the correct dispatch model, forecasting algorithm, and regulatory compliance profile for each asset.
Workflow area: Renewable Energy & DER Management
- OTel attribute
energy.renewable.asset_type- First 8 permitted values
solar_pv_utility_scalesolar_pv_distributed_rooftopwind_onshorewind_offshorebattery_storage_grid_scalebattery_storage_behind_meterhydroelectric_largehydroelectric_run_of_river
BatteryStorageOperationMode
Operating mode of a grid-scale or behind-the-meter battery energy storage system (BESS) as managed by an AI dispatch agent. Mode selection drives inverter control commands and market participation eligibility.
Workflow area: Renewable Energy & DER Management
- OTel attribute
energy.battery_storage.operation_mode- First 8 permitted values
idlecharging_gridcharging_renewable_onlydischarging_arbitragedischarging_peak_shavingdischarging_frequency_responsedischarging_voltage_supportdischarging_backup_power
This page uses the vocabulary JSON distributed with the documentation. Check its version when comparing it with an installed SDK.
Download the vocabulary JSON for offline review or automated comparisons.
Use the SDK reference for configuration and supported APIs. Keep vocabulary selection separate from the compliance team's assessment of applicable requirements.