Skip to content

fix(ai): flash 모델 기본값을 게이트웨이에 실재하는 gemini-3.5-flash-lite 로 - #229

Merged
i3months merged 1 commit into
devfrom
fix/flash-model-default
Aug 30, 2026
Merged

fix(ai): flash 모델 기본값을 게이트웨이에 실재하는 gemini-3.5-flash-lite 로#229
i3months merged 1 commit into
devfrom
fix/flash-model-default

Conversation

@i3months

Copy link
Copy Markdown
Member

변경 사항

LLM_FLASH_MODEL 기본값을 gemini-3.1-flash-litegemini-3.5-flash-lite 로 교체.

배경

gemini-3.1-flash-lite 는 Mindlogic 게이트웨이 카탈로그에 없는 모델이다(게이트웨이 직접 호출 시 404 "Model 'gemini-3.1-flash-lite' not found"). 이 때문에 Flash 를 쓰는 경로가 프로덕션에서 매번 실패했다:

  • 약점 추적형 꼬리질문 → "질문 생성에 실패했습니다"
  • 4축 실시간 채점(구체성·논리·구조·정합성) → 전부 null
  • 답변별 코칭(모범답안·리라이트·한줄코칭) → 공란
  • 피드백 패널의 Flash 평가위원(첫인상·인성) → 누락

Pro(gemini-3.1-pro-preview)는 카탈로그에 존재해 질문 풀·피드백 패널은 정상이었다.

조치

게이트웨이가 실제 서빙하는 flash-lite 티어(gemini-3.5-flash-lite)로 기본값 교체. 저지연·저비용 의도 유지. 게이트웨이 직접 호출 + 실제 면접 사이클로 꼬리질문·4축채점·코칭·패널(4명) 복구를 확인했다.

  • settings.py / .env.example / ai/.env.example / docker-compose.yml fallback
  • 문서(environment.md, ai/CLAUDE.md, observability.md·api-conventions.md 예시)의 존재하지 않는 모델명(gemini-3.1-flash·flash-lite) 정리

배포 노트

프로덕션 .env 는 이미 별도로 교체·검증했다. 배포(deploy-app.yml)가 rsync --exclude='.env' 로 prod .env 를 보존하므로, 이 PR 은 신규/초기화 배포 시 회귀를 막는 목적이다.

`gemini-3.1-flash-lite` 는 Mindlogic 게이트웨이 카탈로그에 없어(직접 호출 시
404 "Model not found") Flash 를 쓰는 모든 경로 — 약점추적 꼬리질문, 4축 실시간
채점, 답변별 코칭, 첫인상·인성 평가위원 — 이 프로덕션에서 매번 실패했다. Pro
(`gemini-3.1-pro-preview`)는 카탈로그에 있어 질문 풀·피드백 패널은 정상이었다.

게이트웨이가 실제 서빙하는 flash-lite 티어(`gemini-3.5-flash-lite`)로 기본값을
교체. 저지연·저비용 의도 유지. prod `.env` 는 별도로 이미 교체·검증했고, 배포가
`.env` 를 보존하므로 이 커밋은 신규/초기화 배포의 회귀를 막는 목적.

- settings.py / .env.example / ai/.env.example / docker-compose.yml fallback
- 문서(environment.md, ai/CLAUDE.md, observability.md 예시, api-conventions.md 예시)의
  없는 모델명(gemini-3.1-flash·flash-lite) 정리
@i3months
i3months merged commit 8607ddd into dev Aug 30, 2026
5 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant