TAG

structured-output

26 記事

response_schema を指定しても、Gemini の構造化出力は本番で時折スキーマからずれます。失敗を握りつぶさず計測し、finish_reason で原因を切り分け、エラーを差し戻して再試行する。実運用で安定させた検証パイプラインのメモです。

商品画像から自動でタグ・説明文・カテゴリを生成するツールを、単発の試作から数千枚を安定処理する本番パイプラインへ。構造化出力・再開可能なバッチ・実測コスト・モデルルーティングまで、個人開発の運用で固めた知見をまとめます。

種類の違う入力を1つのエンドポイントで分類すると、フラットなスキーマは null だらけになります。anyOf 判別ユニオンで種別ごとに型を切り替え、Pydantic / Zod で安全に受け取る実装をまとめました。

Gemini の構造化出力は「パースできるJSON」は保証しても「正しい値」までは保証しません。@google/genai での新しいスキーマ設計、propertyOrdering の効き目、Zod による二重検証、MAX_TOKENS 切れの扱い、抑制つきリトライの実装をまとめました。

Daily Brief に着想を得て、夜間の運用ログを毎朝1通のダイジェストに変えるパイプラインを自作しました。収集・構造化・要約・配信の4段構成と実測トークン数、障害の朝でも配信を止めないフォールバック設計までの実装記録です。

Gemini API の responseSchema を使った構造化出力で頻発するバリデーションエラー（INVALID_ARGUMENT、schema mismatch、空配列、不要フィールド）の原因と、実運用で安定させるための実装パターンを個人開発の現場視点でまとめます。

App Store と Google Play のレビューを Gemini API で並列に分類し、プラットフォーム間の差分から優先改善項目を抽出する運用を6週間続けた記録です。累計5,000万DLの壁紙アプリで実際に見えた3つのプラットフォーム差と、月の運用コストを共有します。

Function Callingで外部APIを呼びつつ、最終回答は決まった形のJSONで受け取りたい。tools と responseSchema を両方指定すると400エラーになる仕様の理由と、本番で安定して動く3つの回避設計を実装例つきで解説します。

一人運営のサービスに届く問い合わせフォームの内容を、Gemini API で自動分類・優先度付けして Slack に通知するシステムを Python で作ります。分類プロンプトの設計から通知の実装、Google フォームとの連携まで、動くコードを追いながら組み立てます。

Gemini API の構造化出力を Zod スキーマで検証する実装パターンを解説します。as による型キャストの落とし穴、JSON Schema への変換、検証失敗時のリトライ設計までコード付きで紹介します。

Gemini API の JSON Mode や構造化出力で、不正な JSON・スキーマ違反・途中切れが起きる原因を症状別の5パターンに分けて分析します。ステップごとの解決手順、直ったかどうかの検証方法、再発を防ぐ予防策までコード例つきで解説します。

Gemini API と Python を使ってテキスト分類や感情分析を実装する方法を解説。Structured Output でラベル付け精度を高め、カスタマーレビューやSNS投稿の自動仕分けを実現します。