すべての記事
Geminiで作る出典付きRAG ― ハルシネーションを止める引用生成と検証パイプラインの設計
Gemini API を使った RAG に「信頼できる出典」を組み込むための実装パターンを、構造化出力・検証アルゴリズム・UI 表示まで通しで解説します。ハルシネーションを定量的に検出する仕組みも含めて、本番投入できる形で紹介します。
Gemini API の count_tokens 推定と実課金トークン数がズレる5つの原因 — 個人開発者向け原因切り分けと再計算パターン
「count_tokens で 1,200 と出たのに、Cloud Console を見たら 4,800 トークン課金されていた」— このズレ、私もハマりました。Thinking・ツール・マルチモーダル・キャッシュの観点から原因を切り分け、見積もりを実課金に近づける再計算パターンを紹介します。
Gemini APIの『contents must alternate between user and model』エラーが消えない理由と直し方
Gemini API で頻発する『contents must alternate between user and model』エラーの正体と、role 順序・assistant 表記・Function Calling 履歴の落とし穴を、すぐ使える修正コード付きで解説します。
Gemini API で会議音声から話者を識別する — 簡易ダイアリゼーションの実装ガイド
会議録音やポッドキャストの音声から「誰が話したか」を Gemini API のマルチモーダル音声理解で識別する方法です。話者ラベルつき JSON を返す最小構成のコード、結果を底上げする3つのプロンプトの工夫、専用ツールとの使い分けを解説します。
Vertex AI Agent Engine × Gemini 2.5 Pro — 本番運用エージェントのマネージドデプロイ
Vertex AI Agent Engine に Gemini 2.5 Pro ベースのエージェントを本番デプロイする実装ガイド。Cloud Run との違い、セッション管理、ツール呼び出し、Trace、コスト設計まで網羅。
.geminiignore で Gemini CLI と Code Assist のコンテキスト精度を上げる
.geminiignore で Gemini CLI と Code Assist のコンテキスト窓を整理し、回答精度とトークン消費を同時に改善する方法です。.gitignore との違い、最低限入れたいパターン集、モノレポでの応用、効果を計測する手順、関連設定との使い分けを解説します。
電話を受けるAIを本番投入する：Gemini Live API × Twilio Media Streams で構築する電話応答エージェント
Twilio Voice と Gemini Live API を WebSocket で橋渡しし、電話に出る AI 音声エージェントを本番運用するための実装手順・割り込み処理・Function Calling・コスト試算までを完全コード付きで解説します。
Gemini API の構造化出力を本番品質まで引き上げる設計図
Gemini API の構造化出力を本番アプリで安定稼働させる設計図です。人間にも読みやすいスキーマ設計、required の明示的な管理、階層を深くしすぎない原則、エラー時の振る舞い制御、大規模スキーマを扱う階層分割パターンまで体系化しました。
Google AI Pro と Ultra、個人開発者はどちらを選ぶべきか — 3か月使い分けて出た結論
Google AI Pro（¥2,900/月）と Ultra（$249/月）を3か月並行利用して見えた、個人開発者が「どちらを選ぶべきか」の判断軸を整理しました。価格表だけでは見えない実用面の差を共有します。
Mastra と Gemini API で TypeScript エージェントを 30 分で本番投入する
TypeScript で AI エージェントを書くなら、Vercel AI SDK の薄さを保ちつつワークフローやメモリも扱える Mastra が現実解です。Gemini API と組み合わせて、ローカル開発から Cloudflare Workers デプロイまでを 30 分で一気通貫させる手順を解説します。
Gemini API に個人情報を渡してしまう前に — PII マスキング・監査ログ・運用設計の本番実装ガイド
ユーザーから受け取ったテキストをそのまま Gemini API に渡していませんか。個人情報の検出・マスキング・監査ログまで含めた、コンプライアンス審査に通る本番運用設計を、実装コードと運用判断の両面から解説します。
@google/genai 移行で詰まりやすい7つのエラーと解決策
@google/generative-ai から @google/genai へ移行するときに高確率で踏むエラーを、実例コードと修正パターン付きで整理しました。Node.js / TypeScript の本番コードで詰まらないための実践ガイドです。