File size: 2,542 Bytes
749ed59
6ca77a7
749ed59
 
 
 
6ca77a7
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
fd1f4a5
6ca77a7
 
 
 
 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
spec_version: 1
name: medcoderl
type: space
runtime: fastapi
app: server.app:app
port: 7680

description: >
  MedCodeRL β€” Medical Coding & Billing Compliance environment.
  Agents analyze clinical documentation and assign ICD-10/CPT codes,
  make billing compliance decisions, and identify fraud patterns.
  90 synthetic cases across 3 difficulty tiers with deterministic grading.

author: privexa
version: 1.0.0
tags:
  - openenv
  - medical-coding
  - healthcare
  - compliance

tasks:
  easy:
    description: "Straightforward cases with single diagnoses and direct ICD-10/CPT mapping."
    count: 30
  medium:
    description: "Multi-diagnosis cases with comorbidities, insurance considerations, and partial ambiguity."
    count: 30
  hard:
    description: "Complex compliance dilemmas: upcoding, unbundling, fraud detection, ethical edge cases."
    count: 30

action_space:
  type: object
  model: models.MedAction
  fields:
    diagnosis_codes: "list[str] β€” ICD-10-CM codes (1-5)"
    procedure_codes: "list[str] β€” CPT/HCPCS codes (0-5)"
    decision: "str β€” approve | reject | review"
    confidence: "float β€” 0.0 to 1.0"
    reasoning: "str β€” clinical justification (15-500 chars)"
    modifier_codes: "list[str] β€” optional CPT modifiers (0-3)"
    risk_flags: "list[str] β€” compliance risk flags (0-5)"

observation_space:
  type: object
  model: models.MedObservation
  fields:
    case_id: "str β€” unique case identifier"
    difficulty: "str β€” easy | medium | hard"
    clinical_note: "str β€” full clinical documentation"
    symptoms: "list[str] β€” reported symptoms"
    treatments: "list[str] β€” treatments administered"
    insurance_type: "str β€” Medicare | Medicaid | Private | Uninsured"
    prior_auth_required: "bool β€” prior authorization needed"
    treatment_cost: "str β€” low | medium | high"
    patient_age: "int β€” patient age in years"
    patient_sex: "str β€” M | F"
    provider_specialty: "str β€” treating provider specialty"
    visit_type: "str β€” inpatient | outpatient | emergency | telehealth"
    comorbidities: "list[str] β€” pre-existing conditions"
    lab_results: "str | null β€” relevant lab findings"
    medications: "list[str] β€” current medications"

reward_space:
  type: float
  range: [0.01, 0.99]
  description: >
    Deterministic composite score: diagnosis accuracy (35%),
    procedure accuracy (20%), decision accuracy (25%),
    reasoning quality (10%), risk flag identification (5%),
    confidence calibration (5%). Shaped with bonuses and penalties.