Gemini Embeddings × リランカーで本番RAGの精度を底上げする — Vertex AI Ranking と LLM-as-judge の使い分け
Embeddings だけでは取りこぼす「上位3件は当たり前に合うのに5件目以降に正解が埋もれる」問題を、Vertex AI Ranking API と Gemini を使ったリランカーで解決する本番アーキテクチャを実装コード付きで解説します。
同じ gemini-flash-latest が、リージョンごとに違うモデルを指していた — 比較値が汚れる数日間の見つけ方
エイリアスの解決先はリージョン単位でロールアウトされます。同じ gemini-flash-latest を東京と us-central1 に投げると、数日だけ別のモデルが応答する。その間の比較値が無効になる理由と、1発のプローブで検知して比較を凍結する設計をまとめます。
利用者データを『どのリージョンで処理したか』を後から言えるようにする — Gemini(Vertex AI) のエンドポイント固定とレジデンシ・ポリシーゲート
既定の global エンドポイントは便利ですが、EU 利用者のデータがどこで処理されたかを後から説明できません。Vertex AI のリージョン固定クライアント・グローバル暗黙フォールバックを禁じるポリシーゲート・呼び出し台帳の三点を、動くコードと実測レイテンシとともに設計します。
Gemini の Maps Grounding が本番で静かに外れるとき — アトリビューション義務・課金の境界・不発時のフォールバックの運用メモ
Gemini の Grounding with Google Maps を本番に載せた後で効いてくる落とし穴を運用視点でまとめます。グラウンディングの不発検知、アトリビューション表示の義務、課金が発生する境界、鮮度のずれに備えるフォールバックの実装です。
Gemini API で User location is not supported が出たときに、本番環境で試した解決の順番
Cloudflare Workers や Vercel から Gemini API を呼んだときに突然出る『User location is not supported』エラー。個人開発のサーバー移行中に遭遇した実例をもとに、原因切り分けから本番復旧までの順番をまとめました。
AI Studio で動いていたコードを Vertex AI に移したら何が変わったか — 個人開発者の移行作業ログ
AI Studio の API キーで動いていた Gemini のコードを Vertex AI に移行した作業ログです。SDK 初期化の書き換え、認証エラーで丸一日費やした環境変数、構造化出力で気づいたレスポンス形式の差異など、実際に手を動かして分かった差分を残しました。
Gemini APIで GEMINI_API_KEY と GOOGLE_API_KEY のどちらを使うか問題を解決する
Gemini API で GEMINI_API_KEY と GOOGLE_API_KEY のどちらを使うべきか迷ったときに読む実践ガイド。SDK ごとの優先順位、Vertex AI モードの自動切替、つまずきやすいハマりパターンを切り分け手順とコード例で整理します。
Vertex AI + Gemini 認証エラーの解決方法：サービスアカウント・ADC 完全対処ガイド
Vertex AI で Gemini を使う際の認証エラーを完全解説。サービスアカウントの権限設定ミス・ADC（Application Default Credentials）の原因と解決手順をStep by Stepで紹介します。