feat(api): Phase 13 智能路由 + CI/CD 整合 (#74-88)
Phase 13.1 CI/CD Integration: - #76 workflow_run handler for CI failure diagnosis - #77 SignOz log query (query_logs, error_logs_summary MCP) - #78 CIAutoRepairService with risk-based execution decisions Phase 13.3 Smart Routing: - #85 Intent Classifier v2.0 (rule engine + LLM fallback) - #86 Complexity Scorer (9-dimension scoring) - #87 AI Router v3.0 (routing decision matrix) - #88 Token Counter (OTEL + Langfuse integration) New files: - services/ci_auto_repair.py (risk stratification) - services/model_registry.py (centralized model config) - services/token_counter.py (677 lines) - Skill 08: Model Router Expert - Skill 09: Strangler Pattern Expert - ADR-023: Smart Routing Architecture - ADR-024: API Layer Architecture Tests: - phase11-conversational.spec.ts (E2E tests) Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
This commit is contained in:
OG T
@@ -1,141 +1,600 @@
|
||||
"""
|
||||
Intent Classifier - Phase 13.3 #85
|
||||
===================================
|
||||
快速意圖分類，用於智能路由
|
||||
K8s 操作意圖分類器，用於智能路由模型選擇
|
||||
|
||||
目標: < 100ms 延遲
|
||||
策略: 關鍵字優先 → 小模型備援
|
||||
目標: < 100ms 延遲 (規則引擎 < 10ms)
|
||||
策略: 方案 A (規則引擎) → 方案 B (LLM 備援)
|
||||
|
||||
Phase 13.3 (2026-03-26): 初始實作
|
||||
版本: v2.0
|
||||
建立: 2026-03-26 (台北時區)
|
||||
建立者: Claude Code
|
||||
最後修改: 2026-03-26 (台北時區)
|
||||
修改者: Claude Code
|
||||
|
||||
變更紀錄:
|
||||
| 版本 | 日期 | 執行者 | 變更內容 |
|
||||
|------|------|--------|----------|
|
||||
| v1.0 | 2026-03-26 | Claude Code | 初始實作 (舊版 IntentType) |
|
||||
| v2.0 | 2026-03-26 | Claude Code | Phase 13.3 #85 升級 (四大核心+輔助意圖) |
|
||||
"""
|
||||
|
||||
from __future__ import annotations
|
||||
|
||||
import re
|
||||
from dataclasses import dataclass, field
|
||||
from enum import Enum
|
||||
from typing import Protocol, runtime_checkable
|
||||
|
||||
import structlog
|
||||
|
||||
from src.services.model_registry import get_model_registry
|
||||
|
||||
logger = structlog.get_logger(__name__)
|
||||
|
||||
|
||||
# =============================================================================
|
||||
# 意圖類型定義 (Phase 13.3 #85)
|
||||
# =============================================================================
|
||||
|
||||
|
||||
class IntentType(Enum):
|
||||
"""意圖類型"""
|
||||
"""
|
||||
K8s 操作意圖類型
|
||||
|
||||
ALERT_TRIAGE = "alert_triage" # 告警分流/處理
|
||||
DEPLOYMENT = "deployment" # 部署操作 (kubectl, rollout)
|
||||
QUERY = "query" # 資訊查詢 (狀態, 日誌)
|
||||
MAINTENANCE = "maintenance" # 維運操作 (重啟, 擴容)
|
||||
CODE_REVIEW = "code_review" # 程式碼審查
|
||||
UNKNOWN = "unknown"
|
||||
四大核心意圖:
|
||||
- RESTART: 重啟 Pod/Deployment/StatefulSet
|
||||
- SCALE: 擴縮容、HPA 調整
|
||||
- CONFIG: ConfigMap/Secret/ENV 變更
|
||||
- DIAGNOSE: 日誌查詢、健康檢查、RCA
|
||||
|
||||
輔助意圖:
|
||||
- DELETE: 刪除資源（高風險）
|
||||
- ROLLBACK: 回滾版本
|
||||
- UNKNOWN: 無法判斷
|
||||
|
||||
舊版兼容 (已棄用，映射到新意圖):
|
||||
- ALERT_TRIAGE → DIAGNOSE
|
||||
- DEPLOYMENT → CONFIG
|
||||
- QUERY → DIAGNOSE
|
||||
- MAINTENANCE → RESTART
|
||||
- CODE_REVIEW → DIAGNOSE
|
||||
"""
|
||||
|
||||
# 四大核心意圖
|
||||
RESTART = "restart" # 重啟 Pod/Deployment/StatefulSet
|
||||
SCALE = "scale" # 擴縮容、HPA 調整
|
||||
CONFIG = "config" # ConfigMap/Secret/ENV 變更
|
||||
DIAGNOSE = "diagnose" # 日誌查詢、健康檢查、RCA
|
||||
|
||||
# 輔助意圖
|
||||
DELETE = "delete" # 刪除資源（高風險）
|
||||
ROLLBACK = "rollback" # 回滾版本
|
||||
UNKNOWN = "unknown" # 無法判斷
|
||||
|
||||
# 舊版兼容 (棄用，保留向後兼容)
|
||||
ALERT_TRIAGE = "alert_triage" # → DIAGNOSE
|
||||
DEPLOYMENT = "deployment" # → CONFIG
|
||||
QUERY = "query" # → DIAGNOSE
|
||||
MAINTENANCE = "maintenance" # → RESTART
|
||||
CODE_REVIEW = "code_review" # → DIAGNOSE
|
||||
|
||||
|
||||
# 關鍵字映射 (優先匹配，0ms)
|
||||
# 舊版意圖到新版的映射
|
||||
LEGACY_INTENT_MAP: dict[IntentType, IntentType] = {
|
||||
IntentType.ALERT_TRIAGE: IntentType.DIAGNOSE,
|
||||
IntentType.DEPLOYMENT: IntentType.CONFIG,
|
||||
IntentType.QUERY: IntentType.DIAGNOSE,
|
||||
IntentType.MAINTENANCE: IntentType.RESTART,
|
||||
IntentType.CODE_REVIEW: IntentType.DIAGNOSE,
|
||||
}
|
||||
|
||||
|
||||
def normalize_intent(intent: IntentType) -> IntentType:
|
||||
"""
|
||||
正規化意圖 (將舊版意圖映射到新版)
|
||||
|
||||
Args:
|
||||
intent: 原始意圖
|
||||
|
||||
Returns:
|
||||
正規化後的意圖
|
||||
"""
|
||||
return LEGACY_INTENT_MAP.get(intent, intent)
|
||||
|
||||
|
||||
# =============================================================================
|
||||
# 風險等級定義
|
||||
# =============================================================================
|
||||
|
||||
|
||||
class RiskLevel(Enum):
|
||||
"""意圖風險等級"""
|
||||
|
||||
LOW = "low" # 只讀操作 (DIAGNOSE)
|
||||
MEDIUM = "medium" # 可逆操作 (RESTART, SCALE, ROLLBACK)
|
||||
HIGH = "high" # 配置變更 (CONFIG)
|
||||
CRITICAL = "critical" # 不可逆操作 (DELETE)
|
||||
|
||||
|
||||
# 意圖對應風險等級
|
||||
INTENT_RISK_MAP: dict[IntentType, RiskLevel] = {
|
||||
IntentType.DIAGNOSE: RiskLevel.LOW,
|
||||
IntentType.RESTART: RiskLevel.MEDIUM,
|
||||
IntentType.SCALE: RiskLevel.MEDIUM,
|
||||
IntentType.ROLLBACK: RiskLevel.MEDIUM,
|
||||
IntentType.CONFIG: RiskLevel.HIGH,
|
||||
IntentType.DELETE: RiskLevel.CRITICAL,
|
||||
IntentType.UNKNOWN: RiskLevel.MEDIUM,
|
||||
# 舊版兼容
|
||||
IntentType.ALERT_TRIAGE: RiskLevel.LOW,
|
||||
IntentType.DEPLOYMENT: RiskLevel.HIGH,
|
||||
IntentType.QUERY: RiskLevel.LOW,
|
||||
IntentType.MAINTENANCE: RiskLevel.MEDIUM,
|
||||
IntentType.CODE_REVIEW: RiskLevel.LOW,
|
||||
}
|
||||
|
||||
|
||||
# =============================================================================
|
||||
# 關鍵字規則引擎 (方案 A, < 10ms)
|
||||
# =============================================================================
|
||||
|
||||
|
||||
# 核心意圖關鍵字映射
|
||||
INTENT_KEYWORDS: dict[IntentType, list[str]] = {
|
||||
IntentType.ALERT_TRIAGE: [
|
||||
"alert", "告警", "警報", "異常", "error", "critical", "warning",
|
||||
"高負載", "high cpu", "memory", "oom", "crash", "down",
|
||||
# 四大核心意圖
|
||||
IntentType.RESTART: [
|
||||
# 英文
|
||||
"restart",
|
||||
"reboot",
|
||||
"recreate",
|
||||
"kill",
|
||||
"delete pod",
|
||||
"rollout restart",
|
||||
# 中文
|
||||
"重啟",
|
||||
"重新啟動",
|
||||
"重建",
|
||||
"刪除 pod",
|
||||
"殺掉",
|
||||
],
|
||||
IntentType.DEPLOYMENT: [
|
||||
"deploy", "部署", "rollout", "kubectl apply", "helm", "release",
|
||||
"版本", "upgrade", "更新", "上線",
|
||||
IntentType.SCALE: [
|
||||
# 英文
|
||||
"scale",
|
||||
"replica",
|
||||
"hpa",
|
||||
"autoscale",
|
||||
"scale up",
|
||||
"scale down",
|
||||
"horizontal pod autoscaler",
|
||||
# 中文
|
||||
"擴容",
|
||||
"縮容",
|
||||
"擴縮",
|
||||
"副本",
|
||||
"水平擴展",
|
||||
],
|
||||
IntentType.QUERY: [
|
||||
"查詢", "狀態", "status", "describe", "get", "list", "日誌", "log",
|
||||
"哪個", "什麼", "how many", "多少",
|
||||
IntentType.CONFIG: [
|
||||
# 英文
|
||||
"configmap",
|
||||
"secret",
|
||||
"env",
|
||||
"environment",
|
||||
"config",
|
||||
"setting",
|
||||
"configuration",
|
||||
"kubectl apply",
|
||||
"helm upgrade",
|
||||
# 中文
|
||||
"配置",
|
||||
"設定",
|
||||
"環境變數",
|
||||
"部署",
|
||||
"更新配置",
|
||||
],
|
||||
IntentType.MAINTENANCE: [
|
||||
"restart", "重啟", "scale", "擴容", "縮容", "rollback", "回滾",
|
||||
"維護", "maintenance", "patch", "修補",
|
||||
IntentType.DIAGNOSE: [
|
||||
# 英文
|
||||
"log",
|
||||
"logs",
|
||||
"describe",
|
||||
"get",
|
||||
"status",
|
||||
"health",
|
||||
"check",
|
||||
"debug",
|
||||
"trace",
|
||||
"diagnose",
|
||||
"rca",
|
||||
"root cause",
|
||||
"investigate",
|
||||
"why",
|
||||
"what happened",
|
||||
# 中文
|
||||
"日誌",
|
||||
"查看",
|
||||
"檢查",
|
||||
"狀態",
|
||||
"健康",
|
||||
"診斷",
|
||||
"原因",
|
||||
"為什麼",
|
||||
"什麼問題",
|
||||
"分析",
|
||||
],
|
||||
IntentType.CODE_REVIEW: [
|
||||
"review", "審查", "pr", "pull request", "commit", "diff",
|
||||
"程式碼", "code", "merge",
|
||||
# 輔助意圖
|
||||
IntentType.DELETE: [
|
||||
# 英文
|
||||
"delete",
|
||||
"remove",
|
||||
"destroy",
|
||||
"kubectl delete",
|
||||
"helm uninstall",
|
||||
"drop",
|
||||
# 中文
|
||||
"刪除",
|
||||
"移除",
|
||||
"銷毀",
|
||||
"清除",
|
||||
],
|
||||
IntentType.ROLLBACK: [
|
||||
# 英文
|
||||
"rollback",
|
||||
"rollout undo",
|
||||
"revert",
|
||||
"previous version",
|
||||
"last version",
|
||||
# 中文
|
||||
"回滾",
|
||||
"回復",
|
||||
"還原",
|
||||
"上一版",
|
||||
"前一版",
|
||||
],
|
||||
}
|
||||
|
||||
# 告警關鍵字 (強化 DIAGNOSE 分類)
|
||||
ALERT_KEYWORDS: list[str] = [
|
||||
"alert",
|
||||
"alerting",
|
||||
"firing",
|
||||
"告警",
|
||||
"警報",
|
||||
"異常",
|
||||
"error",
|
||||
"critical",
|
||||
"warning",
|
||||
"high cpu",
|
||||
"high memory",
|
||||
"oom",
|
||||
"crash",
|
||||
"down",
|
||||
"timeout",
|
||||
"failed",
|
||||
"unhealthy",
|
||||
]
|
||||
|
||||
# 資源類型關鍵字 (用於上下文判斷)
|
||||
RESOURCE_KEYWORDS: dict[str, list[str]] = {
|
||||
"pod": ["pod", "pods", "po"],
|
||||
"deployment": ["deployment", "deployments", "deploy"],
|
||||
"statefulset": ["statefulset", "statefulsets", "sts"],
|
||||
"daemonset": ["daemonset", "daemonsets", "ds"],
|
||||
"service": ["service", "services", "svc"],
|
||||
"configmap": ["configmap", "configmaps", "cm"],
|
||||
"secret": ["secret", "secrets"],
|
||||
"ingress": ["ingress", "ingresses", "ing"],
|
||||
"namespace": ["namespace", "namespaces", "ns"],
|
||||
}
|
||||
|
||||
|
||||
# =============================================================================
|
||||
# 分類結果
|
||||
# =============================================================================
|
||||
|
||||
|
||||
@dataclass
|
||||
class IntentResult:
|
||||
"""意圖分類結果"""
|
||||
|
||||
intent: IntentType # 分類意圖
|
||||
confidence: float # 信心度 (0.0-1.0)
|
||||
method: str # 分類方法 (keyword/llm)
|
||||
risk_level: RiskLevel = field(default=RiskLevel.MEDIUM)
|
||||
matched_keywords: list[str] = field(default_factory=list)
|
||||
detected_resources: list[str] = field(default_factory=list)
|
||||
reasoning: str = ""
|
||||
|
||||
def __post_init__(self):
|
||||
"""初始化後設定風險等級"""
|
||||
self.risk_level = INTENT_RISK_MAP.get(self.intent, RiskLevel.MEDIUM)
|
||||
|
||||
|
||||
# =============================================================================
|
||||
# Protocol 介面 (支援 DI)
|
||||
# =============================================================================
|
||||
|
||||
|
||||
@runtime_checkable
|
||||
class IIntentClassifier(Protocol):
|
||||
"""Intent Classifier Interface for DI"""
|
||||
|
||||
async def classify(self, text: str) -> IntentResult:
|
||||
"""分類意圖 (非同步)"""
|
||||
...
|
||||
|
||||
def classify_sync(self, text: str) -> IntentResult:
|
||||
"""分類意圖 (同步)"""
|
||||
...
|
||||
|
||||
|
||||
# =============================================================================
|
||||
# 實作
|
||||
# =============================================================================
|
||||
|
||||
|
||||
class IntentClassifier:
|
||||
"""
|
||||
意圖分類器
|
||||
K8s 操作意圖分類器
|
||||
|
||||
使用兩階段分類策略:
|
||||
1. 關鍵字快速匹配 (0ms)
|
||||
2. 小模型 LLM 分類 (< 100ms) - 備援
|
||||
1. 方案 A: 規則引擎 (關鍵字匹配, < 10ms)
|
||||
2. 方案 B: 輕量 LLM (qwen2.5:1b, < 100ms) - 備援
|
||||
|
||||
Usage:
|
||||
classifier = get_intent_classifier()
|
||||
result = await classifier.classify("重啟 api-server pod")
|
||||
# IntentResult(intent=RESTART, confidence=0.95, method='keyword')
|
||||
"""
|
||||
|
||||
# 小模型，低延遲
|
||||
MODEL = "qwen2.5:1b"
|
||||
# LLM 備援模型 (從 ModelRegistry 取得)
|
||||
_llm_model: str | None = None
|
||||
|
||||
def __init__(self):
|
||||
self._keyword_cache: dict[str, IntentType] = {}
|
||||
self._keyword_cache: dict[str, IntentResult] = {}
|
||||
self._cache_max_size = 1000 # 最大快取條目
|
||||
|
||||
async def classify(self, text: str) -> IntentType:
|
||||
@property
|
||||
def llm_model(self) -> str:
|
||||
"""取得 LLM 備援模型 (延遲載入)"""
|
||||
if self._llm_model is None:
|
||||
try:
|
||||
registry = get_model_registry()
|
||||
self._llm_model = registry.get_model("ollama", "intent")
|
||||
except Exception:
|
||||
self._llm_model = "qwen2.5:1b" # fallback
|
||||
return self._llm_model
|
||||
|
||||
async def classify(self, text: str) -> IntentResult:
|
||||
"""
|
||||
分類意圖
|
||||
分類意圖 (非同步)
|
||||
|
||||
Args:
|
||||
text: 用戶輸入或告警內容
|
||||
|
||||
Returns:
|
||||
IntentType: 分類結果
|
||||
IntentResult: 分類結果
|
||||
"""
|
||||
text_lower = text.lower()
|
||||
text_lower = text.lower().strip()
|
||||
|
||||
# 階段 1: 關鍵字快速匹配 (0ms)
|
||||
intent = self._keyword_match(text_lower)
|
||||
if intent != IntentType.UNKNOWN:
|
||||
# 階段 1: 規則引擎快速匹配 (< 10ms)
|
||||
result = self._keyword_classify(text_lower)
|
||||
if result.confidence >= 0.7: # 信心度閾值
|
||||
logger.debug(
|
||||
"intent_classified_by_keyword",
|
||||
intent=intent.value,
|
||||
intent=result.intent.value,
|
||||
confidence=result.confidence,
|
||||
matched_keywords=result.matched_keywords,
|
||||
text_preview=text[:50],
|
||||
)
|
||||
return intent
|
||||
return result
|
||||
|
||||
# 階段 2: LLM 分類 (< 100ms)
|
||||
# 目前先用關鍵字，LLM 整合待 Qwen 1B 部署
|
||||
llm_result = await self._llm_classify(text_lower)
|
||||
if llm_result.confidence > result.confidence:
|
||||
logger.debug(
|
||||
"intent_classified_by_llm",
|
||||
intent=llm_result.intent.value,
|
||||
confidence=llm_result.confidence,
|
||||
text_preview=text[:50],
|
||||
)
|
||||
return llm_result
|
||||
|
||||
# 使用規則引擎結果
|
||||
logger.debug(
|
||||
"intent_fallback_to_unknown",
|
||||
"intent_classified_fallback",
|
||||
intent=result.intent.value,
|
||||
confidence=result.confidence,
|
||||
text_preview=text[:50],
|
||||
)
|
||||
return IntentType.UNKNOWN
|
||||
return result
|
||||
|
||||
def _keyword_match(self, text: str) -> IntentType:
|
||||
"""關鍵字匹配"""
|
||||
def classify_sync(self, text: str) -> IntentResult:
|
||||
"""
|
||||
同步版本 (僅關鍵字匹配)
|
||||
|
||||
Args:
|
||||
text: 用戶輸入或告警內容
|
||||
|
||||
Returns:
|
||||
IntentResult: 分類結果
|
||||
"""
|
||||
return self._keyword_classify(text.lower().strip())
|
||||
|
||||
def _keyword_classify(self, text: str) -> IntentResult:
|
||||
"""
|
||||
規則引擎分類 (方案 A)
|
||||
|
||||
目標延遲: < 10ms
|
||||
|
||||
Args:
|
||||
text: 已轉小寫的輸入文字
|
||||
|
||||
Returns:
|
||||
IntentResult: 分類結果
|
||||
"""
|
||||
# 檢查快取
|
||||
cache_key = text[:100]
|
||||
if cache_key in self._keyword_cache:
|
||||
return self._keyword_cache[cache_key]
|
||||
|
||||
# 計算每個意圖的匹配分數
|
||||
scores: dict[IntentType, int] = {}
|
||||
scores: dict[IntentType, tuple[int, list[str]]] = {}
|
||||
|
||||
for intent, keywords in INTENT_KEYWORDS.items():
|
||||
score = 0
|
||||
matched: list[str] = []
|
||||
for keyword in keywords:
|
||||
if keyword in text:
|
||||
score += 1
|
||||
# 完整匹配加分
|
||||
matched.append(keyword)
|
||||
# 完整詞匹配加分
|
||||
if re.search(rf"\b{re.escape(keyword)}\b", text):
|
||||
score += 1
|
||||
if score > 0:
|
||||
scores[intent] = score
|
||||
scores[intent] = (score, matched)
|
||||
|
||||
# 檢測告警內容 (強化 DIAGNOSE)
|
||||
is_alert = any(kw in text for kw in ALERT_KEYWORDS)
|
||||
if is_alert and IntentType.DIAGNOSE not in scores:
|
||||
scores[IntentType.DIAGNOSE] = (1, ["(alert_detected)"])
|
||||
|
||||
# 檢測資源類型
|
||||
detected_resources: list[str] = []
|
||||
for resource_type, keywords in RESOURCE_KEYWORDS.items():
|
||||
if any(kw in text for kw in keywords):
|
||||
detected_resources.append(resource_type)
|
||||
|
||||
# 選擇最高分意圖
|
||||
if not scores:
|
||||
return IntentType.UNKNOWN
|
||||
result = IntentResult(
|
||||
intent=IntentType.UNKNOWN,
|
||||
confidence=0.0,
|
||||
method="keyword",
|
||||
matched_keywords=[],
|
||||
detected_resources=detected_resources,
|
||||
reasoning="無匹配關鍵字",
|
||||
)
|
||||
else:
|
||||
best_intent = max(scores, key=lambda k: scores[k][0])
|
||||
best_score, matched_keywords = scores[best_intent]
|
||||
|
||||
# 選擇最高分
|
||||
best_intent = max(scores, key=lambda k: scores[k])
|
||||
# 計算信心度 (基於匹配數量)
|
||||
max_possible = len(INTENT_KEYWORDS.get(best_intent, [])) * 2
|
||||
confidence = min(1.0, best_score / max(max_possible, 1) + 0.5)
|
||||
|
||||
# 快取結果
|
||||
self._keyword_cache[cache_key] = best_intent
|
||||
# 如果有多個競爭意圖，降低信心度
|
||||
if len(scores) > 1:
|
||||
second_best_score = sorted(
|
||||
[s[0] for s in scores.values()], reverse=True
|
||||
)[1]
|
||||
if second_best_score > best_score * 0.7:
|
||||
confidence *= 0.8
|
||||
|
||||
return best_intent
|
||||
result = IntentResult(
|
||||
intent=best_intent,
|
||||
confidence=round(confidence, 2),
|
||||
method="keyword",
|
||||
matched_keywords=matched_keywords,
|
||||
detected_resources=detected_resources,
|
||||
reasoning=f"匹配關鍵字: {', '.join(matched_keywords)}",
|
||||
)
|
||||
|
||||
def classify_sync(self, text: str) -> IntentType:
|
||||
"""同步版本 (僅關鍵字匹配)"""
|
||||
return self._keyword_match(text.lower())
|
||||
# 快取結果 (LRU 簡易實作)
|
||||
if len(self._keyword_cache) >= self._cache_max_size:
|
||||
# 移除最舊的一半
|
||||
keys = list(self._keyword_cache.keys())
|
||||
for k in keys[: len(keys) // 2]:
|
||||
del self._keyword_cache[k]
|
||||
|
||||
self._keyword_cache[cache_key] = result
|
||||
return result
|
||||
|
||||
async def _llm_classify(self, text: str) -> IntentResult:
|
||||
"""
|
||||
LLM 分類 (方案 B)
|
||||
|
||||
目標延遲: < 100ms (使用 qwen2.5:1b)
|
||||
|
||||
Args:
|
||||
text: 已轉小寫的輸入文字
|
||||
|
||||
Returns:
|
||||
IntentResult: 分類結果
|
||||
|
||||
Note:
|
||||
目前返回 UNKNOWN，待 Ollama qwen2.5:1b 部署後啟用
|
||||
"""
|
||||
# TODO: 整合 Ollama qwen2.5:1b (Phase 13.4)
|
||||
# 預計使用 text 呼叫 Ollama API 進行分類
|
||||
# 目前先返回低信心度 UNKNOWN，規則引擎已能處理大部分情況
|
||||
del text # 預留給 LLM 分類使用，避免 unused-parameter 警告
|
||||
return IntentResult(
|
||||
intent=IntentType.UNKNOWN,
|
||||
confidence=0.3,
|
||||
method="llm",
|
||||
matched_keywords=[],
|
||||
detected_resources=[],
|
||||
reasoning="LLM 分類尚未啟用",
|
||||
)
|
||||
|
||||
def get_supported_intents(self) -> list[dict]:
|
||||
"""
|
||||
取得支援的意圖清單
|
||||
|
||||
Returns:
|
||||
意圖清單 (含描述和風險等級)
|
||||
"""
|
||||
intents = [
|
||||
{
|
||||
"intent": IntentType.RESTART.value,
|
||||
"description": "重啟 Pod/Deployment/StatefulSet",
|
||||
"risk_level": RiskLevel.MEDIUM.value,
|
||||
"keywords_sample": INTENT_KEYWORDS[IntentType.RESTART][:5],
|
||||
},
|
||||
{
|
||||
"intent": IntentType.SCALE.value,
|
||||
"description": "擴縮容、HPA 調整",
|
||||
"risk_level": RiskLevel.MEDIUM.value,
|
||||
"keywords_sample": INTENT_KEYWORDS[IntentType.SCALE][:5],
|
||||
},
|
||||
{
|
||||
"intent": IntentType.CONFIG.value,
|
||||
"description": "ConfigMap/Secret/ENV 變更",
|
||||
"risk_level": RiskLevel.HIGH.value,
|
||||
"keywords_sample": INTENT_KEYWORDS[IntentType.CONFIG][:5],
|
||||
},
|
||||
{
|
||||
"intent": IntentType.DIAGNOSE.value,
|
||||
"description": "日誌查詢、健康檢查、RCA",
|
||||
"risk_level": RiskLevel.LOW.value,
|
||||
"keywords_sample": INTENT_KEYWORDS[IntentType.DIAGNOSE][:5],
|
||||
},
|
||||
{
|
||||
"intent": IntentType.DELETE.value,
|
||||
"description": "刪除資源（高風險）",
|
||||
"risk_level": RiskLevel.CRITICAL.value,
|
||||
"keywords_sample": INTENT_KEYWORDS[IntentType.DELETE][:5],
|
||||
},
|
||||
{
|
||||
"intent": IntentType.ROLLBACK.value,
|
||||
"description": "回滾版本",
|
||||
"risk_level": RiskLevel.MEDIUM.value,
|
||||
"keywords_sample": INTENT_KEYWORDS[IntentType.ROLLBACK][:5],
|
||||
},
|
||||
{
|
||||
"intent": IntentType.UNKNOWN.value,
|
||||
"description": "無法判斷意圖",
|
||||
"risk_level": RiskLevel.MEDIUM.value,
|
||||
"keywords_sample": [],
|
||||
},
|
||||
]
|
||||
return intents
|
||||
|
||||
|
||||
# 單例
|
||||
# =============================================================================
|
||||
# Singleton
|
||||
# =============================================================================
|
||||
|
||||
_classifier: IntentClassifier | None = None
|
||||
|
||||
|
||||
@@ -145,3 +604,29 @@ def get_intent_classifier() -> IntentClassifier:
|
||||
if _classifier is None:
|
||||
_classifier = IntentClassifier()
|
||||
return _classifier
|
||||
|
||||
|
||||
def reset_intent_classifier() -> None:
|
||||
"""重置單例 (用於測試)"""
|
||||
global _classifier
|
||||
_classifier = None
|
||||
|
||||
|
||||
# =============================================================================
|
||||
# Convenience Functions
|
||||
# =============================================================================
|
||||
|
||||
|
||||
async def classify_intent(text: str) -> IntentResult:
|
||||
"""便捷函數: 分類意圖 (非同步)"""
|
||||
return await get_intent_classifier().classify(text)
|
||||
|
||||
|
||||
def classify_intent_sync(text: str) -> IntentResult:
|
||||
"""便捷函數: 分類意圖 (同步)"""
|
||||
return get_intent_classifier().classify_sync(text)
|
||||
|
||||
|
||||
def get_intent_risk(intent: IntentType) -> RiskLevel:
|
||||
"""便捷函數: 取得意圖風險等級"""
|
||||
return INTENT_RISK_MAP.get(intent, RiskLevel.MEDIUM)
|
||||
|
||||
Reference in New Issue
Block a user