すべての記事
Gemini で組む LLM-as-Judge 評価パイプライン — 本番運用に耐える設計と実装
Gemini 2.5 Pro / 3 Pro を判定者（ジャッジ）として使い、本番品質の LLM 出力評価パイプラインを構築するための実装ガイド。Pointwise / Pairwise 評価・バイアス対策・人手相関の測定・コスト最適化までをコード付きで解説します。
Gemini API に画像を渡しても「画像が見えません」と返るときの診断と対処
Gemini API に画像を入力したのに『画像は添付されていません』と返ってくる現象の原因を、mime_type・サイズ・SDK差・モデル選択の4視点で切り分け、コピペで動く修正コードまで一気通貫で解説します。
Gemini API の maxOutputTokens と stopSequences で出力を精密制御する
Gemini API の maxOutputTokens と stopSequences を組み合わせて、応答長を狙い通りにコントロールする方法を実装パターンとともに解説します。途中で切れる、長すぎる、JSON が壊れる、を一気に解決します。
Gemini API × TanStack Query でストリーミングUI を本番運用する — キャンセル・再試行・キャッシュ整合の設計
TanStack Query は通常の REST/JSON 用に最適化されており、ストリーミング応答との相性は素直ではありません。 Gemini API のSSEを TanStack Query で扱う際の落とし穴と、本番運用に耐える設計パターンを解説します。
Gemini の長文出力で『最後だけ手抜き』を防ぐ — 完成度を落とさないプロンプト設計
Gemini の長文出力で終盤だけ密度が落ちる現象への対策を整理しました。フッター先行宣言で終盤の余力を確保する方法、最終段落を別エージェントに評価させる仕組み、段階分割生成の使いどころと落とし穴、トークンコストとの兼ね合いまで解説します。
Gemini API を Vitest でテストする — TypeScript プロジェクトのモック設計と Function Calling 検証パターン
TypeScript で Gemini API を呼ぶコードを Vitest でテストする実践パターンです。SDK のモック設計、Function Calling とストリーミングの検証、MSW への降ろし方、夜間に実 API を一本だけ通すスモークまで扱います。
Gemini API × Inngest で耐障害性の高いAIワークフローを構築する本番運用ガイド
Gemini API のレート制限・タイムアウト・部分失敗に強いワークフローを、Inngest の durable execution で組む本番ガイドです。最小構成から fan-out / fan-in の並列処理、人間の承認待ち、予算ガードレール、dead-letter と監視まで進めます。
Gemini API の URL Context が取得できない・空応答になる時の確認手順
Gemini API の URL Context ツールが沈黙したり空応答を返す現象は、tool 構成・URL 形式・対象サイト側の制約のいずれかで発生します。原因の切り分け方と回避策をまとめました。
Gemini APIで『thoughts not present in conversation history』エラーが出る - thought_signatures 欠落の対処手順
Gemini 2.5/3.x のThinkingモードでマルチターンFunction Callingを実装すると突然出る『thoughts not present in conversation history』エラーの原因と、最短5分で動く修正手順をPython SDK・ストリーミング双方の例で解説します。
NestJS で Gemini API バックエンドを設計する — DI・例外フィルタ・ガードを活かす実装パターン
NestJS の DI・例外フィルタ・ガードで保守しやすい Gemini API バックエンドを構築する実装パターンを解説します。SSE ストリーミング、Flash→Pro フォールバック、指数バックオフ・リトライ、レイテンシとトークンの実測まで実コードでまとめます。
Gemini API の動的 Few-Shot 設計 — ベクター検索で実例を選び続ける自己改善型プロンプト
Few-Shot プロンプトを「固定の3例」で書いているうちは精度もコストも頭打ちになります。Gemini Embeddings + ベクター検索で例を動的に選ぶ自己改善型プロンプト設計を、コピペで動くコードと運用ループまで通しで解説します。
Gemini API で翻訳精度を最大化する temperature 設定 — 用途別ベストバリューと検証コード
Gemini API の翻訳で temperature をいくつにするか、用途別の早見表と検証コードで示します。値を決めた後に効いてくる、文字列タイプ別プロファイルのコード管理、逆翻訳ゲート、UI がはみ出さない表示幅バジェットまで実装込みでまとめました。