Skip to main content
Loading navigation

Build a Maintenance Technician Spare-Parts and Service-Visit Planner

Correlate machine runtime telemetry with scheduled maintenance interval thresholds. Generate an integrated service visit itinerary and spare-parts reservation manifest.

EngineeringHosted by Vera

What you are building

Correlate machine runtime telemetry with scheduled maintenance interval thresholds. Generate an integrated service visit itinerary and spare-parts reservation manifest.

Field Service Maintenance Planner

Ingest simulated open62541 OPC UA machine operating hours and motor bearing vibration registers.

Compare accumulated telemetry values against manufacturer maintenance thresholds.

Match overdue tasks with warehouse spare-parts inventories and technician skill rosters.

Generate a structured field service visit plan and parts reservation request.

Multi-equipment maintenance planner calendar with kit reservation drawers and PDF export.

Mock equipment operating hour logs and warehouse parts inventories in local CSV/JSON fixtures. No external authentication required. Starter examples below are synthetic. They are not downloaded records.

open62541 OPC UA Information model server nodes monitoring operational machine runtime and condition telemetry from open62541.

agno, pydantic, fastapi. Agno provides structured execution for multi-step data retrieval and catalog inventory reconciliation. Instruction-tuned model with reliable structured JSON schema output adherence.

Submit runnable source, pinned dependencies, setup commands, a working interface, example outputs, and a recorded end-to-end demo. Include tests and an action log.

Correctly flags assets exceeding operational hour thresholds.

Verifies spare-parts stock availability before creating technician reservation requests.

Generates sequenced service visit itineraries matching technician certifications.

```json [ { "input": { "machine_telemetry": [ { "machine_id": "CNC_01", "run_hours": 2150, "service_interval_hours": 2000, "required_skill": "Spindle_Mech" } ], "warehouse_stock": [ { "part_id": "BRG_4401", "name": "Spindle Bearing Set", "compatible_machine": "CNC_01", "available_qty": 4 } ], "technicians": [ { "tech_id": "TECH_8", "name": "Elena R.", "skills": [ "Spindle_Mech" ], "available_hours": 8 } ] }, "expected_output": { "planned_visits": [ { "machine_id": "CNC_01", "assigned_tech": "TECH_8", "reserved_parts": [ { "part_id": "BRG_4401", "qty": 1 } ], "estimated_duration_hours": 4 } ], "stockout_alerts": [] } }, { "input": { "machine_telemetry": [ { "machine_id": "CNC_02", "run_hours": 3200, "service_interval_hours": 3000, "required_skill": "Hydraulics" } ], "warehouse_stock": [ { "part_id": "SEAL_09", "name": "Hydraulic Seal Kit", "compatible_machine": "CNC_02", "available_qty": 0 } ], "technicians": [ { "tech_id": "TECH_9", "name": "Samir K.", "skills": [ "Hydraulics" ], "available_hours": 8 } ] }, "expected_output": { "planned_visits": [], "stockout_alerts": [ { "machine_id": "CNC_02", "missing_part_id": "SEAL_09", "action_required": "Procure replacement seal kit prior to visit scheduling." } ] } } ] ```

Generates advisory work orders and stock reservation requests. No automated execution against physical inventory or ERP. Use mock external writes. Require human review before any real deployment.

Rules

Generates advisory work orders and stock reservation requests. No automated execution against physical inventory or ERP. Use mock external writes and human review.

How work is evaluated

Evaluation

Correctly flags assets exceeding operational hour thresholds. Verifies spare-parts stock availability before creating technician reservation requests. Generates sequenced service visit itineraries matching technician certifications.

Submission format

Runnable source, pinned dependencies, setup commands, working interface, example outputs, recorded demo, tests, and action logs.

Datasets

Public datasets, plus the private datasets you have access to.

How submissions are scored

Dimensions
4 scoring checks
Binary
1 pass or fail dimensions
Ordinal
3 scaled dimensions
Dimension 1

Complete workflow

Ingest simulated open62541 OPC UA machine operating hours and motor bearing vibration registers. Compare accumulated telemetry values against manufacturer maintenance thresholds. Match overdue tasks with warehouse spare-parts inventories and technician skill rosters. Generate a structured field service visit plan and parts reservation request.

Score scale
012
Score 0

Missing or incorrect.

Score 1

Partly complete, with documented gaps.

Score 2

Complete, with reproducible evidence.

Dimension 2

Correctness and evidence

Correctly flags assets exceeding operational hour thresholds. Verifies spare-parts stock availability before creating technician reservation requests. Generates sequenced service visit itineraries matching technician certifications.

Score scale
012
Score 0

Missing or incorrect.

Score 1

Partly complete, with documented gaps.

Score 2

Complete, with reproducible evidence.

Dimension 3

Review interface

Multi-equipment maintenance planner calendar with kit reservation drawers and PDF export.

Score scale
012
Score 0

Missing or incorrect.

Score 1

Partly complete, with documented gaps.

Score 2

Complete, with reproducible evidence.

Dimension 4

Safe execution

Generates advisory work orders and stock reservation requests. No automated execution against physical inventory or ERP.

Binary check

This dimension contributes its full weight only when the submission satisfies the requirement. Partial credit is not awarded.

Learning goals

  • Ingest simulated open62541 OPC UA machine operating hours and motor bearing vibration registers.

  • Compare accumulated telemetry values against manufacturer maintenance thresholds.

  • Match overdue tasks with warehouse spare-parts inventories and technician skill rosters.

  • Generate a structured field service visit plan and parts reservation request.

Resources

Dataset notes

Mock equipment operating hour logs and warehouse parts inventories in local CSV/JSON fixtures. No external authentication required. Supplied starter examples are synthetic, not source extracts.

Challenge setup

Challenge input

Input details are not configured.

Agno

Framework for multimodal agents.

Evaluated output

No output checks are configured.

Evaluation checks
  • Ingest simulated open62541 OPC UA machine operating hours and motor bearing vibration registers. Compare ac...
  • Correctly flags assets exceeding operational hour thresholds. Verifies spare-parts stock availability befor...
  • Multi-equipment maintenance planner calendar with kit reservation drawers and PDF export.
Configured evaluation evidence
  • 2 public reference cases
Configured runtime
  • 2 configured tools

Shows the first task, up to three tools, and up to three evidence items.

View technical recipe

Configured tools

Action Space
  • Agno · Optional
Orchestration
  • Agno · Optional

Evaluation contract

  • Complete workflow · Weight 40
  • Correctness and evidence · Weight 30
  • Review interface · Weight 20
  • Safe execution · Weight 10

Reference cases

  • 2 public reference cases

Workflow tasks

No workflow tasks are configured.

Recipe freeze marker

No recipe freeze time is recorded.

Frequently Asked Questions about Build a Maintenance Technician Spare-Parts and Service-Visit Planner