Gemini API の System Instructions が効かない・無視される — よくある原因と解決法

import google.generativeai as genai
 
genai.configure(api_key="YOUR_API_KEY")
 
# ❌ NG: system_instruction を user メッセージとして送っている
model = genai.GenerativeModel("gemini-2.5-pro")
response = model.generate_content([
    {"role": "user", "parts": ["あなたは関西弁で話すアシスタントです。"]},
    {"role": "model", "parts": ["はい、了解です！"]},
    {"role": "user", "parts": ["今日の天気を教えてください。"]},
])
print(response.text)
# → 関西弁にならないことが多い

# ✅ OK: system_instruction パラメーターとして渡す
model = genai.GenerativeModel(
    model_name="gemini-2.5-pro",
    system_instruction="あなたは関西弁で話す親しみやすいアシスタントです。どんな質問にも関西弁で丁寧に答えてください。"
)
 
response = model.generate_content("今日の天気を教えてください。")
print(response.text)
# → 「そうやなぁ、今日の天気は...」のように関西弁で返ってくる

{
  "systemInstruction": {
    "parts": [{"text": "あなたは関西弁で話す親しみやすいアシスタントです。"}]
  },
  "contents": [
    {"role": "user", "parts": [{"text": "今日の天気を教えてください。"}]}
  ]
}

# ❌ NG: history に System Instructions を混在させている
chat = model.start_chat(history=[
    {"role": "user", "parts": ["あなたは300文字以内で簡潔に答えるアシスタントです。"]},
    {"role": "model", "parts": ["了解しました。"]},
])
 
response = chat.send_message("機械学習とは何ですか？")
# → 最初は短い回答が返ることもあるが、数ターン後には長くなってくる

# ✅ OK: モデル初期化時に system_instruction を設定し、history はクリーンに保つ
model = genai.GenerativeModel(
    model_name="gemini-2.5-pro",
    system_instruction="必ず300文字以内で簡潔に答えてください。長い説明が必要な場合も、要点を絞って短くまとめること。"
)
 
chat = model.start_chat()  # history は空でOK
response = chat.send_message("機械学習とは何ですか？")
print(response.text)
# → 何ターン続けても300文字以内で回答が返ってくる

# ❌ 問題になりやすい: 指示が多すぎる・矛盾する指示が混在している
problematic_instruction = """
あなたは優秀なカスタマーサポートアシスタントです。
以下のルールをすべて守ってください:
1. 常に敬語で話すこと
2. 絵文字を積極的に使うこと
3. 回答は50文字以内にすること
4. 詳しい説明を常に提供すること  ← ルール3と矛盾している
5. 競合他社への言及は避けること
6. 必ず「ご質問ありがとうございます」から始めること  ← 毎回だと不自然
... （さらに20項目続く）
"""

# ✅ 効果的な System Instructions の書き方
effective_instruction = """
あなたはECサイトのカスタマーサポートアシスタントです。
 
【最重要ルール】
- 回答は200文字以内で簡潔に
- 敬語を使用（絵文字は質問者が使った場合のみ）
 
【対応範囲】
注文・配送・返品に関する質問に答える。技術的な問題はエンジニアチームへ案内する。
 
【禁止事項】
価格交渉・競合比較への応答は控える。
"""

import google.generativeai as genai
 
genai.configure(api_key="YOUR_API_KEY")
 
model = genai.GenerativeModel(
    model_name="gemini-2.5-pro",
    system_instruction="回答は必ず箇条書きで提供してください。"
)
 
# Thinking モードを有効化した場合
response = model.generate_content(
    "量子コンピュータの仕組みを教えてください",
    generation_config=genai.GenerationConfig(
        thinking_config={"thinking_budget": 10000}  # 思考予算を多く取る
    )
)
print(response.text)
# → 箇条書きではなく、流れる文章で回答が返ることがある

# ✅ Thinking モードでも効きやすい System Instructions
model = genai.GenerativeModel(
    model_name="gemini-2.5-pro",
    system_instruction="""
回答フォーマットは絶対に以下を守ること。例外は認めない:
- すべての回答を箇条書き（- で始まるリスト形式）で提供する
- 箇条書き以外の文章形式で回答することは禁止
- 各項目は1〜2文で簡潔にまとめること
"""
)

response = model.generate_content("...")
print(response.candidates[0].finish_reason)
# SAFETY → セーフティフィルターが原因
# STOP   → 正常終了（別の原因を調べる）