# 의도 런타임 하이브리드 설계

**날짜**: 2025-10-23 (251017 통합)
**목표**: FastPath + 임베딩 Top-K + LLM 재분석 + Beta(α,β) 동적 임계치 하이브리드
**상태**: 전체 완료 (260203 archive 이동)

---

## Phase 1: 3단계 아키텍처 (✅ 완료)

→ 상세: `troubleshooting/251126_happybell80_rb8001_의도_3단계_아키텍처_도입_및_배포.md`

---

## Phase 2: 하이브리드 파이프라인 (✅ 완료)

→ 상세: `troubleshooting/251126_intent_3step_db_bayesian_integration.md`

---

## Phase 3: 베이지안 동적 학습 (✅ 완료)

→ 완료: `intent_path_stats`, `decision_logs`, ActionPlanner 경로별 성공률 조회  
→ 2번 DB 접근·1번 Thompson·4번 Thompson 테스트: `troubleshooting/260203_intent_phase3_db_thompson_tests.md`

### 완료 (260203)

- **3번 LLM 호출 최적화**: `troubleshooting/260203_intent_llm_call_optimization.md` (경로별 호출 수·할당량 참고)
- **5번 의도 분류 프롬프트 313**: `troubleshooting/260203_intent_prompt_313_alignment.md` (형식·퓨샷·구조화)
- **6번 LangGraph 검토**: 의도 분류는 이미 LangGraph 워크플로우(`intent_langgraph_workflow`)로 전환됨. `INTENT_USE_LANGGRAPH=true` 시 사용, `_detect_traditional`은 폴백.

### 관련 코드 위치 (rb8001)

| 역할 | 경로 |
|------|------|
| 분기·임계치·Thompson τ | `app/services/brain/intent_graph.py` (`INTENT_USE_DYNAMIC_TAU` 시 `get_thompson_thresholds`) |
| 경로별 α,β·Thompson τ 계산 | `app/services/brain/intent_store.py` (`load_path_stats_params`, `get_thompson_thresholds`) |
| ActionPlanner | `app/services/brain/intent/action_planner.py` (intent_store만 사용, psycopg2 없음) |
| Beta 갱신·decision 로깅 | `app/state/intent_runtime_repository.py` |

---

## 참고

- `troubleshooting/251126_happybell80_rb8001_의도_3단계_아키텍처_도입_및_배포.md`
- `troubleshooting/251126_intent_3step_db_bayesian_integration.md`
- `troubleshooting/260203_intent_phase3_db_thompson_tests.md` (Phase 3 DB 접근·Thompson·테스트)
- `plans/archive/251017_intent_analysis_improvement_plan.md` (251023으로 통합됨)
- `book/300_architecture/311_backend_coding_principles.md`
- `book/300_architecture/313_Gemini_프롬프트_설계_원칙.md`
- `book/300_architecture/315_테스트_작성_원칙.md`
