QnA Maker のトラブルシューティング

  • [アーティクル]

QnA Maker サービスについてきわめて多く寄せられる質問を精選した一覧です。サービスの採用にかかる期間を短縮し、成果を上げるためにお役立てください。

Note

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

予測を管理する

クエリ予測のスループット パフォーマンスを向上させるにはどうすればよいですか。

回答: スループットのパフォーマンスの問題は、App Service と Cognitive Search の両方をスケールアップする必要があることを示しています。 パフォーマンスを向上させるには、Cognitive Search にレプリカを追加することを検討してください。

価格レベルの詳細についてはこちらをご覧ください。

QnA Maker サービス エンドポイントを取得する方法

回答: QnA Maker サービス エンドポイントは、デバッグ目的で QnA Maker サポートや UserVoice に問い合わせる場合に役立ちます。 エンドポイントは、次の形式の URL です: https://your-resource-name.azurewebsites.net。

  1. Azure portal で QnA Maker サービス (リソース グループ) に移動します。

    QnAMaker Azure resource group in Azure portal

  2. QnA Maker リソースに関連付けられている App Service を選択します。 通常、名前は同じです。

    Select QnAMaker App Service

  3. エンドポイントの URL は [概要] セクションで確認できます。

    QnAMaker endpoint

ナレッジ ベースの管理

自分の QnA Maker の一部を誤って削除しました。どうしたらいいでしょうか。

回答: Search や Web App など、QnA Maker リソースと一緒に作成される Azure サービスは削除しないでください。 QnA Maker が正常に機能するために必要であり、削除すると QnA Maker が正しく動作しなくなります。

質問と回答のペア、ファイル、URL、カスタムの質問と回答、ナレッジ ベース、Azure リソースを含め、削除はすべて永続的です。 ナレッジ ベースの一部を削除する前に、 [設定] ページから確実にナレッジ ベースをエクスポートしてください。

指定した URL/ファイルから質問とその回答のペアが抽出されません。なぜでしょうか。

回答: QnA Maker は、有効な FAQ URL であっても、一部の Q&A (QnA) コンテンツを自動抽出できない場合があります。 そのような場合は、QnA コンテンツを .txt ファイルに貼り付けて、ツールによる取り込みが可能かどうかを確認できます。 または、QnA Maker ポータル経由でナレッジ ベースに編集という形でコンテンツを追加することもできます。

作成できるナレッジ ベースの最大サイズはどれくらいですか。

回答: ナレッジ ベースのサイズは、QnA Maker サービスの作成時に選択した Azure Search の SKU により異なります。 詳細については、こちらを参照してください。

新しいナレッジ ベースを作成しようとしたときに、ドロップダウンに選択肢が表示されません。なぜでしょうか。

回答: まだ Azure に QnA Maker サービスが作成されていません。 その方法については、こちらを参照してください。

複数人でナレッジ ベースを共有する方法は。

回答: 共有は、QnA Maker サービス レベルで行われます。つまり、サービス内のすべてのナレッジ ベースが共有されます。 ナレッジ ベースの共同作業の方法については、こちらを参照してください。

ナレッジ ベースを変更するために、同じ AAD テナントに含まれない共同作成者とナレッジ ベースを共有できますか。

回答: 共有は Azure ロールベースのアクセス制御 (RBAC) に基づきます。 Azure で他のユーザーと 任意の リソースを共有できる場合、QnA Maker を共有することもできます。

5 つの QnAMaker ナレッジ ベースがある 1 つの App Service プランがある場合、5 人のユーザーに、それぞれが 1 つの QnAMaker ナレッジ ベースのみにアクセスできるように、読み取り/書き込み権限を割り当てることができますか。

回答: 個々のナレッジ ベースではなく、QnAMaker サービス全体を共有できます。

適切なメッセージが見つからなかったときに、既定のメッセージを変更するにはどうすればよいですか。

回答: 既定のメッセージは、App Service の設定に含まれています。

  • Azure portal の App Service リソースに移動します

