Class IntentClassifier

intent_classifier.py:14–192

Classifies user intent from natural language questions

class IntentClassifier:
    """
    Classifies user intent from natural language questions
    """
    
    # Intent patterns using keywords and phrases
    INTENT_PATTERNS = {
        'trend_analysis': [
            r'\btrend\b', r'\bover time\b', r'\bincreas(ing|e|ed)\b',
            r'\bdecreas(ing|e|ed)\b', r'\bgrow(th|ing)\b', r'\bdeclin(e|ing)\b',
            r'\bchanging\b', r'\bevolution\b', r'\btrajectory\b'
        ],
        'comparison': [
            r'\bcompare\b', r'\bvs\.?\b', r'\bversus\b', r'\bbetter\b',
            r'\bworse\b', r'\bdifference\b', r'\bhigher\b', r'\blower\b',
            r'\bbetween\b.*\band\b'
        ],
        'explanation': [
            r'\bwhy\b', r'\bhow\b', r'\bexplain\b', r'\breason\b',
            r'\bcause\b', r'\bwhat.*mean\b', r'\bwhat.*affect\b',
            r'\broot cause\b', r'\bdriv(e|ing|en)\b'
        ],
        'recommendation': [
            r'\brecommend\b', r'\bsugg(est|estion)\b', r'\bwhat should\b',
            r'\badvice\b', r'\baction\b', r'\bimprove\b', r'\boptimiz\w+\b',
            r'\benhance\b'
        ],
        'kpi_query': [
            r'\bkpi\b', r'\bmetric\b', r'\bindicator\b', r'\bperformance\b',
            r'\bscore\b', r'\brating\b', r'\bvalue of\b'
        ],
        'dashboard_summary': [
            r'\bdashboard\b', r'\boverview\b', r'\bsummary\b', r'\bsummariz\w+\b',
            r'\ball.*kpis\b', r'\bshow me everything\b'
        ],
        'anomaly_detection': [
            r'\banomal(y|ies)\b', r'\boutlier\b', r'\bunusual\b',
            r'\bstrange\b', r'\bodd\b', r'\bunexpected\b', r'\birregular\b'
        ],
        'general_query': [
            r'\bwhat is\b', r'\btell me about\b', r'\bshow me\b',
            r'\bgive me\b', r'\bfind\b', r'\blist\b'
        ]
    }
    
    def classify_intent(self, query: str) -> Tuple[str, float]:
        """
        Classify the intent of a user query
        
        Args:
            query: User's natural language query
            
        Returns:
            Tuple of (intent, confidence_score)
        """
        query_lower = query.lower()
        
        intent_scores = {}