すべての記事
電話を受けるAIを本番投入する：Gemini Live API × Twilio Media Streams で構築する電話応答エージェント
Twilio Voice と Gemini Live API を WebSocket で橋渡しし、電話に出る AI 音声エージェントを本番運用するための実装手順・割り込み処理・Function Calling・コスト試算までを完全コード付きで解説します。
Gemini API の構造化出力を本番品質まで引き上げる設計図
Gemini API の構造化出力（Structured Output）を本番アプリケーションで安定稼働させるための実践的な設計図。スキーマ設計・エラー対応・パフォーマンス最適化まで体系化します。
Gemini API に個人情報を渡してしまう前に — PII マスキング・監査ログ・運用設計の本番実装ガイド
ユーザーから受け取ったテキストをそのまま Gemini API に渡していませんか。個人情報の検出・マスキング・監査ログまで含めた、コンプライアンス審査に通る本番運用設計を、実装コードと運用判断の両面から解説します。
@google/genai 移行で詰まりやすい7つのエラーと解決策
@google/generative-ai から @google/genai へ移行するときに高確率で踏むエラーを、実例コードと修正パターン付きで整理しました。Node.js / TypeScript の本番コードで詰まらないための実践ガイドです。
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 API × Inngest で耐障害性の高いAIワークフローを構築する本番運用ガイド
Gemini APIのレート制限・タイムアウト・部分失敗に強い「耐障害性の高い」AIワークフローを、Inngestのdurable executionで実装する本番運用パターンを解説します。
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 フォールバック、指数バックオフ・リトライ、レイテンシとトークンの実測まで実コードでまとめます。