預先建置的問題解答

發行項
09/03/2024

預先建置問題解答 API 能讓使用者根據一段文字回答問題，不必為此建立知識庫、維護問題和答案配對，或負擔使用量過低的基礎結構成本。這項功能是以 API 的形式提供，可用於解決問題和解答需求，卻不必了解關於 QnA Maker 的詳細資料與額外儲存體。

注意

QnA Maker 服務即將於 2025 年 3 月 31 日淘汰。較新版的問題和解答功能現在隨附於 Azure AI 語言。如需瞭解語言服務內的問題解答功能，請參閱問題解答。從 2022 年 10 月 1 日開始，您將無法建立新的 QnA Maker 資源。如需將現有 QnA Maker 知識庫移轉至問題解答的相關資訊，請參閱移轉指南。

注意

本文件不適用於最新版本。若要了解如何搭配使用預先建置 API 與最新版本，請參閱預先建置 API 問題解答快速入門。

提供使用者查詢和文字區塊/文字段落，此 API 即會傳回答案和精確的答案 (若有的話)。

預先建置問題解答的使用範例

假設您有一個或多個文字區塊，並想要從中獲得指定問題的答案。一般來說您必須建立和文字區塊數目一樣多的來源。但是，在使用了預先建置問題解答後，您就能夠在不須於專案/知識庫中定義內容來源下，直接查詢文字區塊。

其他可以使用預先建置 API 的案例如下：

您正在開發適合終端使用者的電子書讀取器應用程式，使其可以醒目提示文字、輸入問題，並在醒目提示的文字中尋找答案
瀏覽器延伸模組可讓使用者針對瀏覽器頁面目前顯示的內容提出問題
健康情況 Bot 接受使用者查詢後，根據 Bot 找到的與使用者查詢最相關的醫療內容提供解答

以下是範例要求的例子：

範例要求

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

針對單一文字區塊的範例查詢

要求本文

{
    "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"
}

範例回應

在上述要求本文中，我們僅就單一文字區塊查詢。上述查詢所收到的範例回應如下所示，

{
    "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 所需之輸入和輸出參數。

共用方式為