分享方式：

適用於 QnA Maker 的 Azure 資源

  • 文章

QnA Maker 會使用數個 Azure 來源，各有不同的用途。 了解如何個別使用這些來源可讓您規劃及選取正確的定價層，或知道何時要變更您的定價層。 了解其組合的使用方式，可讓您在發生問題時尋找並修正問題。

注意

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

資源規劃

當您第一次開發 QnA Maker 知識庫時，在原型階段中，測試和生產環境中通常都會有單一 QnA Maker 的資源。

當您移至專案的開發階段時，您應該考慮：

  • 您的知識庫系統會保存幾種語言？
  • 您需要知識庫在幾個區域中可供使用？
  • 您系統將保留的每個網域中有幾份文件？

規劃讓單一 QnA Maker 資源保存所有具有相同語言、相同區域和相同主體網域組合的知識庫。

定價層考量

一般而言，您有三個參數必須考量：

  • 您所需的服務輸送量：

    • 根據您的需求為您的應用程式服務選取適當的應用程式方案。 您可以擴大或縮減應用程式。
    • 這應該也會影響您的 Azure 認知搜尋 SKU 選取，請參閱這裡以取得更多詳細資料。 此外，您可能需要使用複本來調整認知搜尋的容量。

  • 知識庫的大小和數量：針對您的案例選擇適當的 Azure 搜尋服務 SKU。 一般而言，您會根據不同主體網域的數目，決定您需要的知識庫數目。 主體網域 (適用於單一語言) 應該在一個知識庫中。

在 2019 年 1 月之後，您的 Azure 搜尋服務資源必須已建立，而且不能位於免費 (共用) 層。 不支援在 Azure 入口網站中設定客戶自控金鑰。

重要

您可以在特定層中發佈 N-1 個知識庫，其中，N 是該層中允許的索引數上限。 同時也請檢查每個層允許的大小上限和文件數目。

例如，如果您的層允許 15 個索引，您即可以發佈 14 個知識庫 (每個發佈的知識庫 1 個索引)。 第十五個索引用於撰寫和測試所有知識庫。

  • 作為來源的文件數目：QnA Maker 管理服務的免費 SKU 會將您可以透過入口網站和 API 管理的文件數目限制為 3 (每份文件的大小為 1 MB)。 標準 SKU 則不會限制您可管理的文件數目。 如需詳細資訊，請參閱這裡。

下表為您提供某些高階指導方針。

QnA Maker 管理 應用程式服務 Azure AI 搜尋服務 限制
測試 免費 SKU 免費層 免費層 最多發佈 2 個 KB，大小為 50 MB
開發/測試環境 標準 SKU 共用 基本 最多發佈 14 KB，大小為 2 GB
生產環境 標準 SKU 基本 標準 最多發佈 49 個 KB，大小為 25 GB
目標 QPS 應用程式服務 Azure AI 搜尋服務
3 S1，一個複本 S1，一個複本
50 S3，10 個複本 S1，12 個複本
80 S3，10 個複本 S3，12 個複本
100 P3V2，10 個複本 S3，12 個複本，3 個磁碟分割
200 到 250 P3V2，20 個複本 S3，12 個複本，3 個磁碟分割

何時要變更定價層

升級 原因
升級 QnA Maker 管理 SKU 您想要在知識庫中有更多 QnA 配對或文件來源。
升級 App Service SKU 並檢查 Azure AI 搜尋服務層，並建立認知搜尋複本 您的知識庫需要從用戶端應用程式 (例如聊天機器人) 提供更多要求。
升級 Azure AI 搜尋服務 您打算擁有許多知識庫。

更新 Azure 入口網站中的 App Service，以取得最新的執行階段更新。

QnA Maker 中的金鑰

您的 QnA Maker 服務會處理兩種類型的金鑰：[撰寫金鑰] 和 [查詢端點金鑰] 搭配 App Service 中裝載的執行階段使用。

透過 API 對服務提出要求時，請使用這些金鑰。

金鑰管理

名稱 Location 目的
撰寫/訂用帳戶金鑰 Azure 入口網站 這些金鑰可用來存取 QnA Maker 管理服務 API。 這些 API 可讓您編輯知識庫中的問題和答案，並發佈您的知識庫。 當您建立新的 QnA Maker 服務時，會建立這些金鑰。

在金鑰和端點頁面上的Azure AI 服務資源上尋找這些金鑰。
查詢端點金鑰 QnA Maker 入口網站 這些金鑰可用來查詢發佈的知識庫端點，以取得使用者問題的回應。 您通常會在您的聊天機器人或在連線至 QnA Maker 服務的用戶端應用程式程式碼中使用此查詢端點。 當您發佈 QnA Maker 知識庫時，會建立這些金鑰。

在 [服務設定] 頁面中找到這些金鑰。 從下拉式功能表右上方頁面的使用者功能表中尋找此頁面。

在 Azure 入口網站中尋找撰寫金鑰

您可以從您建立 QnA Maker 資源的 Azure 入口網站來檢視和重設撰寫金鑰。

  1. 移至 Azure 入口網站中的 QnA Maker 資源，然後選取具有 Azure AI 服務類型的資源：

    QnA Maker 資源清單

  2. 前往金鑰與端點：

    QnA Maker 受控 (預覽) 訂閱金鑰

