データ ソースからのインポート
ナレッジ ベースは、パブリック URL とファイルで取り込まれる質問と回答のペアで構成されます。
Note
QnA Maker サービスは、2025 年 3 月 31 日に廃止される予定です。 Azure AI Language の一部として、質問応答機能の新しいバージョンが提供されました。 言語サービス内の質問応答機能については、質問応答に関する記事を参照してください。 QnA Maker の新しいリソースは、2022 年 10 月 1 日以降作成できません。 既存の QnA Maker のナレッジ ベースを質問応答に移行する方法については、移行ガイドを参照してください。
データ ソースの場所
コンテンツは、データ ソースからナレッジ ベースに取り込まれます。 データ ソースの場所は、認証を必要としないパブリック URL またはファイルです。
認証で保護された SharePoint ファイルは例外です。 SharePoint リソースは、Web ページではなく、ファイルになっている必要があります。
QnA Maker では、認証で保護されていない .ASPX Web 拡張子で終わるパブリック URL がサポートされています。
おしゃべりコンテンツ
おしゃべりコンテンツ セットは、いくつかの言語と会話スタイルで、完全なコンテンツ データ ソースとして提供されています。 これを使ってボットのパーソナリティの作成を始めることができ、それにより最初から作成するよりもコストと時間が節約されます。 ナレッジ ベースにおしゃべりコンテンツを追加する方法を確認してください。
インポートでの構造化データ形式
ナレッジ ベースをインポートすると、既にあるナレッジ ベースの内容が置き換えられます。 インポートには、質問と回答を含む構造化された .tsv ファイルが必要です。 この情報によって、QnA Maker は質問とその回答のペアをグループ化し、その帰属先となるデータ ソースを特定することができます。
| Question | Answer | source | メタデータ (1 つのキー: 1 つの値) |
|---|---|---|---|
| 質問 1 | 回答 1 | URL 1 | Key1:Value1 | Key2:Value2 |
| 質問 2 | 回答 2 | 編集 | Key:Value |
インポートによる構造化された複数ターン形式
マルチターン会話は、.tsv ファイル形式で作成できます。 この形式を使うと、(QnA Maker を使用せずに他のプロセスを使用して) 以前のチャット ログを分析して複数ターンの会話を作成してから、自動化によって .tsv ファイルを作成することができます。 ファイルをインポートし、既存のナレッジ ベースを置き換えます。
複数ターンに固有の複数ターンの .tsv の列は Prompts です。 Excel に表示される例 .tsv は、複数ターンの子を定義するために含める情報を示しています。
[
{"displayOrder":0,"qnaId":2,"displayText":"Level 2 Question A"},
{"displayOrder":0,"qnaId":3,"displayText":"Level 2 - Question B"}
]
displayOrder は数値であり、displayText はマークダウンを含まないテキストです。
例としてエクスポートする
.tsv ファイルで QnA ペアを表す方法が不明な場合:
- この GitHub からダウンロードできるサンプルを使用します
- または、QnA Maker ポータルでペアを作成し、保存してから、ペアを表す方法の例としてナレッジ ベースをエクスポートします。
非構造化データ形式
ファイルを介してインポートされた非構造化コンテンツに基づいてナレッジ ベースを作成することもできます。 現在、この機能は、サポートされている任意のファイル形式のドキュメントをアップロードすることによってのみ使用できます。
重要
ファイルの形で非構造化コンテンツをアップロードする機能は、質問と回答でのみ使用できます
ナレッジ ベースに追加できるドキュメントのコンテンツの種類
コンテンツの種類には、PDF、DOC、TXT など、多くの標準的な構造化ドキュメントが含まれています。
ファイルと URL のデータの種類
次の表は、QnA Maker でサポートされているコンテンツの種類とファイル形式をまとめたものです。
| ソースの種類 | コンテンツの種類 | 例 |
|---|---|---|
| URL | FAQ (基本、セクション付き、またはトピックのホーム ページ付き) サポート ページ (単一ページのハウツー記事や、トラブルシューティングの記事など) |
基本的な FAQ、 リンク付きの FAQ、 トピック ホーム ページ付きの FAQ サポート記事 |
| PDF / DOC | FAQ、 製品マニュアル、 パンフレット、 論文、 チラシ ポリシー、 サポート ガイド、 構造化 QnA、 など |
マルチターンなし Structured QnA.docx、 Sample Product Manual.pdf、 Sample semi-structured.docx、 Sample white paper.pdf、 Unstructured blog.pdf, Unstructured white paper.pdf マルチターン： Surface Pro (docx) Contoso Benefits (docx) Contoso Benefits (pdf) |
| *Excel | 構造化 QnA ファイル (RTF、HTML サポートなど) |
マルチターンなし: Sample QnA FAQ.xls マルチターン： 構造化された簡単な FAQ.xls Surface ノート PC の FAQ.xls |
| *TXT/TSV | 構造化 QnA ファイル | Sample chit-chat.tsv |
データ ソースに認証が必要な場合、QnA Maker にそのコンテンツを取り込む次の方法を検討してください。
- ファイルを手動でダウンロードし、QnA Maker にインポートする
- 認証された SharePoint の場所からファイルを追加する
URL コンテンツ
QnA Maker で URL を使用して、次の 2 種類のドキュメントをインポートできます。
- FAQ URL
- サポート URL
各種類は、想定される形式を示します。
ファイルベースのコンテンツ
パブリック ソースまたはローカル ファイル システムからナレッジ ベースにファイルを追加するには、QnA Maker ポータルを使用します。
コンテンツ形式のガイドライン
さまざまなファイルの形式のガイドラインの詳細を確認してください。
次のステップ
QnAs の編集方法について説明します。