llm-gemini 0.33: Gemini 3.7 Flash 지원보다 중요한 변화
llm-gemini는 LLM CLI에서 Google의 Gemini 모델을 사용할 수 있게 해주는 플러그인이다. 0.33은 Gemini 3.7 Flash, gemini-3.6-flash, gemini-3.5-flash-lite를 새로 지원한다. 그러나 이번 릴리스의 실질적인 가치는 모델 추가보다 추론과 도구 사용을 구조적으로 처리하고, 임베딩 전환 기준을 명확히 한 데 있다.1
에이전트 실행 과정을 구조적으로 처리한다
llm-gemini 0.33은 LLM 0.32의 메시지·스트리밍 API에 맞춰 개편됐으며, LLM 0.32 이상이 필요하다. 추론 과정과 도구 호출, 도구 결과는 각각 유형이 지정된 스트림 이벤트로 출력된다.1 애플리케이션은 일반 답변과 도구 실행 내역을 문자열 분석 없이 구분해 처리할 수 있다.
여러 단계의 도구 호출에서도 맥락 유지가 개선됐다. Gemini의 사고 서명이 도구 사용 턴 사이에서 보존되고 재생되며, 상태 비저장 messages= 대화 기록도 올바르게 재생되도록 수정됐다.1 검색이나 계산, 함수 호출을 연속으로 수행하는 워크플로에서 이전 추론 흐름을 더 안정적으로 이어 갈 수 있다는 의미다.
Google Search, URLContext, CodeExecution은 LLM의 서버 측 도구 인터페이스를 통해 실행할 수 있다. Gemini 3 계열에서는 이러한 서버 측 도구와 로컬 함수를 함께 사용하는 워크플로도 구성할 수 있다.1
모델 설정을 옮길 때는 사고 노력 옵션도 확인해야 한다. Gemini 3.7 Flash에서는 3.6 Flash에 있던 minimal 옵션이 제거됐으므로, 기존 설정을 그대로 재사용하기보다 지원되는 옵션인지 먼저 점검해야 한다.1
임베딩 전환은 전체 데이터 마이그레이션이다
0.33은 gemini-embedding-2와 텍스트 전용 gemini-embedding-001을 지원한다. 두 모델의 기본 출력은 3,072차원이며, 768차원과 1,536차원으로 축소한 변형도 제공한다.12 반면 지원이 중단된 text-embedding-004와 gemini-embedding-exp-03-07은 제거됐다.1
가장 중요한 제약은 gemini-embedding-001과 gemini-embedding-2가 서로 호환되지 않는 벡터 공간을 사용한다는 점이다.1 한 모델로 만든 기존 컬렉션을 다른 모델로 전환하려면 전체 콘텐츠를 다시 임베딩해야 한다.2
따라서 운영 환경에서는 모델 ID만 바꾸면 안 된다. 다음 항목을 포함한 별도 마이그레이션으로 다루는 편이 안전하다.
전체 콘텐츠 재임베딩에 필요한 시간
선택한 벡터 차원에 따른 저장 용량
전환 전후의 검색 품질 검증
새 인덱스로 교체하는 시점과 복구 계획
오류 원인과 모델 품질을 구분해야 한다
2026년 8월 14일 업데이트에서는 SVG 렌더링 오류의 원인이 Gemini가 아니라 렌더링 도구의 버그였다고 정정됐다.1 모델 출력과 최종 화면 사이에 별도 도구가 개입하는 환경에서는 결과 이상을 곧바로 모델 문제로 판단하지 말고, 렌더러와 후처리 단계까지 함께 확인해야 한다.
요약
llm-gemini 0.33은 Gemini 3.7 Flash 지원판인 동시에 추론, 도구 호출, 실행 결과를 구조적으로 다룰 수 있게 한 기반 업데이트다. 업그레이드 전에는 LLM 0.32 이상인지 확인하고, 스트림 이벤트 처리와 사고 노력 옵션을 점검해야 한다. 임베딩 모델을 바꾼다면 전체 재임베딩이 필요한 데이터 마이그레이션으로 계획해야 한다.
1Release 0.33 · simonw/llm-gemini · GitHub
2GitHub - simonw/llm-gemini: LLM plugin to access Google's Gemini family of models
이 노트는 보도·비평·교육·연구 목적으로 작성되었습니다. 저작권 문의가 있으시면 에서 알려주세요.