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 資源保留具有相同語言、相同區域和相同主旨網域組合的所有 知識庫。

定價層考量

一般而言，您需要考慮三個參數：

  • 您需要的服務輸送量：

    • 根據您的需求，為您的 App Service 選取適當的 應用程式方案 。 您可以 相應增加 或減少應用程式。
    • 這也應該會影響您的 Azure 認知搜尋 SKU 選取專案，請參閱這裡的詳細數據。 此外，您可能需要調整具有複本的認知搜尋 容量 。

  • 大小和 知識庫 數目：為您的案例選擇適當的 Azure 搜尋 SKU。 一般而言，您會根據不同的主旨網域數目來決定所需的 知識庫 數目。 一旦主旨網域（針對單一語言）應位於一個 知識庫。

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

重要

您可以在特定層中發佈 N-1 知識庫，其中 N 是層中允許的最大索引。 同時檢查每一層允許的檔案大小上限和數目。

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

  • 檔數目作為來源：QnA Maker 管理服務的免費 SKU 會將您可以透過入口網站管理的文件數目限制為 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 向服務提出要求時，請使用這些金鑰。

Key management

名稱 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 resource list

  2. 移至 [金鑰] 和 [ 端點]：

    QnA Maker managed (Preview) Subscription key

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

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

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

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

    Endpoint key

  2. 檢視或重設金鑰：

    Endpoint key manager

    注意

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

管理服務區域

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

資源命名考慮

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

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

Screenshot of Azure portal for QnA Maker resource creation

建立資源之後，除了選擇性 Application Insights 資源之外，這些資源會加上名稱的字元，否則它們具有相同的名稱。

Screenshot of Azure portal resource listing

提示

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

提示

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

資源用途

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

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

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 設定 為使用與 QnA Maker 資源建立程式一起建立的不同 Azure AI 服務資源。

App Service 和 App Service 方案

用戶端應用程式會使用 App Service ，透過執行時間端點存取已發佈的知識庫。 App Service 包含執行時間 QnA 配對的自然語言處理 （NLP） 型第二排名層 （ranker #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.已發行知識庫的數目受限於搜尋服務層。 如果有可用的免費索引，其他服務可以使用它們。

下一步