qnamaker appservice

  • [設定] オプションを選びます。

qnamaker appservice settings

  • [DefaultAnswer] という設定の値を変更します。
  • App Service を再起動します。

qnamaker appservice restart

SharePoint リンクが抽出されません。なぜでしょうか。

回答: 詳細については、「Data source locations (データ ソースの場所)」を参照してください。

ナレッジ ベースに対して行った更新が発行時に反映されません。なぜですか。

回答: 編集内容を公開するには、テーブルの更新、テスト、設定のいずれであってもすべて保存する必要があります。 編集操作後は、必ず [保存してトレーニング] ボタンを選んでください。

ナレッジ ベースは、リッチ データやマルチメディアに対応していますか。

回答:

ファイルと URL のマルチメディア自動抽出

  • URL - HTML から Markdown への変換機能は制限されています。
  • ファイル - サポートされていません

マークダウンの回答テキスト

QnA ペアをナレッジ ベースに追加すると、回答のマークダウン テキストを編集して、パブリック URL から使用できるメディアへのリンクを含めることができます。

QnA Maker では英語以外の言語もサポートされますか。

回答: 詳細については、サポートされている言語に関するページを参照してください。

多言語コンテンツが含まれる場合は、言語ごとにサービスを作成してください。

サービスの管理

いつアプリ サービスを再起動するべきですか。

回答: [ユーザー設定] ページの [エンドポイント キー] テーブルで、ナレッジ ベースのバージョン値の隣に注意のアイコンが表示されているときは、アプリ サービスを更新してください。

既存の Search Service を削除してしまいました。どうしたらよいですか。

回答: Azure AI Search インデックスを削除した場合、この操作は最終的なものであり、インデックスを復旧することはできません。

自分の Search Service で `testkb` インデックスを削除しました。どのように修正すればよいですか。

回答: Search Service で testkb インデックスを削除した場合は、最後に発行されたナレッジ ベースのデータを復元できます。 GitHub で提供されている回復ツールの Restoretestkbindex を使用してください。

次のエラーが発生しました: QnA Maker App Service の CORS 設定で https://www.qnamaker.ai が許可されているかどうか、または組織固有のネットワーク制限があるかどうかを確認してください。これを解決するにはどうすればよいですか。

回答: [App Service] ペインの [API] セクションで、CORS 設定を * または "https://www.qnamaker.ai"" に更新します。 それでも問題が解決しない場合は、組織固有の制限を確認してください。

エンドポイント キーは、いつ更新すべきでしょうか。

回答: エンドポイント キーの更新は、鍵漏えいのおそれがある場合に行ってください。

複数の言語を使用したナレッジ ベースに同じ Azure AI Search リソースを使用できますか。

回答: 複数の言語と複数のナレッジ ベースを使用するには、言語ごとに QnA Maker リソースを作成する必要があります。 これにより、言語ごとに個別の Azure Search サービスが作成されます。 1 つの Azure Search サービスに異なる言語のナレッジ ベースを混在させると、結果の関連性が低下します。

QnA Maker で使用される Azure AI Search リソースの名前を変更するには、どうすればよいですか。

回答: Azure AI Search リソースの名前は、QnA Maker リソース名の後にいくつかのランダムな文字が追加されたものです。 そのため、QnA Maker の複数の Search リソースを識別することが難しくなります。 別の検索サービスを作成し (任意の方法で名前を付け)、それを QnA サービスに接続します。 手順は、Azure Search をアップグレードするために必要な手順と同様です。

QnA Maker により「ランタイム コアが初期化されていません」が返される場合、どのように修正すればよいですか。

