Skip to main content

sdac-classify-job-titles

Purpose​

Uses AI to suggest SDAC function codes for ambiguous or missing job titles.

Tool type​

AI-assisted (LLM; non-deterministic)

Tool ID​

sdac-classify-job-titles

Inputs​

  • report_id (string)
  • confidence_threshold (number, optional, default: 0.7)
  • batch_size (number, optional, default: 50)

Outputs​

  • Suggested function codes with confidence and explanations
  • Summary distribution of suggested codes

Example output​

{
  "success": true,
  "report_id": "SDAC-2024-Q2-001",
  "total_classified": 2,
  "classifications": [
    {
      "record_id": 211,
      "row_number": 27,
      "job_title": "Speech Language Pathologist",
      "suggested_function_code": "2160",
      "confidence": 0.94,
      "explanation": "The title maps clearly to speech pathology services."
    }
  ],
  "summary": {
    "2140": 1,
    "2160": 1
  }
}

Functional details​

  • Sends job titles to the SDAC Job Title Classifier agent.
  • Returns recommended function codes and rationale.
  • Filters results below confidence_threshold.

Implementation details​

  • Skips records with an existing 4-digit FunctionCode.
  • Uses the SDAC classifier agent for contextual classification.
  • Filters out results below confidence_threshold.
  • Builds a code_distribution summary from suggested codes.

Code Location: packages/domain-sdac/src/tools/classify-job-titles.tool.ts