제미니(Gemini) 3.5 Flash 출시! 새로운 API와 성능 개선 확인하세요.
제미니(Gemini) 3.5 Flash 모델이 정식 출시되어 에이전트 실행, 코딩, 장기 작업에서 향상된 성능(Improved Performance)을 제공
Interactions API를 새로운 표준으로 권장하며, 에이전트 워크플로우, 서버 측 상태 관리, 멀티모달 대화에 최적화(Optimized)
Thinking Level 기본값이 'medium'으로 변경되었으며, 불필요한 도구 호출을 줄이기 위한 최적화 가이드(Optimization Guide) 제공
기존 Gemini 3 Flash Preview 및 Gemini 2.5에서 마이그레이션(Migration)을 위한 상세 가이드라인과 권장 사항 제시
Interactions API vs GenerateContent API
본문에 따르면 제미니(Gemini) 3.5 Flash는 Interactions API를 새로운 표준으로 권장하며, 에이전트 워크플로우(Agentic Workflows), 서버 측 상태 관리(Server-side State Management), 복잡한 멀티모달(Multi-modal) 대화에 최적화되었다.
Interactions API: 자동적인 사고 보존(Thought Preservation) 기능 제공
GenerateContent API: 이전 대화 내역을 포함하여 향상된 성능(Improved Performance)을 위해 전체 대화 내역을 전달해야 함
두 API 모두 동일한 설정 옵션과 권장 사항을 따르며, 개발자는 프로젝트의 요구 사항에 따라 적합한 API를 선택할 수 있다.
Thinking Level 설정 및 활용
제미니(Gemini) 3.5 Flash는 기본적으로 'medium' Thinking Level을 사용하며, 대부분의 작업에서 최상의 품질을 제공한다.
minimal: 빠른 응답 속도(Response Speed)가 필요한 간단한 쿼리(Simple Queries)에 적합
low: 적은 단계(Fewer Steps)가 필요한 코드 및 에이전트 작업에 적합
medium: 대부분의 작업에 최적의 품질(Best Quality) 제공
high: 복잡한 추론, 어려운 수학 문제, 어려운 코딩 작업에 적합
개발자는 generation_config를 통해 Thinking Level을 설정하여 모델의 성능을 미세 조정할 수 있다.
샘플링 파라미터(Sampling Parameters) 사용 지양
제미니(Gemini) 3.x 모델에서는 temperature, top_p, top_k와 같은 샘플링 파라미터(Sampling Parameters) 사용을 더 이상 권장하지 않는다.
기본 설정(Default Settings) 최적화: 제미니(Gemini) 3의 추론 능력은 기본 설정에 최적화되어 있다.
결정론(Determinism) 확보: 특정 사용 사례에 대한 명시적인 규칙을 가진 시스템 지침(System Instruction)을 정의하는 것이 권장된다.
thinking_budget 대체: raw numeric thinking_budget 파라미터 대신 thinking_level 문자열 열거형(String Enum)을 사용해야 한다.
함수 호출(Function Calling) 시 주의사항
제미니(Gemini) 3.5 Flash에서 함수 호출(Function Calling) 시 엄격한 응답 일치(Strict Response Matching)를 준수해야 한다.
id 일치: 각 FunctionResponse는 해당 FunctionCall의 id를 포함해야 함
name 일치: 응답의 이름은 호출의 이름과 일치해야 함
count 일치: 받은 각 FunctionCall에 대해 정확히 하나의 FunctionResponse를 반환해야 함
멀티모달 응답(Multimodal Responses): 멀티모달 콘텐츠는 FunctionResponse 내부에 포함해야 하며, 예상치 못한 동작(Unexpected Behavior)을 방지할 수 있다.
이러한 규칙을 준수하여 모델의 정확성과 효율성을 높일 수 있다.
마이그레이션(Migration) 가이드라인
제미니(Gemini) 3.5 Flash로의 마이그레이션을 위해 다양한 사항을 고려해야 한다.
Gemini 3 Flash Preview에서 마이그레이션: 모델 이름 변경(gemini-3-flash-preview → gemini-3.5-flash), 가격 검토, temperature, top_p, top_k 제거, thinking_budget를 thinking_level로 대체
Gemini 2.5에서 마이그레이션: 위 사항 외에도 프롬프트 단순화, PDF 및 미디어 워크로드 테스트, 결합된 도구 사용 등
자동화된 마이그레이션: 코딩 에이전트(Coding Agent)를 사용하여 마이그레이션을 자동화하는 것을 권장한다.