回答: App Service のディスク領域がいっぱいになっている可能性があります。 ディスク領域を修正する手順は次のとおりです。

  1. Azure portal で、QnA Maker の App Service を選択し、サービスを停止します。

  2. この App Service で、 [開発ツール] 、 [高度なツール] 、 [移動] の順に選択します。 これで新しいブラウザー ウィンドウが開きます。

  3. [デバッグ コンソール] 、 [CMD] の順に選択してコマンドライン ツールを開きます。

  4. site/wwwroot/Data/QnAMaker/ ディレクトリに移動します。

  5. 名前が rd で始まるフォルダーをすべて削除します。

    次の項目は削除しないでください。

    • KbIdToRankerMappings.txt ファイル
    • EndpointSettings.json ファイル
    • EndpointKeys フォルダー

  6. App Service を開始します。

  7. ナレッジ ベースにアクセスして動作していることを確認します。

Application Insights が機能しないのはなぜですか。

回答: 問題を解決するには、次の手順を照合確認して更新してください。

  1. App Service -> [設定] グループ -> [構成] セクション -> [アプリケーション設定] >で、[名前] の "UserAppInsightsKey" パラメーターが適切に構成され、それぞれの Application Insights の [概要] タブ ("インストルメンテーション キー") Guid に設定されています。

  2. App Service -> [設定] グループ -> [Application Insights] セクション>で、Application Insights が有効になっていて、それぞれの Application Insights リソースに接続されていることを確認します。

Application Insights が有効になっていますが、正常に動作していないのはなぜですか。

回答: 次の手順に従ってください。

  1. '"APPINSIGHTS_INSTRUMENTATIONKEY" name' の値を 'UserAppInsightsKey' name にコピーします。既に値が存在する場合は、オーバーライドします。

  2. 'UserAppInsightsKey' キーがアプリの設定に存在しない場合は、その名前の新しいキーを追加し、値をコピーします。

  3. 保存すると、App Service が自動的に再起動します。 これで問題が解決します。

ボットなどの他のサービスとの統合

QnA Maker を利用するには Bot Framework を使う必要がありますか。

回答: いいえ。QnA Maker に関して Bot Framework を使用する必要はありません。 ただし、QnA Maker は Azure AI Bot Service に用意されているいくつかのテンプレートの 1 つとして提供されています。 Bot Service では、Microsoft Bot Framework を使用してインテリジェントなボットを迅速に開発し、サーバーレス環境で実行することができます。

QnA Maker で新しいボットを作成するにはどうすればよいですか。

回答: Azure AI Bot Service でボットを作成するには、こちらのドキュメントの手順に従ってください。

既存の Azure AI Bot Service で別のナレッジ ベースを使用するにはどうすればよいですか?

回答: 次のナレッジ ベースに関する情報が必要です。

  • ナレッジ ベース ID。
  • ナレッジ ベースの公開されたエンドポイント カスタム サブドメイン名 (host と呼ばれます)。公開後に [設定] ページで見つかります。
  • ナレッジ ベースの公開されたエンドポイント キー - 公開後に [設定] ページで見つかります。

この情報を使用して、Azure portal でご利用のボットのアプリ サービスにアクセスします。 [設定] -> [構成] -> [アプリケーション設定] で、これらの値を変更します。

ナレッジ ベースのエンドポイント キーは、ABS サービスで QnAAuthkey としてラベルが付けられます。

2 つ以上のクライアント アプリケーションでナレッジ ベースを共有できますか。

回答: はい。ナレッジ ベースには、任意の数のクライアントからクエリを実行できます。 ナレッジ ベースからの応答が低速であるか、タイムアウトになっている場合は、ナレッジ ベースに関連付けられているアプリ サービスのサービス レベルをアップグレードすることを検討してください。

QnA Maker サービスを Web サイトに埋め込むにはどうすればよいですか。

回答: Web サイトに QnA Maker サービスを Web チャット コントロールとして埋め込むには、次の手順に従ってください。

  1. こちらの手順に従って、FAQ ボットを作成します。
  2. こちらの手順に従って、Web チャットを有効にします。

データ ストレージ

どのようなデータが、どこに保存されますか。

回答:

QnA Maker サービスを作成するときに、Azure リージョンを選択しました。 ナレッジ ベースとログ ファイルが、このリージョンに格納されます。