エクスポート/インポートを使用したナレッジ ベースの移動

  • [アーティクル]

次のようなケースでは、ナレッジ ベースのコピーを作成するとよいかもしれません。

  • QnA Maker GA からカスタム質問と回答にナレッジ ベースをコピーする
  • バックアップと復元のプロセスを導入する
  • CI/CD パイプラインと統合する
  • データを別のリージョンに移動する

Note

QnA Maker サービスは、2025 年 3 月 31 日に廃止される予定です。 Azure AI Language の一部として、質問応答機能の新しいバージョンが提供されました。 言語サービス内の質問応答機能については、質問応答に関する記事を参照してください。 QnA Maker の新しいリソースは、2022 年 10 月 1 日以降作成できません。 既存の QnA Maker のナレッジ ベースを質問応答に移行する方法については、移行ガイドを参照してください。

前提条件

  • Azure サブスクリプションをお持ちでない場合は、開始する前に無料アカウントを作成してください。
  • Azure portal で作成された QnA Maker リソース。 リソースを作成したときに選んだ Microsoft Entra ID、サブスクリプション、QnA リソース名を覚えておいてください。
  • 新しい QnA Maker サービスをセットアップします

ナレッジ ベースをエクスポートする

  1. QnA Maker ポータルにサインインします。

  2. 移動するナレッジ ベースを選択します。

  3. QnA、同意語、ナレッジ ベース レプリカをエクスポートするためのオプションが [設定] ページにあります。 データは .tsv または .xlsx でダウンロードするように選択できます。

    1. [QnAs](QnA) : QnA をエクスポートすると、QnA ペア (質問、回答、メタデータ、フォローアップ プロンプト、データ ソース名を含む) がすべてダウンロードされます。 質問と回答と共にエクスポートされた QnA ID は、update API を使用して特定の QnA ペアを更新するために使用できます。 特定の QnA ペアの QnA ID は、複数のエクスポート操作で変更されることはありません。
    2. [Synonyms](同意語) : ナレッジ ベースに追加された同意語をエクスポートできます。
    3. [Knowledge Base Replica](ナレッジ ベース レプリカ) : 同意語やその他の設定を含むナレッジ ベース全体をダウンロードしたい場合は、このオプションを選択してください。

ナレッジ ベースをインポートする

  1. qnamaker.ai ポータルのトップ メニューから [ナレッジ ベースの作成] を選択し、URL もファイルも追加せずに 空の ナレッジ ベースを作成します。 新しいナレッジ ベースに任意の名前を設定し、[Create your KB](KB の作成) をクリックします。

  2. この新しいナレッジ ベースで [設定] タブを開き、[ナレッジ ベースのインポート] で、[QnA]、[シノニム]、[ナレッジ ベース レプリカ] の各オプションからいずれかを選択します。

    1. [QnAs](QnA) : QnA ペアがすべてインポートされます。 新しいナレッジ ベースで作成された QnA ペアは、エクスポートされたファイルに存在するものと同じ QnA ID を持つ必要があります。 QnA をインポートするには、SampleQnAs.xlsx、SampleQnAs.tsv を参照してください。

    2. [Synonyms](同意語) : このオプションを使用して、ナレッジ ベースに同意語をインポートすることができます。 同意語をインポートするには、SampleSynonyms.xlsx、SampleSynonyms.tsv を参照してください。

    3. [Knowledge Base Replica](ナレッジ ベース レプリカ) : このオプションを使用すると、QnA、同意語、設定を含む KB レプリカをインポートできます。 詳細については、KBReplicaSampleExcel、KBReplicaSampleTSV を参照してください。 非構造化コンテンツもレプリカに追加したい場合は、CustomQnAKBReplicaSample を参照してください。

      レプリカをインポートする際、QnA と非構造化コンテンツのどちらかは必須となります。 非構造化ドキュメントは、カスタム質問と回答でのみ有効です。 レプリカをインポートするにあたり、同意語ファイルは必須ではありません。 レプリカをインポートするにあたり、設定ファイルは必須です。

      設定 QnA Maker KB へのインポート時に更新が許可されているか? カスタム質問と回答 KB へのインポート時に更新が許可されているか?
      DefaultAnswerForKB いいえ はい
      EnableActiveLearning (True/False) はい いいえ
      EnableMultiTurnExtraction (True/False) はい はい
      DefaultAnswerforMultiturn はい はい
      言語 いいえ いいえ

  3. テスト パネルを使用して、新しいナレッジ ベースをテストします。 ナレッジ ベースのテスト方法を確認してください。

  4. ナレッジ ベースを公開し、チャットボットを作成します。 ナレッジ ベースの公開方法を確認してください。

    Migrate knowledge base

プログラムで QnA Maker からナレッジ ベースをエクスポートする

次の REST API を使用して、プログラムでエクスポート/インポート プロセスを利用できます。

エクスポート

[インポート]

チャット ログ

チャット ログをエクスポートすることはできません。新しいナレッジ ベースでは Application Insights を使ってチャット ログが格納されているためです。

次のステップ

ナレッジ ベースを編集する