# AI Model Upgrade & Feature Tooltips

## 1. 개요
*   **작성일**: 2026-02-18
*   **요청자**: User
*   **상태**: 완료

## 2. 요구사항 목록 (Todo)
- [x] **[버그]** AI 설정 API Key 길이 검증 오류 수정 (34 -> 32 bytes)
- [x] **[버그]** Gemini API 429/404 에러 해결 (모델 변경)
- [x] **[개선]** AI 모델 최신화 (Gemini 2.5 Flash 도입)
- [x] **[UI]** AI 기능 버튼 Tooltip 추가 (사용자 가이드 강화)

## 3. 상세 분석 및 해결

### 3.1. API Key 길이 검증 오류
*   **현상**: `AI_ENCRYPTION_KEY`가 32바이트여야 하는데, 기본값이 34자로 설정되어 빌드 오류 발생.
*   **해결**: `utils/encryption.ts`에서 기본값 수정 및 명시적 길이 검증 로직 추가.

### 3.2. Gemini API 오류 (429 -> 404)
*   **현상**: `gemini-1.5-pro` 사용 시 Quota Exceeded (429) 및 Not Found (404) 발생.
*   **원인**: `gemini-1.5` 시리즈의 무료 티어 제한 및 모델 Deprecation (2026년 기준).
*   **해결**: 최신 표준인 `gemini-2.5-flash`로 모델 업그레이드. 속도와 안정성 확보.

### 3.3. AI Feature Tooltips
*   **요구사항**: 6가지 AI 기능(요약, 구조화, 정보추출 등)에 대한 설명이 필요함.
*   **구현**: `ActionTooltip` 컴포넌트 생성 (Hover 시 설명 팝업).
*   **적용**: `AISidepanel`의 버튼에 적용하여 사용자 이해도 증진.

## 4. 결과
*   AI 기능 정상 작동 확인 (모델 응답 속도 개선)
*   UI 직관성 향상