๐ ์ฃผ์ ๋ณ๊ฒฝ ์ฌํญ (Key Changes)
1. ์ฐจ์ธ๋ AI ๋ชจ๋ธ ๋ง์ด๊ทธ๋ ์ด์ (Gemini 3.1)
- Model Update: Google์ Gemini 2.0 ๋ชจ๋ธ ์๋น์ค ์ข ๋ฃ ์๊ณ (2026.06.01)์ ๋ฐ๋ผ, ์ต์ ์์ง์ธ Gemini 3.1 Flash-Lite-preview๋ก ์ ์ ์ ๋ง์ด๊ทธ๋ ์ด์ ์ ์๋ฃํ์ต๋๋ค.
- ์ฑ๋ฅ ๋ฐ ๋น์ฉ ์ต์ ํ: ์ฐจ์ธ๋ Flash-Lite ๋ชจ๋ธ ๋์ ์ ํตํด ๋ ์ ๊ตํ ํ๋ก ํด์ ๋ก์ง์ ๊ตฌํํ๊ณ , ์ ๋ฃ ํฐ์ด์ ์์ ์ ์ธ API ํ ๋น๋์ ํ๋ณดํ์ต๋๋ค.
2. AI SDK ๋ฐ ์ํคํ ์ฒ ๋ฆฌํฉํ ๋ง
- SDK ๊ต์ฒด: ๊ธฐ์กด ๋ผ์ด๋ธ๋ฌ๋ฆฌ๋ฅผ ์ฐจ์ธ๋ ๋ผ์ด๋ธ๋ฌ๋ฆฌ์ธ
@google/genai๋ก ์ ๋ฉด ๊ต์ฒดํ์ฌ ์ต์ ๋ชจ๋ธ์ ๊ธฐ๋ฅ์ 100% ํ์ฉํ ์ ์๋๋ก ๊ฐ์ ํ์ต๋๋ค. - ์์กด์ฑ ๊ด๋ฆฌ ์ต์ ํ: ๋ฃจํธ ๋๋ ํ ๋ฆฌ์ ๋ฐฑ์๋ ๋๋ ํ ๋ฆฌ ๊ฐ์ ํจํค์ง ์ค์น ํผ์ ์ ์ ๋ฆฌํ๊ณ ,
backend/package.json์ ๊ธฐ์ค์ผ๋ก ํ ๋ ๋ฆฝ์ ์ธ ๋น๋ ํ๊ฒฝ์ ๊ตฌ์ถํ์ต๋๋ค.
3. ์๋ฒ ์์ ์ฑ ๋ฐ ์์ธ ์ฒ๋ฆฌ ๊ฐํ
- ๋ชจ๋ธ ๋ช ์นญ ๋๊ธฐํ: API ์๋ฒ์ ๋ชจ๋ธ ์๋ณ์(preview ๋ช ์นญ ๊ถ์ฅ์ฌํญ)๋ฅผ ์ ํํ ๋ฐ์ํ์ฌ ๋ฐฐํฌ ์ ๋ฐ์ํ๋ 404 ์๋ฌ๋ฅผ ํด๊ฒฐํ์ต๋๋ค.
- ์ฐ์์ ์๋ฌ ๋ฐฉ์ง: AI ์๋ต ์คํจ ์ ๋ฐ์ํ๋ ๋ฐ์ดํฐ๋ฒ ์ด์ค(Prisma) ์ฐ๊ฒฐ ์ง์ฐ ๋ฌธ์ ๋ฅผ ๋ก์ง ๊ฐ์ ์ ํตํด ํด๊ฒฐํ์ฌ ์๋น์ค ๊ฐ์ฉ์ฑ์ ๋์์ต๋๋ค.
๐ก ๊ฐ๋ฐ ๋ ธํธ (Developer's Note)
์ด๋ฒ ์ ๋ฐ์ดํธ๋ ๋จ์ํ ๋ชจ๋ธ ๊ต์ฒด๋ฅผ ๋์ด, ํด๋ผ์ฐ๋ ๋ฐฐํฌ ํ๊ฒฝ์์์ **์์กด์ฑ ๊ด๋ฆฌ(Dependency Isolation)**์ API ์๋ช ์ฃผ๊ธฐ ๊ด๋ฆฌ์ ์ค์์ฑ์ ์ฒด๊ฐํ ๊ณผ์ ์ด์์ต๋๋ค.
- ์ ์ ์ ๊ธฐ์ ๋ถ์ฑ ํด๊ฒฐ: 2026๋ 6์๋ก ์์ ๋ ๊ตฌํ ๋ชจ๋ธ ์ข ๋ฃ ์์ ๋ณด๋ค ์์ ์ฐจ์ธ๋ ์์ง์ผ๋ก ์ ํํจ์ผ๋ก์จ ์๋น์ค์ ์์์ฑ์ ํ๋ณดํ์ต๋๋ค.
- ์ ๊ตํ ๋๋ฒ๊น : ๋ก์ปฌ ํ๊ฒฝ๊ณผ ๋ฐฐํฌ ํ๊ฒฝ(Render) ๊ฐ์ ๋๋ ํ ๋ฆฌ ๊ตฌ์กฐ ์ฐจ์ด๋ก ์ธํ ๋น๋ ์ค๋ฅ๋ฅผ ์ง์ ์ถ์ ํ๊ณ ํด๊ฒฐํ๋ฉฐ, ํ๊ฒฝ ๊ตฌ์ฑ์ ๋ํ ์ดํด๋๋ฅผ ๋์์ต๋๋ค.
- ์ฌ์ฉ์ ๊ฒฝํ ๊ณ ๋ํ: ๋ ๋๋ํด์ง Gemini 3.1 ๋ชจ๋ธ์ ํตํด ์ฌ์ฉ์๋ค์๊ฒ ํ์ธต ๋ ์ ๋น๋กญ๊ณ ๊น์ด ์๋ ํ๋ก ์๋ด ๊ฒฝํ์ ์ ๊ณตํ ์ ์๊ฒ ๋์์ต๋๋ค.