大規模言語モデル (LLM) は、プライベートデータに関する質問に回答できません。ナレッジ検索ツールは、ナレッジベースからコンテンツを取得し、LLM に提供します。これにより、モデルはより正確で関連性の高い回答を生成できます。
前提条件
- API キーを取得し、環境変数として設定します。
-
ナレッジベースを作成し、その ID を取得します。ナレッジベースは、以下のいずれかの方法で作成できます。
- コンソールで作成:Model Studio コンソールのナレッジベースページでナレッジベースを作成します。詳細については、「ナレッジベースの作成と使用」をご参照ください。
-
API を使用して作成:Alibaba Cloud Model Studio の SDK を介して API を呼び出し、ナレッジベースを作成できます。詳細については、「ナレッジベース API ガイド」をご参照ください。
API を使用してナレッジベースを作成する前に、Model Studio コンソールからワークスペース ID (
workspace_id) を取得してください。ドキュメント検索とデータクエリの 2 種類のナレッジベースのみがサポートされています。これらのタイプは、基本的なドキュメントの Q&A ペアに適しており、リッチテキストや画像を含む応答はサポートされていません。
使用方法
知識検索機能は、file_search ツールを tools パラメーターに追加し、vector_store_ids パラメーターでナレッジベース ID を指定することで、Responses API を介して呼び出すことができます。
開始する前に、ナレッジベースを作成して使用し、その ID を取得します。現在、vector_store_ids パラメーターは 1 つのナレッジベース ID のみをサポートしています。
サポートされるモデル
- Qwen-Max:Qwen3.8-Max シリーズおよび Qwen3.7-Max シリーズ
- Qwen-Plus:Qwen3.7-Plus シリーズ、Qwen3.6-Plus シリーズ、および Qwen3.5-Plus シリーズ
- Qwen-Flash:Qwen3.7-Flash シリーズ、Qwen3.6-Flash シリーズ、および Qwen3.5-Flash シリーズ
- Qwen3.8 オープンソースシリーズ
- Qwen3.6 オープンソースシリーズ (qwen3.6-27b を除く)
- Qwen3.5 オープンソースシリーズ
クイックスタート
次のコードを実行して、Responses API を介してナレッジ検索ツールを呼び出します。このツールは、指定されたナレッジベースから関連コンテンツを取得して応答を生成します。
サンプルコード内の vector_store_ids を、お使いのナレッジベース ID に置き換えてください。
ストリーミング出力
ナレッジ検索ツールは、ナレッジベース内でセマンティック検索を実行するため、処理に時間がかかる場合があります。ストリーミング出力を有効にすると、中間結果をリアルタイムで取得できます。
パラメーター
file_search ツールは、以下のパラメーターをサポートしています。
| パラメーター | 必須 | 説明 |
|---|---|---|
type | はい | "file_search" に設定する必要があります。 |
vector_store_ids | はい | ナレッジベース ID のリストです。現在、渡すことができるナレッジベース ID は1 つだけです。ナレッジベース ID は、Model Studio コンソールのナレッジベース詳細ページで確認するか、API を使用してナレッジベースを作成する際に取得できます。有効なナレッジベース ID を渡すようにしてください。空の配列や無効な ID を渡した場合、ナレッジ検索ツールは機能しません。その場合、モデルは自身の知識を使用して応答を生成しますが、エラーは返されません。 |
課金
課金には、以下の要素が含まれます:
- モデル呼び出し料金:ナレッジベースから取得されたコンテンツがプロンプトに追加されます。これにより、モデルの入力トークン数が増加します。料金は、モデルの標準価格に基づいて請求されます。料金の詳細については、Model Studio コンソールをご参照ください。
- ツール呼び出し料金:現在、ナレッジベース機能は無料でご利用いただけます。