---
task_id: task-2100
type: plan
scope: task
created: 2026-04-22
updated: 2026-04-22
status: completed
---

# 계획서: task-2100

**task**: task-2100
**목표**: AI 주제 추천 API 실패 수정 (Gemini 비스트리밍 엔드포인트 + 파싱 개선)
**승인**: 자체 (Lv.critical)
**근거**: task-2074에서 버튼 활성화했으나 실제 AI 호출 실패

---

## 목표

AI 마케팅 → AI 콘텐츠 작성 → "AI 주제 추천" 버튼 클릭 시 6개 주제 목록이 정상 표시되도록 수정

## 범위

### 포함
1. `_shared/ai-provider.ts` — callGemini 비스트리밍 시 `generateContent` 엔드포인트 사용
2. `suggest-topics/index.ts` — 시스템 프롬프트 개선 (tool declaration 없는데 함수 사용 지시 제거), JSON 응답 유도
3. `src/pages/Generate.tsx` — 빈 결과/실패 시 UI 개선 (aiTopicsRequested 롤백)

### 제외 (다음 페이즈 이후)
- JWT 인증/플랜 검증 서버측 강제 (별도 보안 작업)
- 토큰 차감 로직 연동

## 위임 계획

- ai-provider.ts 수정: **루(Lugh, 백엔드)** — Gemini API 엔드포인트 분기 로직
- suggest-topics 프롬프트 개선: **루(Lugh, 백엔드)** — Edge Function 수정
- Generate.tsx UI 개선: **브리짓(Brigid, 프론트엔드)** — 빈 결과/실패 UI 처리

## 검증 기준

- AI 주제 추천 클릭 → 6개 주제 목록 반환: `npm run build` 성공
- Edge Function 로컬 테스트 또는 배포 후 curl 테스트