Skip to main content
Challenge

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
Challenge brief

What you are building

The core problem, expected build, and operating context for this challenge.

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

Participation guide

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

Delivery guide

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

Challenge datasets

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

Evaluation rubric

How submissions are scored

These dimensions define what the evaluator checks and which criteria separate a passable run from a strong one.

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

What you should walk away with

  • 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 and assets

Reference links and supporting material

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

Configuration summary for this challenge.

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

Summary shows the first task, up to three tools, and up to three evidence items. Open the technical recipe to view all configured 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