Decision owner
Maintenance supervisor
The named role remains accountable for the consequential decision.
Manufacturing
Designed for Maintenance technician
Get a maintenance technician from a fault code to a verified repair by combining equipment history, sensor evidence, manuals, and prior successful fixes, with supervisor authorization before any safety-critical intervention.
Contract MAN-01 · primary aggregate TroubleshootingSession · 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
Maintenance supervisor
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 filler line throws a torque-limit fault for the third time this week; the copilot correlates rising drive current for 40 minutes before each trip, ranks a worn gearbox coupling ahead of a sensor fault based on two prior repairs where the sensor swap did not hold, walks the technician through the coupling inspection, and the supervisor signs the lockout permit before disassembly..
Get a maintenance technician from a fault code to a verified repair by combining equipment history, sensor evidence, manuals, and prior successful fixes, with supervisor authorization before any safety-critical intervention.
Authorized work with a signed permit record gives Maintenance supervisor 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.
Maintenance supervisor 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: Maintenance technician performs report the fault at the machine using Fault code, symptom description, and asset tag scan and produces TroubleshootingSession bound to the asset. The transition is deterministic and does not require autonomous model approval.
Why it matters: TroubleshootingSession bound to the asset gives Diagnostic agent the evidence needed to begin Correlate sensor and fault evidence, with the decision trail retained for review.
Loading relevant sample records.
Ready to run.
POST /api/domain/workflow/report-the-fault-at-the-machine
Run this API to see its formatted outcome.
| Field | Value |
|---|
| Field | Value |
|---|
Automated stage
What happens: Diagnostic agent performs correlate sensor and fault evidence using Recent fault events and process signals and produces Evidence timeline for the failure window. The transition is deterministic and does not require autonomous model approval.
Why it matters: Evidence timeline for the failure window gives Hypothesis agent the evidence needed to begin Rank causes from history and manuals, with the decision trail retained for review.
Loading relevant sample records.
Ready to run.
POST /api/domain/workflow/correlate-sensor-and-fault-evidence
Run this API to see its formatted outcome.
| Field | Value |
|---|
| Field | Value |
|---|
Automated stage
What happens: Hypothesis agent performs rank causes from history and manuals using Evidence timeline, repair history, procedures and produces Ranked root-cause hypotheses with supporting fixes. The transition is deterministic and does not require autonomous model approval.
Why it matters: Ranked root-cause hypotheses with supporting fixes gives Maintenance copilot the evidence needed to begin Guide the repair step by step, with the decision trail retained for review.
Loading relevant sample records.
Ready to run.
POST /api/domain/workflow/rank-causes-from-history-and-manuals
Run this API to see its formatted outcome.
| Field | Value |
|---|
| Field | Value |
|---|
Automated stage
What happens: Maintenance copilot performs guide the repair step by step using Selected hypothesis and applicable procedure and produces Cited step sequence with tools and safety precautions. The transition is deterministic and does not require autonomous model approval.
Why it matters: Cited step sequence with tools and safety precautions gives Maintenance supervisor the evidence needed to begin Authorize safety-critical intervention, with the decision trail retained for review.
Loading relevant sample records.
Ready to run.
POST /api/domain/workflow/guide-the-repair-step-by-step
Run this API to see its formatted outcome.
| Field | Value |
|---|
| Field | Value |
|---|
Human approval required
What happens: Maintenance supervisor performs authorize safety-critical intervention using Proposed lockout, bypass, or parameter change and produces Authorized work with a signed permit record. A named human approver must review the evidence before the transition completes.
Why it matters: Authorized work with a signed permit record gives Maintenance supervisor 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-safety-critical-intervention
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 TroubleshootingSession evidence.
Select a starter question or enter your own.
Loaded live from /api/config, /api/domain/model, and
/api/domain/sample.
troubleshootingSessions/tenantId + /assetIdA filler line throws a torque-limit fault for the third time this week; the copilot correlates rising drive current for 40 minutes before each trip, ranks a worn gearbox coupling ahead of a sensor fault based on two prior repairs where the sensor swap did not hold, walks the technician through the coupling inspection, and the supervisor signs the lockout permit before disassembly.
| Container | Role | Hierarchical partition key | Document types |
|---|---|---|---|
troubleshootingSessions |
Primary | /tenantId + /assetId |
TroubleshootingSession, AssetProfile, FaultEvent, RepairHistoryRecord |
maintenanceProcedureLibrary |
Reference | /tenantId + /procedureId |
MaintenanceProcedure |
| Type | Container | Partition key | Identifier pattern | Embedding fields |
|---|---|---|---|---|
TroubleshootingSession |
troubleshootingSessions |
/tenantId + /assetId |
session::{assetId}::{sessionId} |
symptomVector |
AssetProfile |
troubleshootingSessions |
/tenantId + /assetId |
asset::{assetId} |
None |
FaultEvent |
troubleshootingSessions |
/tenantId + /assetId |
fault::{assetId}::{eventUtc}::{faultCode} |
None |
MaintenanceProcedure |
maintenanceProcedureLibrary |
/tenantId + /procedureId |
procedure::{procedureId}::{stepIndex} |
stepVector |
RepairHistoryRecord |
troubleshootingSessions |
/tenantId + /assetId |
repair::{assetId}::{workOrderId} |
rootCauseNarrativeVector |
Load asset profile, recent faults, and repair history for the machine in one partition read.
troubleshootingSessions
single-partition
SELECT * FROM c WHERE c.tenantId = @tenantId AND c.assetId = @assetId AND c.type IN ('AssetProfile','FaultEvent','RepairHistoryRecord') ORDER BY c.eventUtc DESC
Detect the same fault code repeating on the asset within the reliability window.
troubleshootingSessions
single-partition
SELECT * FROM c WHERE c.tenantId = @tenantId AND c.assetId = @assetId AND c.type = 'FaultEvent' AND c.faultCode = @faultCode AND c.eventUtc > @windowStartUtc ORDER BY c.eventUtc DESC
Knowledge-container query against maintenanceProcedureLibrary (bounded fan-out across the /tenantId + /procedureId partitions named by the shortlist): retrieve only the manual steps valid for this equipment model, over the procedure ids that the asset profile and fault signature shortlist.
maintenanceProcedureLibrary
partition-key-fan-out
SELECT * FROM c WHERE c.tenantId = @tenantId AND c.procedureId IN (@candidateProcedureIds) AND c.type = 'MaintenanceProcedure' AND ARRAY_CONTAINS(c.applicableModels, @modelNumber) ORDER BY c.stepIndex ASC
Find past repairs on the asset where the fix did not hold, to avoid repeating them.
troubleshootingSessions
single-partition
SELECT * FROM c WHERE c.tenantId = @tenantId AND c.assetId = @assetId AND c.type = 'RepairHistoryRecord' AND c.fixHeld = false ORDER BY c.closedUtc DESC