Gemini Function Calling のスキーマが INVALID_ARGUMENT で弾かれる原因と直し方
Gemini API の Function Calling でスキーマが拒否される原因を、INVALID_ARGUMENT エラーの実例ごとに整理しました。OpenAI から移植したコードで詰まっている方に役立つ修正パターン集です。
Gemini API の system_instruction が無視される7つの原因 — モデル/SDK/フォーマット別チェックリスト
「絶対に英語で答えて」と書いた system_instruction を Gemini API が華麗にスルー — このトラブルの正体は仕様ではなく、ほとんどが渡し方のズレです。SDK・モデル・チャット履歴の観点から原因別に切り分け、再現性のある対処コードまで一気に解説します。
Gemini APIのプロンプトバージョン管理とA/Bテスト実装 — 本番で品質劣化を数値で捕まえる仕組み
Gemini APIを本番で動かすと、プロンプトの微修正が応答品質にどう効いたか数値で説明できない壁にぶつかります。Firestoreとハッシュベースのトラフィック分割、LLM-as-judgeによる回帰検知までを動くコードで組み立てる手順をまとめました。
Gemini API のモデルIDを正しく選ぶ — stable / latest / preview / experimental の違いと落とし穴
Gemini API で頻繁に検索される model=gemini-2.5-pro-latest 等のエイリアスの意味と、stable / latest / preview / experimental の違い、本番環境での選び方を実装例とともに整理します。
Gemini API × sqlite-vec で作る超軽量 RAG — 個人開発向けの本番設計と運用パターン
個人開発で RAG を動かしたいけれど、Pinecone の月額や Qdrant のメモリ要件で手が止まっている方向けの実装ガイドです。Gemini の埋め込み API と sqlite-vec を組み合わせて、サーバー1台で動く検索可能なノート基盤を本番品質で組み上げるまでを、コード付きで解説します。
Gemini API の会話履歴を Redis で永続化する - スケーラブルなチャットセッション設計
Gemini API の ChatSession をインメモリで持ち回すと、Cloud Run の再デプロイやサーバースケール時に履歴が吹き飛びます。Redis に保存するだけの素朴な実装が本番で破綻する理由と、TTL・トークン上限・同時編集を踏まえた実用パターンを整理しました。
Gemini API エラー完全逆引きハンドブック — 401 / 403 / 404 / 429 / 500 / 503 を症状から追い詰める
Gemini API 運用で遭遇する主要エラーを、HTTP ステータス・エラーコード・症状の 3 軸で逆引きできる辞典として整理しました。認証・モデル名・クォータ・安全性フィルタ・リージョン・SDK 起因のケースまで、根本原因と復旧パスを網羅します。
Gemini API で `gemini-2.5-pro-latest` が 404 になる — モデル名エイリアスと正しいバージョン指定
Gemini API でモデル名 `gemini-2.5-pro-latest` を指定すると 404 になる原因と、正しいモデル識別子・バージョン固定・alias の使い分けを整理します。generativelanguage.googleapis.com に対するリクエストが通らないときの切り分け手順も解説します。
Gemini API の出力がコードフェンスで囲まれて動かない問題 — 生コードだけを取り出す実装パターン
Gemini API に『Python のコードだけを返して』と頼んでも ```python ... ``` で囲まれて返ってくる問題。System Instructions では完全に抑えきれないため、正規表現での後処理と JSON スキーマ併用の実装パターンを紹介します。
Google AI Studio で動いたプロンプトが API 経由だと失敗するときの診断ガイド
Google AI Studio のプレイグラウンドでは完璧に動いたプロンプトが、自分のコードから Gemini API を呼ぶと 400/404/空応答になる——その差を埋めるための原因別チェックリストをご紹介します。
Gemini API Safety Settings の本番運用設計 — 誤ブロックを最小化しつつ悪意ある入力を止めるレイヤード・モデレーション
Gemini API の Safety Settings だけに依存すると、正当な質問が誤ブロックされたり、プロンプトを工夫した悪意のある入力が通ったりします。本番で耐えられる 4 層モデレーション設計を解説します。
Gemini API × Langfuse — LLM オブザーバビリティの本番実装ガイド
Gemini API を本番運用するチーム向けに、Langfuse を使った LLM オブザーバビリティの実装を体系的に解説します。トレース設計、コスト可視化、プロダクショントレースでの LLM-as-Judge 評価、PII マスキング、サンプリングまで動作コード付きで網羅します。