すべての記事
AI Studio の開発者ログを本番の正本にしない — Interactions API を二層で観測する設計
AI Studio に追加された Interactions API の開発者ログを、速報レンズと正本ログに役割分担する設計です。自前の構造化ログと突合コード、100,000 件で測った格納先の容量比較、機能別のコスト按分まで、個人開発の運用視点でまとめました。
会話状態をサーバーに預けるべきか — previous_interaction_id と手元での履歴刈り込みの分岐設計
Interactions API の previous_interaction_id で会話状態をサーバーに預けると、毎回履歴を送らずに済みます。ところが途中で入った巨大なツール出力を後から刈り込めず、以降のターンが重量を引きずる落とし穴があります。サーバー側状態と手元での刈り込みを状況で使い分ける分岐設計を、動くPythonの薄いラッパーとともに整理します。
Managed Agents を background: true で走らせて画面を止めない — 個人開発の非同期ラン設計
Managed Agents の background 実行は結果ではなくラン ID を即座に返します。ポーリングの最小構成と、個人開発での使いどころ、認証情報リフレッシュの注意点を実務目線でまとめました。
静止画か短い動画か — Nano Banana 2 Lite と Omni Flash のコスト桁差で機能の置き所を決める
壁紙アプリの目玉アセットを静止画にするか短い動画にするかで手が止まったとき、決め手になったのは好みではなくコストの桁でした。Nano Banana 2 Lite と Omni Flash の単価を同じ土俵に並べ、動く意思決定関数まで落とし込みます。
Omni Flash の会話編集は「アングルを30度右へ」をどこまで聞き取るか — 指示が効く境界を実測した記録
公開プレビューの Gemini Omni Flash は、生成した動画を自然文で編集し直せます。ただし『照明を夕方に』は効いても『カメラを30度右へ』はしばしば外れます。効く指示と外れる指示の境界を、フレーム照合で機械的に仕分けながら測った運用記録です。
Managed Agent の長時間走行がサンドボックス再生成で消える前に — チェックポイントと冪等リジュームの設計
Managed Agents のサンドボックスは再生成されます。40分走った処理が振り出しに戻る前に、進捗を外部へ逃がすチェックポイントと、副作用を二度実行しない冪等リジュームを設計します。SQLite で動く実装つき。
「検出されませんでした」は、AI 生成でない証明にはなりません — SynthID の非対称性
SynthID の検出結果は「出た」と「出なかった」で意味の重さがまったく違います。Gemini 生成画像の透かしがどこまでの加工で残るのか、検出されなかった場合に何が言えないのか、個人開発では生成の瞬間に来歴を記録すべき理由まで整理しました。
同じ gemini-flash-latest が、リージョンごとに違うモデルを指していた — 比較値が汚れる数日間の見つけ方
エイリアスの解決先はリージョン単位でロールアウトされます。同じ gemini-flash-latest を東京と us-central1 に投げると、数日だけ別のモデルが応答する。その間の比較値が無効になる理由と、1発のプローブで検知して比較を凍結する設計をまとめます。
難読化されたスタックトレースを Gemini に渡していました — retrace を前段に置くまで、診断はもっともらしく外れ続けます
release ビルドのスタックトレースは R8 で名前が潰れています。それをそのまま Gemini に渡すと、診断は落ち着いた文体のまま外れます。retrace を前段に置き、mapping を versionCode で突合し、復元できないときは断定させない。42件で数え直した記録です。
目標日を迎えても来なかったモデルに、設定を先に合わせない — 上限を実測から引くコンテキスト予算の設計
報道された 7/17 を迎えても Gemini 3.5 Pro の公式発表はありません。噂の数値を定数に焼き込む代わりに、モデルが公表する上限を実測から引き、超過時に落とさず縮退させるコンテキスト予算層を、動くコードで設計します。
日本語で引いた検索に、対訳の英語記事が出てこない — 埋め込みが内容より先に言語を見ている件
gemini-embedding-2 で日英の対訳ペアを埋め込むと、同じ内容なのに最近傍になりません。言語そのものが類似度を押し上げているためです。対訳ペアを正解として再現率を測り、言語重心を引く方法と翻訳ブリッジを比べた記録をまとめます。
途中で切れた Gemini のストリーミングを、引き直すか続きから書かせるか — 二重に払わないための分岐設計
モバイル回線で Gemini のストリーミングが切れたとき、全部引き直すか続きから書かせるかで費用は大きく変わります。思考トークンの二重発生、受信トークン数で置く分岐条件、文末チェックポイント、継ぎ目に出る3つの壊れ方まで設計としてまとめました。