Gemini 3.2 API に切り替えたら動かなくなった — 私が実際にぶつかったエラーパターンと対処法

import google.generativeai as genai
 
# ❌ 動かないパターン
model = genai.GenerativeModel("gemini-3-2-pro")       # ハイフン区切りは3.2では変更あり
model = genai.GenerativeModel("gemini/3.2-pro")       # スラッシュ記法は無効
model = genai.GenerativeModel("gemini-3.2-pro-latest") # "latest" サフィックスは不定期更新
 
# ✅ 正しいパターン
model = genai.GenerativeModel("gemini-3.2-pro")        # ドット区切りが正式
model = genai.GenerativeModel("gemini-3.2-flash")      # 軽量版はこちら

import google.generativeai as genai
 
genai.configure(api_key="YOUR_GEMINI_API_KEY")
 
for m in genai.list_models():
    if "gemini-3.2" in m.name:
        print(m.name, "—", m.supported_generation_methods)

# ❌ 問題のあるパターン — 会話履歴が無制限に蓄積する
conversation_history = []
 
def chat(user_input):
    conversation_history.append({"role": "user", "parts": [user_input]})
    response = model.generate_content(conversation_history)
    conversation_history.append({"role": "model", "parts": [response.text]})
    return response.text

# ✅ 修正版 — トークン数を監視してローリングサマリーを挿入する
MAX_TOKENS = 1_500_000  # 2Mの75%を上限に設定
 
def chat_with_limit(user_input, history):
    history.append({"role": "user", "parts": [user_input]})
 
    # トークン数チェック
    token_count = model.count_tokens(history).total_tokens
    if token_count > MAX_TOKENS:
        # 古い会話を要約して圧縮
        summary = summarize_history(history[:-10])  # 最新10件は保持
        history = [{"role": "user", "parts": [f"[これまでの会話要約]: {summary}"]}] + history[-10:]
 
    response = model.generate_content(history)
    history.append({"role": "model", "parts": [response.text]})
    return response.text, history

# ❌ 問題のある書き方 — 空チャンクでエラーになる
for chunk in model.generate_content(prompt, stream=True):
    print(chunk.text)  # ValueError: Response has no candidates (or all finished)
 
# ✅ 修正版 — 空チャンクをスキップする
for chunk in model.generate_content(prompt, stream=True):
    if chunk.candidates and chunk.candidates[0].content.parts:
        for part in chunk.candidates[0].content.parts:
            if hasattr(part, 'text') and part.text:
                print(part.text, end='', flush=True)

from google.generativeai.types import GenerationConfig
 
# Thinking を無効にする（レイテンシ重視の場合）
config = GenerationConfig(
    thinking_config={"thinking_budget": 0}
)
response = model.generate_content(prompt, generation_config=config)
 
# Thinking を有効にして予算を指定（精度重視の場合）
config_thinking = GenerationConfig(
    thinking_config={"thinking_budget": 10000}  # トークン数で指定
)

import time
import random
from google.api_core import exceptions
 
def generate_with_retry(model, prompt, max_retries=3):
    """指数バックオフ + ジッターでレート制限に対応する"""
    for attempt in range(max_retries):
        try:
            return model.generate_content(prompt)
        except exceptions.ResourceExhausted as e:
            if attempt == max_retries - 1:
                raise
            # 指数バックオフ: 1秒 → 2秒 → 4秒 + ランダムジッター
            wait = (2 ** attempt) + random.uniform(0, 1)
            print(f"レート制限 — {wait:.1f}秒後にリトライ（試行 {attempt + 1}/{max_retries}）")
            time.sleep(wait)
        except exceptions.ServiceUnavailable:
            if attempt == max_retries - 1:
                raise
            time.sleep(5 + random.uniform(0, 2))

# ❌ Gemini 3.1 以前で動いていたスキーマ（3.2 では失敗する場合がある）
tools_old = [
    {
        "function_declarations": [{
            "name": "get_weather",
            "description": "指定した都市の天気を取得",
            "parameters": {
                "type": "object",
                "properties": {
                    "city": {"type": "string"},
                    "unit": {"type": "string", "optional": True}  # ← NG: "optional" キーは非推奨
                },
                "required": ["city"]
            }
        }]
    }
]
 
# ✅ Gemini 3.2 に対応した書き方
tools_new = [
    {
        "function_declarations": [{
            "name": "get_weather",
            "description": "指定した都市の天気を取得します。unit を省略した場合は摂氏で返します。",
            "parameters": {
                "type": "object",
                "properties": {
                    "city": {
                        "type": "string",
                        "description": "都市名（例: Tokyo, Osaka）"
                    },
                    "unit": {
                        "type": "string",
                        "enum": ["celsius", "fahrenheit"],
                        "description": "温度単位。省略時は celsius を使用"
                        # "optional" キーは使わず、"required" リストから外す
                    }
                },
                "required": ["city"]  # unit は required に含めない = 省略可能
            }
        }]
    }
]

# デバッグ用: 最小構成でスキーマを検証する
def validate_schema(model, tool_schema):
    try:
        response = model.generate_content(
            "テスト: 東京の天気を教えて",
            tools=tool_schema
        )
        print("✅ スキーマ検証OK")
        return True
    except Exception as e:
        print(f"❌ スキーマエラー: {e}")
        return False