すべての記事
Gemini API の構造化出力が本番で静かにスキーマから外れるとき — 検証と再試行を計測する運用メモ
response_schema を指定しても、Gemini の構造化出力は本番で時折スキーマからずれます。失敗を握りつぶさず計測し、finish_reason で原因を切り分け、エラーを差し戻して再試行する。実運用で安定させた検証パイプラインのメモです。
プレビュー画像モデル停止の朝に学んだこと — Gemini 画像モデル GA 移行と廃止に強いパイプライン設計
gemini-3.1-flash-image-preview と gemini-3-pro-image-preview の停止を機に、GA 版への移行手順と、廃止日に振り回されない画像生成パイプラインの設計をコード付きで整理します。動画から画像を生成するサムネイル自動化も扱います。
File Searchの回答に「何ページの、どの図か」まで添える ― 視覚引用メタデータで出典を検証可能にする
File Search の grounding metadata に media_id と page_numbers が加わり、回答のどの一文がどのページ・どの図に基づくのかを辿れるようになりました。PDFと画像を混ぜた参照データで、検証可能な引用UIを組み立てるまでを実装で整理します。
Gemini API × GraphQL インテリジェントデータレイヤー構築ガイド
GraphQL スキーマに Gemini API を統合し、AI 駆動のリゾルバー、セマンティックキャッシュ、型安全な設計を実装するための包括的ガイド。本番レベルのインテリジェントデータレイヤーを構築します。
Gemini API × Cloudflare D1：エッジSQLiteでAIバックエンドを月$10以下に収めた実装メモ
Cloudflare Workers + D1（エッジSQLite）とGemini APIで、コールドスタートゼロ・グローバル低レイテンシー・月$10以下のAIバックエンドを構築する実装メモ。スキーマ設計からレート制限、ストリーミング後の遅延隠蔽、本番運用までを実体験ベースでまとめました。
Webhooks に移しても、デプロイの瞬間にイベントは落ちる — Gemini 長時間オペレーションを照合で二重化した運用メモ
ポーリングから Webhooks へ移した後でも、デプロイや一時的な 5xx の瞬間にイベントは取りこぼされます。Gemini の長時間オペレーションを操作台帳と低頻度の照合ポーラーで二重化し、終端イベントの欠落を拾い直す設計を実装メモとして残します。
Gemini API を Edge に載せると subrequest 上限で静かに落ちる — 残量を計装して守る運用メモ
Gemini API を Cloudflare Workers で運用していると、平常時は問題ないのに負荷やツール連鎖が深まった瞬間だけ subrequest 上限で落ちます。残量をリクエスト単位で計測し、予算として守るための計装パターンと実装を、個人開発で運用しているサイト群の知見からまとめます。
Gemini APIのFunction Callingが無限ループする原因と止め方
Function Callingを組んでいたら、同じツールを何度も呼び続けて処理が終わらなくなる。そんなときに原因を特定し、最短で止めるための診断と対策をまとめました。デフォルトモデルの世代交代で再発するループの検知や、結果ベースのストール検出まで実装で示します。
File Search のストアが本番で静かに陳腐化する — カタログ同期とドリフト検知を実装した運用メモ
File Search に一度カタログを流し込んで終わりにすると、配信を止めたアセットを案内する『古い回答』が本番で返り始めます。ハッシュ差分の増分取り込みと、削除を割り切るブルーグリーン再構築、そして定期ドリフト検知までを実装で整理しました。
Gemini 3.2 Pro の Function Calling を iOS/Android アプリに統合する実装パターン
Gemini 3.2 Pro の Function Calling を iOS/Android アプリに統合する実装ガイド。SwiftUI・Kotlin 両対応の動くコード例と、個人開発の壁紙アプリで実証した本番設計パターン（コスト・レイテンシ・段階ロールアウト・回帰テスト）を解説します。
Gemini API の平均レイテンシは速いのに、たまに固まる — p95/p99 を守る運用メモ
平均TTFTは速いのに、一定割合のユーザーだけ応答が固まる — これはテールレイテンシ（p95/p99）の問題です。計測の取り方からモデルルーティング・ストリーミング予算・キャッシュ会計・リトライ設計まで、本番で効いた防衛策をコード付きで共有します。
Gemini API の Function Calling 実装 — 並列実行・ツールチェーン・Managed Agents の使い分け
Gemini API の Function Calling を本番で運用する実装パターンを、並列実行・エラー処理・ツールチェーンから Managed Agents との使い分け、GA モデルのピン留めまで動くコードで解説します。