在 QnA Maker 入口網站中尋找查詢端點金鑰

端點與資源位於相同的區域中，因為端點金鑰是用來對知識庫進行呼叫。

您可以從 QnA Maker 入口網站來管理端點金鑰。

  1. 登入 QnA Maker 入口網站，移至您的設定檔，然後選取 [服務設定]：

    端點金鑰

  2. 檢視或重設您的金鑰：

    端點金鑰管理員

    注意

    如果您認為金鑰遭到入侵，請加以重新整理。 為此，您可能需要對用戶端應用程式或 Bot 程式碼進行對應的變更。

管理服務區域

QnA Maker 的管理服務僅用於 QnA Maker 入口網站和初始資料處理。 這項服務僅適用於 [美國西部] 區域。 此美國西部服務中不會儲存任何客戶資料。

資源命名考量

QnA Maker 資源的資源名稱 (例如 qna-westus-f0-b) 也會用來命名其他資源。

Azure 入口網站的 [建立] 視窗可讓您建立 QnA Maker 資源，然後選取其他資源的定價層。

QnA Maker 資源建立的 Azure 入口網站螢幕擷取畫面

資源建立後，會有相同的名稱，但選用的 Application Insights 資源除外，其會將字元附加至名稱的後方。

Azure 入口網站資源清單的螢幕擷取畫面

提示

當您建立 QnA Maker 資源時，請建立新的資源群組。 這可讓您在依資源群組搜尋時，查看與 QnA Maker 資源相關聯的所有資源。

提示

使用命名慣例來指出資源名稱或資源群組內的定價層。 若您在建立新的知識庫或新增文件時收到錯誤，認知搜尋定價層限制是常見的問題。

資源用途

使用 QnA Maker 建立的每個 Azure 資源都有特定用途：

  • QnA Maker 資源
  • 認知搜尋資源
  • 應用程式服務
  • App 方案服務
  • Application Insights 服務

QnA Maker 資源

QnA Maker 資源可讓您存取撰寫和發佈 API。

QnA Maker 資源組態設定

當您在 QnA Maker 入口網站中建立新的知識庫時，[語言] 設定是在資源層級套用的唯一設定。 當您建立資源的第一個知識庫時，請選取語言。

認知搜尋資源

認知搜尋資源可用來：

  • 儲存 QnA 配對
  • 在執行階段提供 QnA 配對的初始排名 (排名工具 #1)

索引使用情形

資源會保留一個索引做為測試索引，其餘的索引則會與每一個已發佈的知識庫相互關聯。

定價為保存 15 個索引的資源會保存 14 個已發佈的知識庫，且會使用一個索引來測試所有知識庫。 此測試索引是依知識庫進行分割，因此使用 [互動式測試] 窗格的查詢將會使用測試索引，但只會從與特定知識庫相關聯的特定分割區傳回結果。

語言使用量

在 QnA Maker 資源中建立的第一個知識庫會用來判斷認知搜尋資源和其所有索引的單一語言集。 QnA Maker 服務只能有一個語言集。

使用單一認知搜尋服務

如果您透過入口網站建立 QnA 服務及其相依性 (例如搜尋)，系統就會為您建立一個搜尋服務，並連結到 QnA Maker 服務。 建立這些資源之後，您可以將 App Service 設定更新為使用先前既有的搜尋服務，並移除您剛建立的搜尋服務。

了解如何設定 QnA Maker 來使用不同的 Azure AI 服務資源，而不是 QnA Maker 資源建立程序中所建立的資源。

App Service 和 App Service 方案

您的用戶端應用程式會使用 App Service，透過執行階段端點來存取已發佈的知識庫。 App Service 包含執行階段針對 QnA 配對以自然語言處理 (NLP) 為基礎的第二排名層 (排名工具 #2)。 第二排名套用可包含中繼資料和後續提示的智慧型篩選條件。

若要查詢已發佈的知識庫，所有已發佈的知識庫都會使用相同的 URL 端點，但是會在路由中指定知識庫識別碼。

{RuntimeEndpoint}/qnamaker/knowledgebases/{kbId}/generateAnswer

Application Insights

Application Insights 可用來收集聊天記錄和遙測。 請檢閱常見的 Kusto 查詢，以取得服務的相關資訊。

與 QnA Maker 共用服務

QnA Maker 會建立數個 Azure 資源。 若要降低管理成本並受益於成本共用，請使用下表來了解您可以和不能共用的內容：

服務 共用 原因
Azure AI 服務 X 依設計無法進行
App Service 方案 ✔ 已修正配置給 App Service 方案的磁碟空間。 如果共用相同 App Service 方案的其他應用程式使用大量磁碟空間，QnAMaker App Service 執行個體將會發生問題。
應用程式服務 X 依設計無法進行
Application Insights ✔ 可以共用
搜尋服務 ✔ 1. testkb 是 QnAMaker 服務的保留名稱，其他人員無法使用。
2.synonym-map 名稱的同義字對應已保留給 QnAMaker 服務。
3.已發佈的知識庫數目受限於搜尋服務層。 如果有可用的索引，則其他服務可以使用這些索引。

下一步