Renewable Energy Utilities · Field Service Supervisors
Scoring Wind Turbine Maintenance Report Completeness
Field service supervisors frequently receive offshore wind turbine gearbox maintenance logs that omit key particulate findings, seal condition notes, or oil readings. This example evaluates the descriptive thoroughness of technician logs across three completeness levels to decide whether a work order summary is detailed enough for supervisor review or requires immediate text enrichment.
Updated · Examples verified with jev-1.13.0
The problem
Field technicians submit a free-text maintenance work summary after completing gearbox lubrication servicing under demanding site conditions. Summaries often leave out critical quantitative readings, such as particulate counts or viscosity values, or fail to describe mechanical seal conditions. The asset management application must evaluate the descriptive completeness of these notes so incomplete logs can be flagged for technician revision before review. Because text thoroughness does not verify mechanical safety or replace physical inspections, the application uses this score solely for documentation triage.
How TypeSafe helps
The gearbox_report_completeness question evaluates the technician's maintenance_work_summary text across three defined descriptive levels. In the observed runs, the model returned a score of 2.0 when the summary included both qualitative component checks and quantitative readings, 1.0 when it contained qualitative gear observations without measurements, and 0.21 when it offered only a brief generic confirmation. Application code can use this score to triage submissions, routing logs near 2.0 to field supervisors while prompting technicians to supply missing observations or measurements for lower scores. This workflow remains an application policy rather than an automated API execution, and completeness scoring functions purely as documentation triage without verifying mechanical safety or replacing independent physical inspections.
- Input
- The maintenance_work_summary text submitted by the field technician upon service completion.
- Decision
- Score: Score report completeness on three levels: 0 (insufficient summary lacking specific component observations), 1 (basic summary with qualitative notes but missing physical measurements), and 2 (thorough report detailing component conditions and quantitative readings).
- Next action
- Utility asset management software marks the technician work order as completed for score 2 or prevents work order sign-off and notifies the technician to enrich their notes for scores 0 and 1.
Three verified examples
These responses were returned during a previous API verification. New probabilities can differ.
thorough_gearbox_log_with_measurements (primary)
Expected behavior: The log provides qualitative observations of gear teeth wear and seal condition alongside quantitative data for lubricant volume, viscosity, ISO cleanliness code, and operating temperature.
Input
{
"turbine_id": "WTG-04B",
"service_type": "Gearbox Lubrication Inspection",
"maintenance_work_summary": "Completed 500-hour gearbox lubrication maintenance. Flushed inline filtration system and replaced dual filter elements. Visual inspection of planetary gear teeth revealed normal wear patterns with no micro-pitting or scoring. Main shaft mechanical seal intact with zero weepage observed. Oil reservoir refilled with 420 liters of Mobilgear SHC XMP 320; measured kinematic viscosity at 40C was 318 cSt. Inline optical particle counter registered ISO 4406 cleanliness code of 16/14/11. Sump temperature stabilized at 62C post-test run."
}Previous verification response
jev-1.13.0 ·
{
"model": "jev-1.13.0",
"usage": {
"input_tokens": 507,
"output_tokens": 24
},
"answers": {
"gearbox_report_completeness": {
"type": "score",
"score": 2,
"legend": {
"0": "Insufficient summary lacking specific component observations",
"1": "Basic summary with qualitative notes but missing physical measurements",
"2": "Thorough report detailing component conditions and quantitative readings"
},
"confidence": 1,
"probabilities": {
"0": 0,
"1": 0,
"2": 1
}
}
}
}qualitative_gearbox_log_without_measurements (alternative)
Expected behavior: The log records specific qualitative component details for the pinion teeth, filter elements, and seal surfaces, but omits physical readings such as viscosity, particle counts, oil volume, and temperature.
Input
{
"turbine_id": "WTG-12A",
"service_type": "Gearbox Lubrication Inspection",
"maintenance_work_summary": "Serviced the main gearbox lubrication loop. Replaced oil filter cartridges and wiped down casing. Inspected the intermediate pinion teeth through inspection hatch; gears look smooth with no visible surface damage. Gearbox seals appeared dry and in acceptable condition. Topped off reservoir with fresh gear oil. System ran quietly during post-service startup."
}Previous verification response
jev-1.13.0 ·
{
"model": "jev-1.13.0",
"usage": {
"input_tokens": 444,
"output_tokens": 24
},
"answers": {
"gearbox_report_completeness": {
"type": "score",
"score": 1,
"legend": {
"0": "Insufficient summary lacking specific component observations",
"1": "Basic summary with qualitative notes but missing physical measurements",
"2": "Thorough report detailing component conditions and quantitative readings"
},
"confidence": 1,
"probabilities": {
"0": 0,
"1": 1,
"2": 0
}
}
}
}brief_gearbox_log_missing_component_observations (edge case)
Expected behavior: The log provides only a generic confirmation of service completion with no specific observations of gear components, seals, filters, or physical measurements.
Input
{
"turbine_id": "WTG-09C",
"service_type": "Gearbox Lubrication Inspection",
"maintenance_work_summary": "Routine lube service performed as scheduled. Everything checked out okay."
}Previous verification response
jev-1.13.0 ·
{
"model": "jev-1.13.0",
"usage": {
"input_tokens": 386,
"output_tokens": 24
},
"answers": {
"gearbox_report_completeness": {
"type": "score",
"score": 0.21,
"legend": {
"0": "Insufficient summary lacking specific component observations",
"1": "Basic summary with qualitative notes but missing physical measurements",
"2": "Thorough report detailing component conditions and quantitative readings"
},
"confidence": 0.68,
"probabilities": {
"0": 0.79,
"1": 0.21,
"2": 0
}
}
}
}Try online
Start with a verified example, edit the request, then ask Jev. A live request is sent only when you press Try online.
Expected behavior: The log provides qualitative observations of gear teeth wear and seal condition alongside quantitative data for lubricant volume, viscosity, ISO cleanliness code, and operating temperature.
Use non-sensitive test data. Live input goes to typesafe.pro and TypeSafe. Anonymous requests use the gateway’s free rate limit.
A position on your scale
The score can fall between levels. Confidence describes how concentrated the answer is, not whether it is correct.
import jsonfrom urllib.error import HTTPError, URLErrorfrom urllib.request import Request, urlopenBASE_URL = "https://api.typesafe.pro"payload = { "model": "jev-latest", "state": { "turbine_id": "WTG-04B", "service_type": "Gearbox Lubrication Inspection", "maintenance_work_summary": "Completed 500-hour gearbox lubrication maintenance. Flushed inline filtration system and replaced dual filter elements. Visual inspection of planetary gear teeth revealed normal wear patterns with no micro-pitting or scoring. Main shaft mechanical seal intact with zero weepage observed. Oil reservoir refilled with 420 liters of Mobilgear SHC XMP 320; measured kinematic viscosity at 40C was 318 cSt. Inline optical particle counter registered ISO 4406 cleanliness code of 16/14/11. Sump temperature stabilized at 62C post-test run.", }, "questions": { "gearbox_report_completeness": { "type": "score", "criteria": [ "Insufficient summary lacking specific component observations", "Basic summary with qualitative notes but missing physical measurements", "Thorough report detailing component conditions and quantitative readings", ], "instructions": "Evaluate the maintenance_work_summary text for descriptive thoroughness regarding component inspection observations and quantitative measurements.", }, },}request = Request( f"{BASE_URL}/v1/systemone", data=json.dumps(payload).encode("utf-8"), headers={"Content-Type": "application/json"}, method="POST",)try: with urlopen(request, timeout=20) as response: result = json.load(response)except HTTPError as error: raise SystemExit(f"API returned HTTP {error.code}") from errorexcept URLError as error: raise SystemExit(f"Connection failed: {error.reason}") from errorprint(json.dumps(result["answers"], indent=2))Limitations and review
- The evaluation examines only the textual thoroughness of the submitted maintenance_work_summary; mentioning a turbine_id or service_type does not verify that the asset is active, authorized, or correctly serviced.
- The three-level rubric scores whether qualitative observations and quantitative metrics were described, but it does not check recorded figures such as viscosity or ISO cleanliness against authoritative engineering specifications.
- Scoring text completeness does not constitute work order approval, so you can implement application checks or supervisor sign-offs to validate asset condition before closing maintenance records.
Set thresholds against your own examples before relying on an automated decision.