QnA Maker ナレッジベースからカスタム質問応答に移行する

[アーティクル]
11/21/2024

Azure AI Language の機能であるカスタム質問応答は 2021 年 5 月に導入され、ディープラーニングランカーを使用した関連性の強化、正確な回答、エンドツーエンドのリージョンサポートなど、いくつかの新機能を備えています。カスタム質問と回答プロジェクトは、QnA Maker のナレッジベースに相当します。 QnA Maker リソースのナレッジベースを言語リソース内のカスタム質問と回答プロジェクトに簡単に移行できます。また、複数の QnA Maker リソースから特定の言語リソースにナレッジベースを移行することもできます。

ナレッジベースを正常に移行するには、移行を実行するアカウントに、選択した QnA Maker および言語リソースへの共同作成者のアクセス権が必要です。ナレッジベースを移行すると、次の詳細が新しいカスタム質問と回答プロジェクトにコピーされます。

アクティブラーニングの提案を含む QnA のペア。
QnA Maker リソースからの同意語と既定の回答。
ナレッジベース名がプロジェクトの説明フィールドにコピーされます。

ロールベースのアクセス制御 (RBAC) などのリソースレベルの設定は、新しいリソースには移行されません。これらのリソースレベルの設定は、移行後に言語リソースに対して再構成する必要があります。また、言語リソースの分析を再び有効にする必要があります。

SDK を移行する手順

この SDK 移行ガイドは、以前の Microsoft.Azure.CognitiveServices.Knowledge.QnAMaker から新しいカスタム質問応答クライアントライブラリ Azure.AI.Language.QuestionAnswering への移行に役立つことを目的としています。 2 つのパッケージ間で似た操作を併記して比較することに焦点を当てます。

ナレッジベースを移行する手順

下の手順に従って、ナレッジベースを移行できます。

事前にカスタム質問と回答が有効になっている言語リソースを作成します。 Azure portal で言語リソースを作成するとき、カスタム質問応答を有効にするオプションが表示されます。そのオプションを選んで続けると、ナレッジベースの保存に関する Azure Search の詳細の指定を求められます。
複数の言語のナレッジベースを言語リソースに追加したい場合は、Language Studio にアクセスして最初のカスタム質問と回答プロジェクトを作成し、以下のように最初のオプションを選択します。言語リソースの言語設定は、プロジェクトの作成時にのみ指定できます。単一言語の既存のナレッジベースを言語リソースに移行する場合は、この手順を省略できます。
https://www.qnamaker.ai にアクセスし、ナレッジベースページの移行メモで [移行の開始] を選択します。移行を開始するためのダイアログボックスが開きます。
移行を開始するために必要な詳細情報を入力します。テナントが自動的に選択されます。テナントの切り替えを選択できます。
移行するナレッジベースを含む QnA Maker リソースを選択します。
ナレッジベースの移行先の言語リソースを選びます。カスタム質問応答が有効になっている言語リソースのみが表示されます。言語リソースの言語設定がオプションに表示されます。言語設定が指定されていない場合、QnA Maker リソースから言語リソースに複数の言語のナレッジベースを移行することはできません。

複数の言語のナレッジベースを言語リソースに移行する場合は、言語リソースの最初のカスタム質問と回答プロジェクトを作成するときに、複数の言語の設定を有効にする必要があります。これを行うには、手順 2 の指示に従ってください。 言語リソースの言語設定が指定されていない場合は、選択された QnA Maker リソースの言語が割り当てられます。
移行するすべてのナレッジベースを選んで、[次へ] を選択します。
移行する予定のナレッジベースを確認できます。プロジェクト名にいくつかの検証エラーが発生する可能性があります。これは、カスタム質問と回答プロジェクトの厳密な検証規則に従っているためです。無効な文字が原因で発生するこれらのエラーを解決するには、チェックボックス (赤) を選択し、[次へ] を選びます。これは、名前の中の問題のある文字を、受け入れ可能な文字に置き換えるワンクリックの方法です。重複がある場合は、システムによって新しい一意のプロジェクト名が生成されます。

注意事項

ターゲット言語リソースに既に存在するプロジェクトと同じ名前のナレッジベースを移行する場合、選択したナレッジベースの内容でプロジェクトの内容が上書きされます。
検証エラーを解決したら、[移行の開始] を選択します
移行が完了するまでに数分かかります。進行中の移行を取り消さないでください。移行後、Language Studio 内の移行されたプロジェクトに移動できます。

カスタム質問と回答プロジェクトへの移行に失敗したナレッジベースがある場合は、エラーが表示されます。最も一般的な移行エラーは、次の場合に発生します。
- ソースとターゲットのリソースが無効である。
- 空のナレッジベース (KB) を移行しようとしている。
- ターゲットリソースにリンクされている Azure Search インスタンスの上限に達した。
これらのエラーを解決したら、移行を再実行できます。
移行では、ナレッジベースのテストインスタンスのみがコピーされます。移行が完了したら、ナレッジベースを手動でデプロイして、テストインデックスを運用環境のインデックスにコピーする必要があります。