Decision owner
Fleet manager
The named role remains accountable for the consequential decision.
Automotive & Mobility
Designed for Fleet manager
Keep a mixed combustion and electric fleet running by fusing telemetry, route plans, charging availability, and maintenance status into ranked interventions, with the fleet manager approving vehicle swaps and route changes.
Contract AUT-03 · primary aggregate FleetOperationsDay · 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
Fleet manager
The named role remains accountable for the consequential decision.
Governed evidence
6 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.
On a cold morning the copilot detects four electric vans whose state of charge will not cover their planned routes with a 20 percent winter derate, finds two depot chargers already occupied, recommends swapping two routes to diesel units and adding a midday top-up for the rest, and the fleet manager approves the plan before the 06:30 departure wave..
Keep a mixed combustion and electric fleet running by fusing telemetry, route plans, charging availability, and maintenance status into ranked interventions, with the fleet manager approving vehicle swaps and route changes.
Committed dispatch update sent to drivers gives Fleet manager 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.
Fleet manager 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: Fleet planner performs build the depot day plan using Route commitments and vehicle roster and produces FleetOperationsDay with assignments and energy plan. The transition is deterministic and does not require autonomous model approval.
Why it matters: FleetOperationsDay with assignments and energy plan gives Telematics integration service the evidence needed to begin Ingest vehicle telemetry and charger state, with the decision trail retained for review.
Loading relevant sample records.
Ready to run.
POST /api/domain/workflow/build-the-depot-day-plan
Run this API to see its formatted outcome.
| Field | Value |
|---|
| Field | Value |
|---|
Automated stage
What happens: Telematics integration service performs ingest vehicle telemetry and charger state using State of charge, faults, charger availability and produces Refreshed VehicleStatus and charging capacity. The transition is deterministic and does not require autonomous model approval.
Why it matters: Refreshed VehicleStatus and charging capacity gives Exception detection agent the evidence needed to begin Detect range, maintenance, and capacity exceptions, with the decision trail retained for review.
Loading relevant sample records.
Ready to run.
POST /api/domain/workflow/ingest-vehicle-telemetry-and-charger-state
Run this API to see its formatted outcome.
| Field | Value |
|---|
| Field | Value |
|---|
Automated stage
What happens: Exception detection agent performs detect range, maintenance, and capacity exceptions using Route energy demand versus vehicle and charger supply and produces OperationalException set with severity. The transition is deterministic and does not require autonomous model approval.
Why it matters: OperationalException set with severity gives Fleet copilot the evidence needed to begin Recommend swaps, charging, or re-routes, with the decision trail retained for review.
Loading relevant sample records.
Ready to run.
POST /api/domain/workflow/detect-range-maintenance-and-capacity-exceptions
Run this API to see its formatted outcome.
| Field | Value |
|---|
| Field | Value |
|---|
Automated stage
What happens: Fleet copilot performs recommend swaps, charging, or re-routes using Exceptions, weather, and maintenance constraints and produces Ranked remedies with cost and service impact. The transition is deterministic and does not require autonomous model approval.
Why it matters: Ranked remedies with cost and service impact gives Fleet manager the evidence needed to begin Approve the dispatch change, with the decision trail retained for review.
Loading relevant sample records.
Ready to run.
POST /api/domain/workflow/recommend-swaps-charging-or-re-routes
Run this API to see its formatted outcome.
| Field | Value |
|---|
| Field | Value |
|---|
Human approval required
What happens: Fleet manager performs approve the dispatch change using Proposed vehicle swap or route change and produces Committed dispatch update sent to drivers. A named human approver must review the evidence before the transition completes.
Why it matters: Committed dispatch update sent to drivers gives Fleet manager 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/approve-the-dispatch-change
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 FleetOperationsDay evidence.
Select a starter question or enter your own.
Loaded live from /api/config, /api/domain/model, and
/api/domain/sample.
fleetOperationsDays/tenantId + /fleetDepotIdOn a cold morning the copilot detects four electric vans whose state of charge will not cover their planned routes with a 20 percent winter derate, finds two depot chargers already occupied, recommends swapping two routes to diesel units and adding a midday top-up for the rest, and the fleet manager approves the plan before the 06:30 departure wave.
| Container | Role | Hierarchical partition key | Document types |
|---|---|---|---|
fleetOperationsDays |
Primary | /tenantId + /fleetDepotId |
FleetOperationsDay, VehicleStatus, RoutePlan, ChargingSessionPlan, MaintenanceDueItem, OperationalException |
| Type | Container | Partition key | Identifier pattern | Embedding fields |
|---|---|---|---|---|
FleetOperationsDay |
fleetOperationsDays |
/tenantId + /fleetDepotId |
operationsday::{fleetDepotId}::{operationsDate} |
None |
VehicleStatus |
fleetOperationsDays |
/tenantId + /fleetDepotId |
vehiclestatus::{fleetDepotId}::{vehicleId} |
None |
RoutePlan |
fleetOperationsDays |
/tenantId + /fleetDepotId |
route::{fleetDepotId}::{routeId} |
None |
ChargingSessionPlan |
fleetOperationsDays |
/tenantId + /fleetDepotId |
charging::{fleetDepotId}::{sessionId} |
None |
MaintenanceDueItem |
fleetOperationsDays |
/tenantId + /fleetDepotId |
maintenance::{fleetDepotId}::{itemId} |
None |
OperationalException |
fleetOperationsDays |
/tenantId + /fleetDepotId |
exception::{fleetDepotId}::{exceptionId} |
remedyVector |
Read vehicle status, routes, and charging plans for the depot day in one partition query.
fleetOperationsDays
single-partition
SELECT * FROM c WHERE c.tenantId = @tenantId AND c.fleetDepotId = @fleetDepotId AND c.type IN ('FleetOperationsDay','VehicleStatus','RoutePlan','ChargingSessionPlan') ORDER BY c.departureUtc ASC
Find electric vehicles whose charge cannot cover the assigned route energy demand.
fleetOperationsDays
single-partition
SELECT * FROM c WHERE c.tenantId = @tenantId AND c.fleetDepotId = @fleetDepotId AND c.type = 'VehicleStatus' AND c.powertrainType = 'battery-electric' AND c.stateOfChargePercent < @requiredChargePercent ORDER BY c.stateOfChargePercent ASC
List vehicles that cannot legally or safely be dispatched today.
fleetOperationsDays
single-partition
SELECT * FROM c WHERE c.tenantId = @tenantId AND c.fleetDepotId = @fleetDepotId AND c.type = 'MaintenanceDueItem' AND c.blocksDispatch = true AND c.dueDateUtc <= @operationsDateUtc ORDER BY c.dueDateUtc ASC
Show remedies awaiting the fleet manager's decision before departure.
fleetOperationsDays
single-partition
SELECT * FROM c WHERE c.tenantId = @tenantId AND c.fleetDepotId = @fleetDepotId AND c.type = 'OperationalException' AND c.approvalState = 'pending' ORDER BY c.exceptionKind ASC