TAG

本番運用

49 記事

一本化したはずの旧プロンプトがまだ毎日呼ばれている——そんな見えない稼働経路を炙り出す退役台帳の設計です。静的参照、フラグ既定値、観測窓、モデル停止日、キャッシュ実効率の5つを突き合わせる判定基準と、実運用で得た設計の勘所を実行結果とともにまとめました。

AI Studio に追加された Interactions API の開発者ログを、速報レンズと正本ログに役割分担する設計です。自前の構造化ログと突合コード、100,000 件で測った格納先の容量比較、機能別のコスト按分まで、個人開発の運用視点でまとめました。

信頼度ゲートが見ているのは、モデルが迷った出力だけです。静かな劣化は自動採用された側に沈みます。1日30分というレビュー予算を前提に、二項分布で検出日数を見積もり、層別抜き取りと累積監視で気づく速さを上げた設計と実測を共有します。

Gemini API を Cloud Pub/Sub のイベント駆動型ワークフローに組み込む実装メモ。アプリレビュー解析パイプラインを題材に、リトライ・デッドレター・冪等性・コスト管理までを個人開発の視点で整理しました。

日本語マルチモーダルのローカル運用を検討するとき、Heron-Bench や JMMMU の総合スコアは採否の材料になりません。壁紙アプリの分類を題材に、100枚の評価セットの組み方・誤りのコストで重み付けした判定・量子化更新での回帰検知までを動くコードで組み立てます。

Gemini API をサーバレスで動かしたときの最初の1リクエストだけ6秒という体感問題を、Cloud Run・AWS Lambda・Cloudflare Workers それぞれの起動最適化パターンで解決します。実測値・コード例・コスト判断軸まで踏み込んで解説します。

ユーザーから受け取ったテキストをそのまま Gemini API に渡していませんか。個人情報の検出・マスキング・監査ログまで含めた、コンプライアンス審査に通る本番運用設計を、実装コードと運用判断の両面から解説します。

Gemini API を使った個人開発 SaaS で「使った分だけ請求する」課金システムを Stripe Metered Billing と Webhook で本番実装する実践ガイド。トークン計測・サブスク同期・ティア別ゲーティング・落とし穴まで網羅します。

Gemini 2.5 Pro の Function Calling は強力ですが、本番環境に持っていくと「動くけれどたまに変なことをする」状態になりがちです。私が実装した検索・予約・通知エージェントの運用知見を基に、堅牢な設計パターンを共有します。

Gemini API の構造化出力は便利ですが、本番運用で「想定外フォーマット」が混じる瞬間は必ず来ます。Zod / Pydantic を組み合わせた多層検証、失敗時の縮退戦略、再試行と修復プロンプトの設計まで、個人開発で運用している防御線をまとめます。

Gemini API を複数テナントに提供する SaaS の本番アーキテクチャを Python コードつきでまとめました。テナント分離モデルの選択、テナント別レート制限、リクエスト単位の課金計測、月予算ガードとサーキットブレーカーによる暴走防止まで扱います。

Cloud Run のタイムアウトと Gemini API のレート制限に挟まれて落ちる同期実装から、Cloud Tasks を軸にした非同期ジョブキュー設計へ移行する実践ガイドです。リトライ・DLQ・進捗通知まで本番で通る形で解説します。