大規模言語モデル (LLM) はプライベートな知識に欠けており、その一般的な知識は古い可能性があります。業界では一般的に、ユーザーの入力に基づいて外部ソースから関連情報を取得するために、取得拡張生成 (RAG) 技術が使用されています。この取得されたコンテンツは、ユーザーのクエリと組み合わされて LLM に提供され、より正確な回答を生成します。Model Studio の RAG 機能であるナレッジベース機能は、プライベートな知識を効果的に補完し、最新の情報を提供します。
コンソールの制限: 2025 年 4 月 21 日より前にアプリケーションを作成した国際版ユーザーのみが、次の図に示すように [アプリケーション開発] タブにアクセスできます。
このタブには、アプリケーション (エージェントアプリケーションおよびワークフローアプリケーション)、コンポーネント (プロンプトエンジニアリングおよびプラグイン)、およびデータ (ナレッジベースおよびアプリケーションデータ) の機能が含まれています。これらはすべてプレビュー機能です。本番環境では注意して使用してください。

API 呼び出しの制限: 2025 年 4 月 21 日より前にアプリケーションを作成した国際版ユーザーのみが、アプリケーションデータ、ナレッジベース、およびプロンプトエンジニアリング API を呼び出すことができます。
専用ナレッジベースのないアプリケーション 専用のナレッジベースがないと、LLM は特定のドメインに関する質問に正確に回答できません。
| 専用ナレッジベースのあるアプリケーション 専用のナレッジベースを使用すると、LLM は特定のドメインに関する質問に正確に回答できます。
|
モデルの可用性
ナレッジベースは、以下のモデルで使用できます。Qwen ナレッジベースの設定
Qwen-Max/Plus/Turbo
QwenVL-Max/Plus
Qwen (Qwen2.5 など)
上記のリストは随時更新される可能性があります。最新のリストについては、アプリケーション作成時に [マイアプリケーション] ページで利用可能なモデルをご参照ください。
開始方法
このセクションでは、コードを一切記述せずに、特定のドメイン (この場合は架空の「Bailian phone」) に関する質問に回答できる LLM Q&A アプリケーションを構築する方法について説明します。
1. ナレッジベースの構築
ナレッジベース ページに移動し、[ナレッジベースの作成] をクリックします。[名前] を入力し、他の設定はデフォルト値のままにして、[次のステップ] をクリックします。
[デフォルトカテゴリ] を選択し、Bailian Phones Specifications.docx ファイルをアップロードします。[次のステップ] をクリックし、次に [インポート] をクリックします。
2. ビジネスアプリケーションとの統合
ナレッジベースを作成した後、それを特定のアプリケーション (ナレッジベースと同じワークスペースにある必要があります) または外部アプリケーションに関連付けて、取得リクエストを処理できます。
エージェントアプリケーションとの統合
[マイアプリケーション] ページに移動し、ターゲットのエージェントアプリケーションを見つけて、そのカードの [構成] をクリックします。次に、アプリケーションのモデルを選択します。

