Decision owner
Control-room operator
The named role remains accountable for the consequential decision.
Energy & Utilities
Designed for Field technician
Equip a field technician at the pole or substation with the right asset record, switching procedure, and outage context to complete the work order safely, with a control-room switching authorization before any energized operation.
Contract ENE-01 · primary aggregate FieldWorkOrder · mode loading
Decision brief
This brief starts with the decision, evidence, and accountable owner. The guided workflow then shows how the recommendation was produced.
The evidence and control points that shape this recommendation.
Decision owner
Control-room operator
The named role remains accountable for the consequential decision.
Governed evidence
5 record types
Structured records and cited text ground the recommendation.
Workflow
5 controlled stages
Each transition records its input, output, status, and audit context.
Human controls
1 approval gate
Approval gates prevent the copilot from making consequential decisions.
A technician arrives at a failed pole-mounted recloser during a storm; the copilot shows 312 customers out on the feeder, identifies the upstream isolating device, cites the manufacturer's bypass procedure for the voltage class, and holds the energized steps until the control room issues the switching authorization..
Equip a field technician at the pole or substation with the right asset record, switching procedure, and outage context to complete the work order safely, with a control-room switching authorization before any energized operation.
Issued switching authorization and permit record gives Control-room operator the evidence needed to begin the final governed business outcome, with the decision trail retained for review.
Step 1 of 5
| Field | Value |
|---|
| Field | Value |
|---|
The output appears here immediately. More technical evidence remains available below.
The demonstration keeps deterministic controls, AI assistance, and approval separate.
Source systems enforce identity, workflow order, policy filters, and record updates.
Retrieval and generation assemble relevant evidence into a cited recommendation or draft.
Control-room operator verifies material claims and approves the consequential action.
Run the stages in order before using the Copilot. Every stage explains what happens, why it matters, the evidence it uses, and the complete API request and response.
Automated stage
What happens: Field technician performs accept the work order in the field using Dispatched job with asset and location and produces FieldWorkOrder accepted with crew identity. The transition is deterministic and does not require autonomous model approval.
Why it matters: FieldWorkOrder accepted with crew identity gives Network context service the evidence needed to begin Load asset, connectivity, and outage context, with the decision trail retained for review.
Loading relevant sample records.
Ready to run.
POST /api/domain/workflow/accept-the-work-order-in-the-field
Run this API to see its formatted outcome.
| Field | Value |
|---|
| Field | Value |
|---|
Automated stage
What happens: Network context service performs load asset, connectivity, and outage context using Asset identifiers and feeder topology and produces Asset record with upstream devices and active outages. The transition is deterministic and does not require autonomous model approval.
Why it matters: Asset record with upstream devices and active outages gives Retrieval agent the evidence needed to begin Retrieve the applicable procedure, with the decision trail retained for review.
Loading relevant sample records.
Ready to run.
POST /api/domain/workflow/load-asset-connectivity-and-outage-context
Run this API to see its formatted outcome.
| Field | Value |
|---|
| Field | Value |
|---|
Automated stage
What happens: Retrieval agent performs retrieve the applicable procedure using Job type, asset class, and voltage class and produces Ordered switching steps with safety precautions. The transition is deterministic and does not require autonomous model approval.
Why it matters: Ordered switching steps with safety precautions gives Field copilot the evidence needed to begin Guide the field task with citations, with the decision trail retained for review.
Loading relevant sample records.
Ready to run.
POST /api/domain/workflow/retrieve-the-applicable-procedure
Run this API to see its formatted outcome.
| Field | Value |
|---|
| Field | Value |
|---|
Automated stage
What happens: Field copilot performs guide the field task with citations using Procedure steps and asset specifics and produces Step-by-step guidance with manual citations. The transition is deterministic and does not require autonomous model approval.
Why it matters: Step-by-step guidance with manual citations gives Control-room operator the evidence needed to begin Authorize switching and energization, with the decision trail retained for review.
Loading relevant sample records.
Ready to run.
POST /api/domain/workflow/guide-the-field-task-with-citations
Run this API to see its formatted outcome.
| Field | Value |
|---|
| Field | Value |
|---|
Human approval required
What happens: Control-room operator performs authorize switching and energization using Requested switching operation and grounding state and produces Issued switching authorization and permit record. A named human approver must review the evidence before the transition completes.
Why it matters: Issued switching authorization and permit record gives Control-room operator the evidence needed to begin the final governed business outcome, with the decision trail retained for review.
Loading relevant sample records.
Ready to run.
POST /api/domain/workflow/authorize-switching-and-energization
Run this API to see its formatted outcome.
| Field | Value |
|---|
| Field | Value |
|---|
Run a stage to see its explanation, evidence, full request, and full response.
Ask a question and receive an answer grounded in retrieved FieldWorkOrder evidence.
Select a starter question or enter your own.
Loaded live from /api/config, /api/domain/model, and
/api/domain/sample.
fieldWorkOrders/tenantId + /serviceTerritoryIdA technician arrives at a failed pole-mounted recloser during a storm; the copilot shows 312 customers out on the feeder, identifies the upstream isolating device, cites the manufacturer's bypass procedure for the voltage class, and holds the energized steps until the control room issues the switching authorization.
| Container | Role | Hierarchical partition key | Document types |
|---|---|---|---|
fieldWorkOrders |
Primary | /tenantId + /serviceTerritoryId |
FieldWorkOrder, GridAssetRecord, OutageIncident |
gridProcedureLibrary |
Reference | /tenantId + /documentId |
SwitchingProcedure, TechnicalManualChunk |
| Type | Container | Partition key | Identifier pattern | Embedding fields |
|---|---|---|---|---|
FieldWorkOrder |
fieldWorkOrders |
/tenantId + /serviceTerritoryId |
workorder::{serviceTerritoryId}::{workOrderId} |
None |
GridAssetRecord |
fieldWorkOrders |
/tenantId + /serviceTerritoryId |
asset::{serviceTerritoryId}::{assetId} |
None |
SwitchingProcedure |
gridProcedureLibrary |
/tenantId + /documentId |
switching::{documentId}::{stepIndex} |
stepVector |
OutageIncident |
fieldWorkOrders |
/tenantId + /serviceTerritoryId |
outage::{serviceTerritoryId}::{incidentId} |
None |
TechnicalManualChunk |
gridProcedureLibrary |
/tenantId + /documentId |
manual::{documentId}::{chunkIndex} |
bodyVector |
Read work order, target assets, and active outages for the territory in one partition query.
fieldWorkOrders
single-partition
SELECT * FROM c WHERE c.tenantId = @tenantId AND c.serviceTerritoryId = @serviceTerritoryId AND c.type IN ('FieldWorkOrder','GridAssetRecord','OutageIncident') ORDER BY c.estimatedRestorationUtc ASC
Knowledge-container query against gridProcedureLibrary (partition-aligned to /tenantId + /documentId): return only the switching steps valid for the asset class and voltage the crew is working on, read as a single partition query on the procedure document.
gridProcedureLibrary
single-partition
SELECT * FROM c WHERE c.tenantId = @tenantId AND c.documentId = @procedureDocumentId AND c.type = 'SwitchingProcedure' AND c.applicableVoltageClass = @voltageClass ORDER BY c.stepIndex ASC
Show open outages on the feeder the crew is about to work on.
fieldWorkOrders
single-partition
SELECT * FROM c WHERE c.tenantId = @tenantId AND c.serviceTerritoryId = @serviceTerritoryId AND c.type = 'OutageIncident' AND c.incidentState = 'active' AND c.affectedFeederId = @feederId ORDER BY c.affectedCustomerCount DESC
Identify assets in the territory past their inspection interval for opportunistic work.
fieldWorkOrders
single-partition
SELECT * FROM c WHERE c.tenantId = @tenantId AND c.serviceTerritoryId = @serviceTerritoryId AND c.type = 'GridAssetRecord' AND c.lastInspectionUtc < @inspectionDueUtc ORDER BY c.lastInspectionUtc ASC