Core AI Framework

• Primary Framework: OpenAI Agents Framework
• Language Model: GPT-4o-mini (cost-optimized for high-volume processing)
• Alternative Model: GPT-4o (premium accuracy for complex cases)
• Structured Output: Pydantic models for validated responses

Function Tools & APIs

Local Medical Database APIs

• Conditions API: 2,400+ medical conditions with ICD codes
• Procedures API: 280+ surgical procedures
• ICD-10-CM API: Complete diagnostic code database
• HCPCS API: Medical equipment and supplies

Web Search Tools

• WebSearchTool: High-context web search for authoritative sources
• Target Sources: AMA, CMS, GenHealth, Clinical Tables NLM
• Search Strategy: Medical coding-specific queries with context preservation

Data Models

class CPCAnswer(BaseModel):
    answer: Literal["A", "B", "C", "D"]  # Required answer letter
    confidence: float                     # 0.0 to 1.0 confidence score
    reasoning: str                       # Detailed explanation
    code_found: str                      # Specific medical code identified

class QuestionAnalysis(BaseModel):
    question_type: Literal[...]          # Question classification
    key_terms: List[str]                 # Extracted medical terms
    requires_web_search: bool            # Search requirement flag

Infrastructure & Environment

Development Environment

• Language: Python 3.8+