QnA Maker におけるナレッジ ベースのライフサイクル
QnA Maker は、モデル変更、音声例、公開、エンドポイント クエリからのデータ収集の最適な反復サイクルを学習します。
Note
QnA Maker サービスは、2025 年 3 月 31 日に廃止される予定です。 Azure AI Language の一部として、質問応答機能の新しいバージョンが提供されました。 言語サービス内の質問応答機能については、質問応答に関する記事を参照してください。 QnA Maker の新しいリソースは、2022 年 10 月 1 日以降作成できません。 既存の QnA Maker のナレッジ ベースを質問応答に移行する方法については、移行ガイドを参照してください。
QnA Maker ナレッジ ベースの作成
QnA Maker ナレッジ ベース (KB) エンドポイントでは、KB のコンテンツに基づいて、ユーザー クエリに対する最も一致する回答を提供します。 ナレッジ ベースの作成は、質問、回答、関連付けられているメタデータのコンテンツ リポジトリを設定する場合に行う 1 回限りの操作です。 KB は、次のソースなどの既存のコンテンツをクロールすることによって作成できます。
- FAQ ページ
- 製品マニュアル
- 質問と回答のペア
ナレッジ ベースの作成方法を確認してください。
ナレッジ ベースのテストと更新
編集または自動抽出を行ってナレッジ ベースにコンテンツを取り込んだら、テストすることができます。 対話型テストは、QnA Maker ポータルで [テスト] パネルを使用して実行できます。 一般的なユーザー クエリを入力します。 次に、応答の正確性と十分な信頼度スコアという両方の点について、返された応答を検証します。
- 低い信頼度スコアを修正するには: 別の質問を追加します。
- クエリから誤って既定の応答が返された場合: 正しい質問に新しい回答を追加します。
結果に満足するまで、このテストと更新の短いループが続きます。 ナレッジ ベースのテスト方法を確認してください。
大規模な KB には、generateAnswer API と、公開されているナレッジ ベースではなく test ナレッジ ベースを照会する本文のプロパティ isTest を利用して、自動化されたテストを使用します。
{
"question": "example question",
"top": 3,
"userId": "Default",
"isTest": true
}
ナレッジ ベースの公開
ナレッジ ベースのテストが完了したら、それを公開することができます。 公開時に、テスト済みのナレッジ ベースの最新バージョンが、公開済みのナレッジ ベースを表す専用の Azure AI Search インデックスにプッシュされます。 また、アプリケーションやチャット ボットで呼び出すことができるエンドポイントが作成されます。
ナレッジ ベースのテスト バージョンにその他の変更を加えても、公開操作により、公開されたバージョンは影響を受けません。 公開されたバージョンは、実稼働アプリケーションに存在する場合があります。
これらのナレッジ ベースをそれぞれ別個にテスト対象とすることができます。 API を使用して、generateAnswer 呼び出しで本文のプロパティ isTest を指定し、ナレッジ ベースのテスト バージョンを対象とすることができます。
ナレッジ ベースの公開方法を確認してください。
使用状況の監視
サービスのチャット ログを記録できるようにするには、QnA Maker サービスを作成する際に Application Insights を有効にする必要があります。
サービスの使用状況について、さまざまな分析を行うことができます。 Application Insights を使用して QnA Maker サービスを分析する方法の詳細を確認してください。
分析から学んだ内容に基づいて、適切なナレッジ ベースの更新を行います。
ナレッジ ベースのデータのバージョン管理
データのバージョン管理は、QnA Maker ポータルの [設定] ページのインポートおよびエクスポート機能を使用して利用できます。
ナレッジ ベースをバックアップするには、ナレッジ ベースを .tsv または .xls 形式でエクスポートします。 エクスポートしたら、通常のソース管理チェックの一部としてこのファイルを含めます。
特定のバージョンに戻る必要がある場合は、自分のローカル システムからそのファイルをインポートする必要があります。 エクスポートされたナレッジベースは、常に[設定] ページのインポートを介して使用する必要があります。 ファイルまたは URL ドキュメントのデータ ソースとして使用することはできません。 これにより、ナレッジ ベース内の現在の質問と回答が、インポートされたファイルの内容に置き換えられます。
テストと運用環境のナレッジ ベース
ナレッジ ベースは質問と回答セットのリポジトリであり、その作成、管理、および使用は QnA Maker を通して行われます。 各 QnA Maker リソースには、複数のナレッジ ベースを保持できます。
ナレッジ ベースには、"テスト" と "公開" という 2 つの状態があります。
テスト ナレッジ ベース
"テスト ナレッジ ベース" は、現在編集され、保存されているバージョンです。 テスト バージョンは、精度および応答の完全性について、テストが実施されています。 テスト ナレッジ ベースに加えられた変更は、アプリケーションまたはチャット ボットのエンド ユーザーに影響しません。 テスト ナレッジ ベースは HTTP 要求では test になります。 test のナレッジは、QnA Maker のポータルの対話型 [テスト] ペインで使用できます。
運用環境のナレッジ ベース
"公開ナレッジ ベース" は、チャット ボットまたはアプリケーションで使用されるバージョンです。 ナレッジ ベースを公開すると、そのテスト バージョンの内容が、公開されたバージョンになります。 公開ナレッジ ベースは、エンドポイントを介してアプリケーションによって使用されるバージョンです。 コンテンツが正しく、適切にテストされていることを確認します。 公開ナレッジ ベースは HTTP 要求では prod になります。