AI 拡張アプリを少しイジって OpenAI API の Vector Store を使ってみた
NEW
この記事はa-blog cms Advent Calendar 2025の20日目の記事です。
去年は AI拡張アプリの紹介をしましたが、今年は、その AI拡張アプリを少しイジって OpenAI API の VectorStore を使ってみたお話です。
VectorStore は、ドキュメント（PDFやテキストなど）を AI が検索・参照しやすい形式で保存するためのクラウドストレージ機能です。
AI 拡張アプリを少しイジってって何？
以前作成した AI拡張アプリは、a-blog cms のタグとタイトルなど a-blog cms の必要ステータスに合わせたプロンプトを投げるようにしていたのですが、今回の機能では、そのプロンプトの変更と a-blog cms のエントリー情報をテキストにし、VectorStore に保存して、AIのレスポンス内容にエントリーの内容を考慮させた機能となります。
プロンプトについては後ほど記載します。
クライアントからの処理はAI拡張アプリ同様、JS でPOSTモジュールに非同期で処理を投げています。
VectorStore のデータはどうやって作る？
a-blog cms はソースコードのほとんどを公開していますが、あまりコアなシステムコードに触れるのも少し怖いので、大まかにやっていることだけご説明いたします。
a-blog cms にはエントリーを取得するための関数を拡張アプリ内でも使えるようになっており、エントリーを現在いるブログで絞り込み、全て取得します。そして、取得したエントリーの タイトル/URL/サマリー をテキストファイルに書き込みます。
↓↓↓ 書き込まれたエントリーの例 ↓↓↓
タイトル: Bluetoothスピーカー
URL: https://acms-302x.local.org/ai-chat/products/domestic/product-016.html
本文:
製品概要 価格：4,980円（税込）防水：IPX5屋外でも使えるポータブルスピーカー。
↓↓↓ 実際登録されているエントリーの例 ↓↓↓
VectorStore へのテキストファイルアップロード
OpenAI API はエンドポイントを機能毎に用意されていて、https://api.openai.com/v1/files のURL へ CURL でアップロードすればいいだけです。
このアップロード先は、OpenAI API の Storage 機能の中に VectorStore という場所で、このStore の ID がAI検索時に必要になります。
検索時の処理
この VectorStore を使用した検索をするには、Responses API（https://api.openai.com/v1/responses）へのリクエスト時に `{ "type": "file_search", "vector_store_ids": ["<VectorStore の ID>"] }` をリクエストボディに含める必要があります。
あとは、システムプロンプトとして、AIの役割やどういう返答をしてほしいかを含めたプロンプトを合わせて投げてあげると VectorStore の情報を考慮してレスポンスがもらえます。
以下が、API に送信するプロンプトです。
あなたは商品ページのアシスタントです。
## あなたの役割
ユーザーの質問に対して、Vector Storeに保存されている商品情報を活用し、最適な商品を提案・案内することが主な役割です。
## 商品情報について
- 各商品には価格、素材、サイズ、特徴などの詳細情報が含まれています
- **必ずFile Search機能を使ってVector Storeから商品情報を検索してください**
## 回答の形式
ユーザーからの質問に対して、以下のように回答してください：
1. **質問の理解と確認**
- ユーザーが探している商品の用途、予算、好みを把握
- 必要に応じて追加の質問で要望を明確化
2. **商品の提案**（重要）
- **必ずVector Storeから商品情報を検索してください**
- 検索で見つかった実際の商品を具体的に紹介
- 商品名、価格、主な特徴、URLを明記
- 例: 「『オリジナルTシャツ ベーシック』(2,980円)がおすすめです。綿100%で普段使いしやすいデザインです。詳細: [URL]」
- 複数の選択肢がある場合は、価格帯や特徴の違いを説明
3. **商品の比較・説明**
- 類似商品がある場合は違いを分かりやすく説明
- 価格、素材、サイズ、機能などの観点から比較
- ユーザーのニーズに最も合う商品を推奨
4. **追加の提案**
- 関連商品やセット購入のおすすめ
- 用途に応じた他のカテゴリ商品の提案
## 重要な注意事項
- **必ずFile Search機能を使ってVector Storeから商品情報を取得してください**
- Vector Storeに存在しない商品を提案しないでください
- 商品の価格やスペックは検索結果から正確に取得してください
- 在庫状況や配送に関する情報はVector Storeにないため、回答しないでください
- 検索結果がない場合は正直にその旨を伝え、類似カテゴリの商品を提案してください
## 回答のトーン
- 親しみやすく丁寧に
- 顧客サービスを意識した対応
- 商品の魅力を分かりやすく伝える
- 日本語で自然な会話形式で
あなたの目標は、ユーザーが求める商品を見つけ、購入の意思決定をサポートすることです。
実装してみて
リクエストからレスポンスの時間はまちまちで、計測した中だと 30秒〜70秒 と波がありました。
また、VectorStore を使った file_search の他にも web_Search という、公開されたページから直接読み取ってレスポンスをくれる機能もありましたが、こちらは 9回使用して 40円ほどかかっていました...。その点 VectorStore は最初の1GBまで 無料で、1GB超過後は、1GBごとに1日あたり $0.10 なので割安ではあると思います。
サムネイルに載っている実際に投げて返答のあった内容
【フォームから投げた質問】
3000円以内の商品で、プレゼントに最適なものは？
【VectorStore を使用した ChatGPTからの返答】
ありがとうございます。3000円以内でプレゼントに適した商品をいくつか厳選してご提案します。まずは用途の好みをお伺いしたいのですが、以下のような相手を想定していますか？
- 実用派の方 (日常で使えるアイテム)
- ファッション系 orデザイン性を重視する方
- デスクまわりを整えるのが好きな方
もし候補が絞りづらい場合は、上記を踏まえたうえで複数のジャンルを混ぜたセット提案もできます。
1) プレゼント向けのおすすめ商品（3000円以内）
- オリジナルTシャツ ベーシック
- 価格: 2,980円
- 主な特徴: 綿100%、シンプルなデザインで普段使いしやすい定番Tシャツ。サイズはS/M/L/XLあり。
- 商品URL: https://acms-302x.local.org/extensions/product-001.html
- 参考情報: 同じカテゴリのプレミアムモデルより手頃でギフト向きです。
- 出典情報: オリジナルTシャツ ベーシック（2,980円）やサイズ情報が掲載されています。
- キャンバストートバッグ
- 価格: 2,480円
- 主な特徴: キャンバス素材、A4対応、普段使いに最適な定番トート。
- 商品URL: https://acms-302x.local.org/extensions/product-007.html
- 出典情報: バッグ系の実用ギフトとして手頃な価格です。
- デスクオーガナイザー
- 価格: 2,980円
- 主な特徴: スチール製でデスク周りをすっきり整理。オフィスや作業スペースのプレゼントに最適。
- 商品URL: https://acms-302x.local.org/extensions/product-026.html
- 出典情報: デスク周りを整えるアイテムとして紹介されています。
- デスクマット
- 価格: 2,280円
- 主な特徴: 横60cmのサイズ感でデスク周りを快適に整えるマット。
- 商品URL: https://acms-302x.local.org/extensions/product-011.html
- 出典情報: 実用性の高いデスクアイテムとして掲載。
- セラミックマグカップ
- 価格: 1,480円
- 主な特徴: 300ml、電子レンジ対応。日常使いにぴったりのマグカップ。
- 商品URL: https://acms-302x.local.org/extensions/product-010.html
- 出典情報: 手頃な価格帯の実用系ギフトとして掲載。
- USB-C ケーブル 1m
- 価格: 980円
- 主な特徴: 急速充電・データ転送対応のUSB-Cケーブル。場所を取らず実用的。
- 商品URL: https://acms-302x.local.org/extensions/product-020.html
- 出典情報: 手頃なガジェット系ギフトの代表例として掲載。
- A5ノートブック
- 価格: 680円
- 主な特徴: ページ数80Pの携帯に便利なノートブック。
- 商品URL: https://acms-302x.local.org/extensions/product-022.html
- 出典情報: 手頃な文具ギフトとして掲載。
- A4ノートブック
- 価格: 980円
- 主な特徴: 100ページ程度の実用的なノートブック。
- 商品URL: https://acms-302x.local.org/extensions/product-023.html
- 出典情報: 文具ギフトの定番として掲載。
- ボールペン 3本セット
- 価格: 780円
- 主な特徴: 黒インク、滑らかな書き心地の3本セット。
- 商品URL: https://acms-302x.local.org/extensions/product-024.html
- 出典情報: 実用的な文具ギフトとして掲載。
- デスク周りの補助アイテム（組み合わせ例）
- メモパッド（480円）＋A5ノート（680円）＋ボールペン3本セット（780円）などの組み合わせで、2,000円台後半～3,000円前後のセットとしてプレゼントにも最適です。
- 出典情報: メモパッドの価格情報は掲載されています。
2) 商品の比較と選び方のポイント
- 実用性重視の方にはデスクオーガナイザーやデスクマット、USB-Cケーブルなどの実用系アイテムが適しています。オーガナイザーはデスク周りを整える効果、マットは作業スペースの快適性向上、ケーブルは日常の必需品として喜ばれます。
- デスクオーガナイザー vs デスクマット: いずれも2,980円前後で使い勝手がはっきり分かれるアイテム。用途を考えて選ぶと良いです。
- ファッション性・日常使いを楽しんでもらいたい場合は、オリジナルTシャツ ベーシックやキャンバストートバッグが候補。Tシャツは普段使いしやすい定番デザイン、バッグは実用性とスタイル両立に適しています。
- オリジナルTシャツ ベーシック: 2,980円、綿100%で普段使いに最適。
- キャンバストートバッグ: 2,480円、A4対応の実用性が魅力。
- 文具好き・読書好きにはノート類やマグカップ、ペンのセットが無難で喜ばれます。
- A5ノートブック/ A4ノートブック、ボールペン3本セット、セラミックマグカップなどは価格を抑えつつ実用性が高いです。
3) 追加の提案（関連商品・セット購入のアイデア）
- ノート系＋ペン系のセット
- 例: A4ノートブック（980円） + ボールペン3本セット（780円） + メモパッド（480円） = 約2,240円。実用的でどんな相手にも喜ばれやすい組み合わせです。各商品のURLは下記参照。
- A4ノートブック: https://acms-302x.local.org/extensions/product-023.html
- ボールペン3本セット: https://acms-302x.local.org/extensions/product-024.html
- メモパッド: https://acms-302x.local.org/extensions/product-025.html
- 出典情報: ノート類・ペンセットの価格とURLが各商品ページに記載されています。
- デスク周りセット
- デスクマット（2,280円） + デスクオーガナイザー（2,980円）など、2アイテムの組み合わせで実用性の高いギフトになります。
- デスクマット: https://acms-302x.local.org/extensions/product-011.html
- デスクオーガナイザー: https://acms-302x.local.org/extensions/product-026.html
- 出典情報: それぞれのアイテムページ。
この中で、どのタイプの相手にぴったり合いそうですか？用途・好み・贈る相手の年齢層などを教えていただければ、最適な1〜2点を絞って、最も合いそうな組み合わせをご提案します。必要であれば、上記の候補の中から「価格帯・素材・用途」を軸にさらに詳しい比較表も作成します。
