Share via

事前構築済みの質問と回答

  • [アーティクル]

事前構築済みの質問と回答を使用すると、ユーザーはナレッジベースを作成したり、質問と回答のペアのメンテナンスを行ったり、使用率が低いインフラストラクチャのコストを負担することなく、テキストによる質問に回答することができます。 この機能は API として提供され、質問と回答に関するニーズを満たすために使用できます。QnA Maker や追加のストレージに関する詳細を学習する必要はありません。

Note

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

Note

このドキュメントは、最新のリリースには適用されません。 最新のリリースでの事前構築済み API の使用について詳しくは、質問応答の事前構築済み API に関する記事を参照してください。

ユーザー クエリとテキストや文章のブロックを指定すると、API によって回答と正確な回答 (使用可能な場合) が返されます。

事前構築済みの質問と回答の使用例

特定の質問に対する回答を取得したいテキストのブロックが 1 つ以上あるとします。 従来であれば、テキストのブロック数と同じ数のソースを作成する必要がありました。 しかし、事前構築済みの質問と回答を使用すれば、ナレッジ ベースでコンテンツ ソースを定義することなく、テキスト ブロックに対してクエリを実行できます。

事前構築済み API を使用できるその他のシナリオをいくつか次に示します。

  • テキストを強調表示して、質問を入力すると、強調表示されたテキストに対する回答の検索が行われる電子ブック リーダー アプリの開発
  • ブラウザー ページに現在表示されている内容について質問できるブラウザー拡張機能
  • ユーザーからクエリを受け取り、ユーザー クエリとの関連性が最も高いとボットによって識別された医療コンテンツに基づいて回答を提供する健康ボット

要求のサンプルの例は次のとおりです。

要求のサンプル

POST https://{Endpoint}/qnamaker/v5.0-preview.2/generateanswer

1 つのテキスト ブロックに対するサンプル クエリ

要求本文

{
    "question": "How long it takes to charge surface pro 4?",
    "documents": [
        {
            "text": "### The basics #### Power and charging It takes two to four hours to charge the Surface Pro 4 battery fully from an empty state. It can take longer if you’re using your Surface for power-intensive activities like gaming or video streaming while you’re charging it. You can use the USB port on your Surface Pro 4 power supply to charge other devices, like a phone, while your Surface charges.",
            "id": "doc1"
        }
    ],
    "Language": "en"
}

応答のサンプル

上の要求本文では、1 つのテキスト ブロックに対してクエリを実行します。 上のクエリに対して受信した応答のサンプルは次のとおりです。

{
    "answers": [
        {
            "answer": "### The basics #### Power and charging It takes two to four hours to charge the Surface Pro 4 battery fully from an empty state. It can take longer if you’re using your Surface for power-intensive activities like gaming or video streaming while you’re charging it. You can use the USB port on your Surface Pro 4 power supply to charge other devices, like a phone, while your Surface charges.",
            "answerSpan": {
                "text": "two to four hours",
                "score": 0.0,
                "startIndex": 47,
                "endIndex": 64
            },
            "score": 0.9599020481109619,
            "id": "doc1",
            "answerStartIndex": 0,
            "answerEndIndex": 390
        },
        {
            "answer": "It can take longer if you’re using your Surface for power-intensive activities like gaming or video streaming while you’re charging it. You can use the USB port on your Surface Pro 4 power supply to charge other devices, like a phone, while your Surface charges.",
            "score": 0.06749606877565384,
            "id": "doc1",
            "answerStartIndex": 129,
            "answerEndIndex": 390
        },
        {
            "answer": "You can use the USB port on your Surface Pro 4 power supply to charge other devices, like a phone, while your Surface charges.",
            "score": 0.011389964260160923,
            "id": "doc1",
            "answerStartIndex": 265,
            "answerEndIndex": 390
        }
    ]
}

API 応答の一部として複数の回答が返されているのが確認できます。 各回答には、回答の全体的な関連度を理解するのに役立つ具体的な信頼度スコアが付けられています。 ユーザーは、この信頼度スコアを利用して、クエリに対する回答を表示できます。

事前構築済み API の制限

事前構築済み API の制限に関するドキュメントを参照してください

事前構築済み API のリファレンス

API の呼び出しに必要な入力と出力のパラメーターについては、事前構築済み API のリファレンスに関するドキュメントを参照してください。