Backend / src /services /intent-classifier.service.ts
Cuong2004's picture
Refactor intent classification logic in IntentClassifierService to prioritize image presence and improve casual greeting detection. Introduce a structured priority system for intent classification, enhancing accuracy for triage and disease information queries while ensuring casual greetings are only identified when appropriate. Update the isCasualGreeting method to exclude medical terms from greeting detection.
80b0d14
import { logger } from '../utils/logger.js';
export type IntentType = 'triage' | 'disease_info' | 'symptom_inquiry' | 'general_health' | 'out_of_scope' | 'casual_greeting';
export interface Intent {
type: IntentType;
confidence: number;
entities: {
disease?: string;
symptoms?: string[];
info_domain?: 'definition' | 'causes' | 'symptoms' | 'treatment' | 'prevention' | 'complications';
urgency_indicators?: string[];
};
needsClarification: boolean;
suggestedQuestion?: string;
}
/**
* Intent Classification Service
* Phân loại ý định của user theo spec AI-Agent.md
*/
export class IntentClassifierService {
// Keywords for different intents
private readonly TRIAGE_KEYWORDS = [
'đau', 'sốt', 'chảy máu', 'khó thở', 'nôn', 'buồn nôn',
'ngất', 'chóng mặt', 'mệt', 'yếu', 'tôi bị', 'em bị',
'con tôi', 'triệu chứng', 'cấp cứu', 'khẩn cấp'
];
private readonly DISEASE_INFO_KEYWORDS = [
'bệnh', 'là gì', 'như thế nào', 'giải thích', 'cho tôi biết',
'thông tin về', 'tìm hiểu về', 'định nghĩa', 'nguyên nhân'
];
// Treatment keywords can be used for future treatment-related intent classification
// private readonly TREATMENT_KEYWORDS = [
// 'điều trị', 'chữa', 'phòng ngừa', 'phòng bệnh', 'cách chữa',
// 'cách điều trị', 'thuốc', 'liệu pháp'
// ];
private readonly OUT_OF_SCOPE_KEYWORDS = [
'bảo hiểm', 'bhyt', 'chi phí', 'giá', 'thủ tục',
'thuốc nam', 'đông y', 'thảo dược', 'bài thuốc'
];
private readonly CASUAL_GREETING_KEYWORDS = [
'xin chào', 'chào', 'hi', 'hello', 'cảm ơn', 'thanks', 'thank you',
'tạm biệt', 'bye', 'goodbye', 'ok', 'okay', 'được rồi', 'hiểu rồi',
'vâng', 'dạ', 'ừ', 'ừm', 'uhm', 'à', 'ah'
];
/**
* Classify user intent based on query text
*/
classifyIntent(query: string, hasImage: boolean = false): Intent {
const lowerQuery = query.toLowerCase().trim();
logger.info(`Classifying intent for query: "${query.substring(0, 50)}..."`);
// PRIORITY 1: If has image, ALWAYS triage (unless it's clearly just a greeting)
if (hasImage) {
// Only treat as casual greeting if it's VERY short and clearly just greeting
if (lowerQuery.length <= 10 && this.isCasualGreeting(lowerQuery)) {
return {
type: 'casual_greeting',
confidence: 0.9,
entities: {},
needsClarification: false
};
}
// Otherwise, image + any text = triage
return this.classifyTriageIntent(lowerQuery, hasImage);
}
// PRIORITY 2: Check for out of scope
if (this.isOutOfScope(lowerQuery)) {
return {
type: 'out_of_scope',
confidence: 0.9,
entities: {},
needsClarification: false
};
}
// PRIORITY 3: Check for triage keywords/symptoms (personal health concerns)
// If has clear symptoms, it's triage (not casual greeting)
const hasTriageKeywords = this.calculateKeywordScore(lowerQuery, this.TRIAGE_KEYWORDS) > 0;
const hasSymptoms = this.extractSymptoms(lowerQuery).length > 0;
const hasPersonalPronouns = this.hasPersonalPronouns(lowerQuery);
// If has symptoms or triage keywords, it's triage
if (hasTriageKeywords || hasSymptoms || (hasPersonalPronouns && lowerQuery.length > 15)) {
return this.classifyTriageIntent(lowerQuery, hasImage);
}
// PRIORITY 4: Check for disease info keywords (educational)
const diseaseInfoScore = this.calculateKeywordScore(lowerQuery, this.DISEASE_INFO_KEYWORDS);
if (diseaseInfoScore > 0.2) {
return this.classifyDiseaseInfoIntent(lowerQuery);
}
// PRIORITY 5: Check for casual greeting (only if no symptoms/keywords found)
if (this.isCasualGreeting(lowerQuery)) {
return {
type: 'casual_greeting',
confidence: 0.95,
entities: {},
needsClarification: false
};
}
// PRIORITY 6: Default fallback
// If has personal pronouns but unclear, default to triage for safety
if (hasPersonalPronouns) {
return this.classifyTriageIntent(lowerQuery, hasImage);
}
// Otherwise, default to disease info for educational queries
return this.classifyDiseaseInfoIntent(lowerQuery);
}
private classifyTriageIntent(query: string, hasImage: boolean = false): Intent {
const symptoms = this.extractSymptoms(query);
const urgencyIndicators = this.extractUrgencyIndicators(query);
// If we have an image, we don't need text clarification
const needsClarification = !hasImage && symptoms.length === 0 && urgencyIndicators.length === 0;
return {
type: 'triage',
confidence: 0.8,
entities: {
symptoms,
urgency_indicators: urgencyIndicators
},
needsClarification,
suggestedQuestion: needsClarification
? 'Bạn có thể mô tả chi tiết hơn về triệu chứng đang gặp phải không?'
: undefined
};
}
private classifyDiseaseInfoIntent(query: string): Intent {
const disease = this.extractDiseaseName(query);
const infoDomain = this.extractInfoDomain(query);
return {
type: 'disease_info',
confidence: 0.7,
entities: {
disease,
info_domain: infoDomain
},
needsClarification: !disease && !infoDomain,
suggestedQuestion: !disease
? 'Bạn muốn tìm hiểu về bệnh gì? Ví dụ: trứng cá, vảy nến, viêm kết mạc...'
: !infoDomain
? `Bạn muốn biết về ${disease}: Định nghĩa / Nguyên nhân / Triệu chứng / Điều trị / Phòng bệnh?`
: undefined
};
}
private isOutOfScope(query: string): boolean {
return this.OUT_OF_SCOPE_KEYWORDS.some(keyword => query.includes(keyword));
}
private isCasualGreeting(query: string): boolean {
// Check if query is very short (likely greeting) or contains greeting keywords
const trimmedQuery = query.trim();
// Very short queries (<= 10 chars) are likely greetings
if (trimmedQuery.length <= 10) {
return this.CASUAL_GREETING_KEYWORDS.some(keyword => trimmedQuery.includes(keyword)) ||
/^(hi|hello|chào|xin chào|cảm ơn|thanks|ok|okay|vâng|dạ|ừ|bye)$/i.test(trimmedQuery);
}
// For longer queries, only match if it's EXACTLY a greeting phrase
// Don't match if query contains symptoms or medical terms
const hasMedicalTerms = this.TRIAGE_KEYWORDS.some(kw => query.includes(kw)) ||
this.DISEASE_INFO_KEYWORDS.some(kw => query.includes(kw)) ||
/(đau|sốt|bệnh|triệu chứng|mụn|nhọt|sưng|ngứa)/i.test(query);
if (hasMedicalTerms) {
return false; // Not a casual greeting if has medical terms
}
// Check if it's a pure greeting phrase
return this.CASUAL_GREETING_KEYWORDS.some(keyword => {
// Match only if keyword is at the start or is the main content
const keywordIndex = query.indexOf(keyword);
return keywordIndex >= 0 && (keywordIndex === 0 || query.length <= keyword.length + 5);
});
}
private calculateKeywordScore(query: string, keywords: string[]): number {
const matches = keywords.filter(keyword => query.includes(keyword));
return matches.length / keywords.length;
}
private hasPersonalPronouns(query: string): boolean {
const pronouns = ['tôi', 'em', 'con tôi', 'con em', 'bố', 'mẹ', 'anh', 'chị'];
return pronouns.some(pronoun => query.includes(pronoun));
}
private extractSymptoms(query: string): string[] {
const symptoms: string[] = [];
// Common symptom patterns
const symptomPatterns = [
/đau\s+(\w+)/gi,
/sốt/gi,
/chảy\s+máu/gi,
/khó\s+thở/gi,
/nôn/gi,
/buồn\s+nôn/gi,
/chóng\s+mặt/gi,
/ngứa/gi,
/sưng/gi,
/đỏ/gi,
/mẩn/gi,
/nổi\s+mụn/gi
];
for (const pattern of symptomPatterns) {
const matches = query.match(pattern);
if (matches) {
symptoms.push(...matches);
}
}
return [...new Set(symptoms)];
}
private extractUrgencyIndicators(query: string): string[] {
const urgencyKeywords = [
'cấp cứu', 'khẩn cấp', 'ngay lập tức', 'gấp', 'nặng',
'khó thở', 'chảy máu nhiều', 'ngất', 'bất tỉnh'
];
return urgencyKeywords.filter(keyword => query.includes(keyword));
}
private extractDiseaseName(query: string): string | undefined {
// Common disease names in Vietnamese
const diseases = [
'trứng cá', 'mụn', 'vảy nến', 'viêm da',
'viêm kết mạc', 'đau mắt đỏ', 'viêm giác mạc',
'viêm gan', 'tiểu đường', 'cao huyết áp',
'hen suyễn', 'dị ứng', 'sốt xuất huyết',
'cúm', 'covid', 'viêm họng', 'viêm amidan'
];
for (const disease of diseases) {
if (query.includes(disease)) {
return disease;
}
}
return undefined;
}
private extractInfoDomain(query: string): Intent['entities']['info_domain'] {
if (/định nghĩa|là gì|như thế nào/.test(query)) {
return 'definition';
} else if (/nguyên nhân|tại sao|do đâu/.test(query)) {
return 'causes';
} else if (/triệu chứng|dấu hiệu|biểu hiện/.test(query)) {
return 'symptoms';
} else if (/điều trị|chữa|cách chữa/.test(query)) {
return 'treatment';
} else if (/phòng ngừa|phòng bệnh|cách phòng/.test(query)) {
return 'prevention';
} else if (/biến chứng|nguy hiểm|hậu quả/.test(query)) {
return 'complications';
}
return undefined;
}
}