[ドキュメント] の右側にある [+] ボタンをクリックして、前のステップで作成したナレッジベースを追加します。類似度のしきい値と重みはデフォルト値のままにすることができます。
右側の入力ボックスで質問をします。LLM は、作成したナレッジベースを使用して回答を生成します。
例: 「3,000 元未満で写真撮影に最適な Bailian phone を選ぶのを手伝ってください。」
ワークフローアプリケーションとの統合
[マイアプリケーション] ページに移動し、ターゲットのワークフローアプリケーションを見つけて、そのカードの [構成] をクリックします。次に、[ナレッジベース] ノードをキャンバスにドラッグし、[開始] ノードの後に接続します。
ナレッジベースノードを構成します:
入力: 変数名
contentの右側にある [値] ドロップダウンリストで、 を選択します。ナレッジベースの選択: 前のステップで作成したナレッジベースを選択します。
[topK] の設定 (オプション): これは、子孫ノード (通常は LLM ノード) に返されるナレッジセグメントの数を決定します。
この値を増やすと、通常、LLM の回答の精度が向上しますが、LLM が消費する入力トークンの数も増加します。
[LLM] ノードをキャンバスにドラッグし、ナレッジベースノードの後、[終了] ノードの前に接続します。
LLM ノードを構成します:
[モデル設定] リストで、ノードのモデルを選択します。
[プロンプト] フィールドに、LLM にナレッジベースを使用するように指示するプロンプトを入力します。/ を入力して
result変数を挿入する必要があります。これは、ナレッジベースの取得によって返された結果を表します。
終了ノードを構成します:
/を入力し、 を選択して、LLM によって返された結果を出力します。ページの右上隅にある [テスト] をクリックします。次に、右側の入力ボックスで質問をします。LLM は、作成したナレッジベースを使用して回答を生成します。
例: 「3,000 元未満で写真撮影に最適な Bailian phone を選ぶのを手伝ってください。」
外部アプリケーションとの統合
Model Studio でアプリケーションを構築するだけでなく、独立した RAG サービスとしてナレッジベースの取得機能を使用することもできます。GenAI Service Platform SDK を使用すると、このサービスを外部の AI アプリケーションに迅速に統合できます。
詳細な統合手順については、「ナレッジベース API ガイド」をご参照ください。
3. ナレッジベースの最適化 (オプション)
ナレッジの取得が不完全であったり、Q&A プロセス中にコンテンツが不正確であったりする場合は、「ナレッジベースのパフォーマンスを最適化する」をご参照ください。
ユーザーガイド
[ナレッジベース] ページでは、現在のワークスペース内のすべてのナレッジベースを表示および管理できます。
ナレッジベース ID: 各ナレッジベースカードの ID フィールドの値。API 呼び出しやその他のシナリオで使用されます。ナレッジベースの作成
[ナレッジベース] ページで、[ナレッジベースの作成] をクリックします。
アプリケーションシナリオに基づいて、適切な [ナレッジベースタイプ] を選択します。1 つのナレッジベースでサポートできるタイプは 1 つだけです。作成後にナレッジベースタイプを変更することはできません。
ドキュメント検索 (取得シナリオ用)
シナリオ:
このタイプは、社内ドキュメントや製品マニュアルなど、非構造化データ (事前に定義されたテーブルスキーマで整理されていないデータで、テキスト、テーブル、画像を含む) の取得に適しています。
ファイルに画像が含まれており、アプリケーションが回答でそれらを返す必要がある場合は、[ドキュメント検索] を選択します。
データソースの統合: ローカルファイルをアップロードするか、Alibaba Cloud Object Storage Service (OSS) からインポートできます。
データクエリ (チャットボットまたは NL2SQL シナリオ用)
シナリオ:
このタイプは、FAQ、製品データ、人事情報クエリアシスタントなど、構造化データ (事前に定義されたテーブルスキーマで整理されたデータ) に基づく Q&A システムの構築に適しています。
データが完全な FAQ Q&A ペアで構成されている場合は、[データクエリ] を選択します。たとえば、
質問と回答の 2 つの列を含む Excel ファイルがある場合、データクエリナレッジベースでは、質問列からのみ情報を取得し、回答列のコンテンツのみを LLM の応答の参照として使用できます。ドキュメント検索ナレッジベースでは、この効果を簡単に実現することはできません。
完全に同一のテーブルスキーマを持つ複数の Excel ファイルをインポートできます。
データソースの統合: ローカルの XLS または XLSX ファイルをアップロードできます。
画像 Q&A (画像による検索シナリオ用)
シナリオ:
このタイプは、製品ショッピングガイドや画像 Q&A アシスタントなど、画像による検索や画像とテキストによる検索などのマルチモーダル検索アプリケーションの構築に適しています。
データソース: ローカルの XLS または XLSX ファイルをアップロードできます。
XLS および XLSX ファイルには、画像インデックスを構築するために一般公開されている画像 URL が含まれている必要があります。詳細については、以下の作成手順を参照してください。
ピーク時には、データ量によっては作成プロセス全体に数時間かかる場合があります。しばらくお待ちください。
ナレッジベースの更新
ナレッジベースのコンテンツへの変更は、それを参照するすべてのアプリケーションとリアルタイムで同期されます。
ドキュメント検索ナレッジベース
自動更新 (推奨)
これは、OSS、FC、および Model Studio ナレッジベースの API を統合することで実現できます。次の簡単な手順に従ってください:
バケットの作成: OSS コンソールに移動し、元のファイルを保存するための OSS バケットを作成します。
ナレッジベースの作成: プライベートナレッジコンテンツを保存するための非構造化ナレッジベースを作成します。
ユーザー定義関数の作成: FC コンソールに移動し、ファイルの作成や削除などのファイル変更イベントの関数を作成します。詳細については、「関数の作成」をご参照ください。これらの関数は、ナレッジベース API ガイドから関連する API を呼び出すことで、OSS のファイルの変更を作成されたナレッジベースに同期します。
OSS トリガーの作成: FC で、前のステップで作成したユーザー定義関数に OSS トリガーを関連付けます。ファイル変更イベントが検出されると (たとえば、新しいファイルが OSS にアップロードされた場合)、対応するトリガーがアクティブになり、FC が対応する関数を実行するようにトリガーします。
手動更新
[ナレッジベース] ページで、ターゲットのナレッジベースを見つけ、そのカードの [詳細の表示] をクリックします。
新しいファイルの追加方法: [データのアップロード] をクリックし、アプリケーションデータ内の既存のファイルを選択します。詳細については、「アプリケーションデータにファイルをアップロードする方法」をご参照ください。
ファイルの削除方法: ターゲットファイルを見つけ、その右側にある [削除] をクリックします。
この操作は、ナレッジベースからファイルを削除するだけで、[アプリケーションデータ] のソースファイルは削除されません。
ファイルコンテンツの変更方法: インプレース更新とファイルアップロードの上書きはサポートされていません。まず、ナレッジベースから古いバージョンのファイルを削除し、次に新しい変更されたバージョンを再インポートする必要があります。
注意: 古いバージョンのファイルを保持すると、古いコンテンツが取得されてリコールされる可能性があります。
データクエリおよび画像 Q&A ナレッジベース
自動更新
サポートされていません。
手動更新
ナレッジベースのデータソースがアプリケーションデータのデータテーブルである場合、手動でのみ更新できます。プロセスには 2 つのステップが含まれます。
ステップ 1: データテーブルの更新
[アプリケーションデータ] タブに移動します。左側のリストで、ターゲットのデータテーブルを選択し、[データのインポート] をクリックします。
新しいデータの挿入方法: インポートタイプを [増分アップロード] に設定します。テーブルヘッダーと新しいデータ行のみを含む Excel ファイルをアップロードする必要があります。
ファイルのヘッダーは現在のテーブルスキーマと一致する必要があります。ページの [テンプレートのダウンロード] 機能を使用して標準のヘッダーファイルを取得し、新しいデータを直接入力できます。
データの削除方法: インポートタイプを [アップロードして上書き] に設定します。ヘッダーと最新の完全なデータ (削除するレコードを削除したもの) を含む Excel ファイルをアップロードする必要があります。
完全なデータの取得方法: ページの
アイコンをクリックして、データを XLSX 形式でダウンロードします。データの変更方法: インポートタイプを [アップロードして上書き] に設定します。ヘッダーと最新の完全なデータ (対応する変更を含む) を含む Excel ファイルをアップロードする必要があります。
ステップ 2: 変更をナレッジベースに同期する
[ナレッジベース] リストに戻り、ターゲットのナレッジベースを見つけ、そのカードの [詳細の表示] をクリックします。データテーブルの左上にある
アイコンをクリックします。操作を確認すると、データテーブルの最新のコンテンツがナレッジベースに同期されます。その後の更新後も、上記の手順を手動で繰り返す必要があります。データソースとして「アプリケーションデータ」を使用するナレッジベースでは、データの変更を自動的に同期することはできません。
ナレッジベースの編集
ナレッジベースを作成した後、変更できるのはナレッジベース名、ナレッジベースの説明、類似度のしきい値のみです。その他の構成は変更できません。API を使用したナレッジベースの編集はサポートされていません。
プロシージャ: [ナレッジベース] ページで、ターゲットのナレッジベースを見つけ、そのカードの
アイコンをクリックし、[編集] をクリックします。
ナレッジベースの削除
この操作では、[アプリケーションデータ] のソースファイルやデータテーブルは削除されません。
この操作は元に戻せません。慎重に進めてください。
ナレッジベースを削除する前に、まずすべての公開済みアプリケーションから関連付けを解除する必要があります。
関連付けられている未公開のアプリケーションは、削除操作をブロックしません。
ヒットテスト
ナレッジベースを構築したものの、実際の使用で AI アプリケーションがしばしば無関係な回答を提供したり、ナレッジベースに存在する情報を見つけられなかったりすることがあるとします。ヒットテストは、これらの問題を事前に特定して解決するのに役立つ重要なツールです。
ヒットテストを使用すると、次のことができます:
ナレッジベースが AI アプリケーションに効果的なナレッジ入力を提供できるかどうかを確認します。
類似度のしきい値を微調整して、取得率と精度のバランスを取ります。
ナレッジベースのコンテンツのギャップや品質の問題を発見します。
シナリオ例
シナリオ 1: 顧客が製品価格について問い合わせる
テスト入力: 「Bailian phone の価格はいくらですか?」 期待される結果: 価格情報を含む関連テキストセグメントを取得できる必要があります。シナリオ 2: 技術的な問題のトラブルシューティング
テスト入力: 「デバイスが WiFi に接続できない場合はどうすればよいですか?」 期待される結果: WiFi 接続のトラブルシューティングに関する関連テキストセグメントを取得できる必要があります。
プロシージャ
[ナレッジベース] ページで、ターゲットのナレッジベースを見つけ、そのカードの [ヒットテスト] をクリックします。
テストインターフェイスに質問を入力し (事前にユーザーからよく寄せられる質問を収集することをお勧めします)、取得結果を観察します。
取得結果: このテストキーワードのヒット結果 (類似度の降順でソート)。任意のセグメントをクリックして、その特定のコンテンツを表示します。
アイコン: 画像 Q&A ナレッジベースの場合、システムはまず入力画像をベクトルに変換し、関連するレコードを取得します。次に、これらのレコードを質問とともに LLM に送信して回答を生成します。ドキュメント検索またはデータクエリナレッジベースの場合、アップロードされた画像は取得に参加しません。
関連するテキストセグメントが正しく取得されているかどうかを確認します。そうでない場合は、類似度のしきい値を調整し、前の手順を繰り返す必要があります。
[履歴取得レコードの表示] をクリックして、過去のさまざまな閾値設定での取得パフォーマンスを比較します。
クォータと制限
ナレッジベースでサポートされているデータソースと容量については、「ナレッジベースのクォータと制限」をご参照ください。
各アプリケーションは、最大 5 つのドキュメント検索ナレッジベース、5 つのデータクエリナレッジベース、および 1 つの画像 Q&A ナレッジベースに関連付けることができます。
課金
ナレッジベース機能は無料ですが、ナレッジベースを参照するアプリケーションを呼び出すと料金が発生する場合があります。
ステップ | 課金情報 | |
無料。 | ||
アプリケーションを呼び出すと、ナレッジベースから取得されたテキストセグメントによって LLM の入力トークン数が増加します。これにより、モデル推論 (呼び出し) コストが増加する可能性があります。モデル推論 (呼び出し) コストの詳細については、「課金項目」をご参照ください。 注意: 取得 API を呼び出して指定されたナレッジベースからのみ取得し、生成にアプリケーションを使用しない場合、料金は発生しません。 | ||
無料。 | ||
API リファレンス
ナレッジベース API の最新の完全なリストとその入出力パラメーターについては、「API リファレンス (ナレッジベース)」をご参照ください。
関連 API の具体的な使用方法とコード例については、「ナレッジベース API ガイド」をご参照ください。

















