針對 QnA Maker 進行疑難排解

QnA Maker 服務相關常見問題的策畫清單可協助您更快速地採用服務,並獲得更好的結果。

注意

QnA Maker 服務將于 2025 年 3 月 31 日淘汰。 新版的問題和解答功能現在可做為 適用于語言的 Azure 認知服務一部分使用。 如需瞭解語言服務內的問題解答功能,請參閱問題解答。 從 2022 年 10 月 1 日開始,您將無法建立新的 QnA Maker 資源。 如需將現有 QnA Maker 知識庫移轉至問題解答的資訊,請參閱 移轉指南

管理預測

如何改善查詢預測的輸送量效能?

:輸送量效能問題會指出您的 App Service 和認知搜尋需要進行擴大。 請考慮將複本新增至認知搜尋來改善效能。

深入了解定價層

如何取得 QnAMaker 服務端點

:當您連絡 QnAMaker 支援人員或 UserVoice 時,QnAMaker 服務端點將有助於偵錯的用途。 端點是下列格式的 URL:https://your-resource-name.azurewebsites.net

  1. Azure 入口網站中移至 QnAMaker 服務 (資源群組)

    QnAMaker Azure resource group in Azure portal

  2. 選取與 QnA Maker 資源相關聯的 App Service。 一般而言,名稱相同。

    Select QnAMaker App Service

  3. 端點 URL 會顯示於 [概觀] 區段中

    QnAMaker endpoint

管理知識庫

我不小心刪除了一部分的 QnA Maker,該怎麼辦?

:請勿刪除隨 QnA Maker 資源 (例如 [搜尋] 或 [Web 應用程式]) 建立的任何 Azure 服務。 這些是 QnA Maker 運作的必要項目,如果您刪除其中一個,QnA Maker 將會停止正常運作。

所有刪除都是永久的,包括問答組、檔案、URL、自訂問答、知識庫或 Azure 資源。 務必先從 [設定] 頁面匯出知識庫,再刪除知識庫的任何部分。

為什麼我的 URL () /file (s) 未擷取問題答案組?

:有可能是因為 QnA Maker 無法從有效的常見問題集 URL 自動擷取某些問答 (QnA) 內容。 在這種情況下,您可以將 QnA 內容貼到 .txt 檔案中,並確認工具是否可加以擷取。 或者,您也可以透過 QnA Maker 入口網站 \(英文\) 以編輯方式將內容新增至您的知識庫。

我可以建立知識庫有多大?

:知識庫的大小取決於您在建立 QnA Maker 服務時所選擇的 Azure 搜尋服務 SKU。 如需詳細資訊,請參閱這裡

當我嘗試建立新的知識庫時,為什麼我在下拉式清單中看不到任何專案?

:您尚未在 Azure 中建立任何 QnA Maker 服務。 請參閱這裡以了解如何這麼做。

如何與其他人共用知識庫?

:共用會在 QnA Maker 服務層級上運作,也就是說,將會共用服務中的所有知識庫。 請參閱這裡以了解如何在知識庫上共同作業。

您可以與不在相同 AAD 租使用者中的參與者共用知識庫,以修改知識庫嗎?

:共用是以 Azure 角色型存取控制 (RBAC) 為基礎。 如果您可以與另一個使用者共用 Azure 中的「任何」資源,便代表您也可以共用 QnA Maker。

如果您有 5 個 QnAMaker 知識庫的 App Service 方案。您可以將讀取/寫入權限指派給 5 個不同的使用者,讓每一位使用者只能存取 1 個 QnAMaker 知識庫嗎?

:您可以共用整個 QnAMaker 服務,但不能共用個別的知識庫。

找不到良好的相符專案時,如何變更預設訊息?

:預設訊息是您 App Service 中的部分設定。

  • 在 Azure 入口網站中,移至您的 App Service 資源

qnamaker appservice

  • 選取 [設定] 選項

qnamaker appservice settings

  • 變更 DefaultAnswer 設定的值
  • 重新啟動 App Service

qnamaker appservice restart

為什麼我的 SharePoint 連結未擷取?

:如需詳細資訊,請參閱資料來源位置

我對知識庫所做的更新不會反映在發佈時。為什麼不呢?

:無論是資料表更新、測試或設定,每個編輯作業都必須先儲存才能加以發佈。 在每次編輯作業完成後,請務必選取 [儲存並訓練] 按鈕。

知識庫是否支援豐富資料或多媒體?

答案

檔案和 URL 的多媒體自動擷取

  • URL - 有限的 HTML 至 Markdown 轉換功能。
  • 檔案 - 不支援

回答 Markdown 中的文字

一旦 QnA 配對位於知識庫後,您就可以編輯答案的 Markdown 文字,以包含可從公用 URL 取得媒體的連結。

QnA Maker 是否支援非英文語言?

:請參閱更多關於支援的語言的詳細資料。

如果您有多種語言的內容,請務必為每一種語言建立個別的服務。

管理服務

何時應該重新啟動我的應用程式服務?

:在 [使用者設定] 頁面上的 [端點金鑰] 資料表中,當注意圖示出現在知識庫的版本值旁邊時,重新整理您的應用程式服務。

我已刪除現有的搜尋服務。如何修正此問題?

:刪除 Azure 認知搜尋服務索引是不可逆的作業,因此索引無法復原。

我在搜尋服務中刪除了 'testkb' 索引。如何修正此問題?

:如果您刪除了搜尋服務中的 testkb 索引,您可以從上次發佈的知識庫還原資料。 請使用 GitHub 上提供的復原工具 RestoreTestKBIndex

我收到下列錯誤:請檢查 QnA Maker App Service 的 CORS 設定是否允許 https://www.qnamaker.ai ,或是否有任何組織特定的網路限制。如何解決此問題?

:在 [App Service] 窗格的 API 區段中,將 CORS 設定更新為 * 或 "https://www.qnamaker.ai"。 如果這樣無法解決問題,請檢查是否有任何組織特有的限制。

何時應該重新整理端點金鑰?

:若您懷疑端點金鑰已遭入侵,請加以重新整理。

我可以使用多種語言的知識庫使用相同的 Azure 認知搜尋資源嗎?

:若要使用多種語言和多個知識庫,使用者必須針對每個語言建立 QnA Maker 資源。 這將會針對每個語言建立個別的 Azure 搜尋服務。 在單一 Azure 搜尋服務中混用不同的語言知識庫,將會使結果的相關性降低。

如何變更 QnA Maker 所使用的 Azure 認知搜尋資源名稱?

:Azure 認知搜尋服務資源的名稱是 QnA Maker 資源名稱加上一些附加在結尾的隨機字母。 這讓您難以區別 QnA Maker 的多個搜尋服務資源。 建立個別的搜尋服務 (以您想要的方式為其命名) 並將其連線到您的 QnA Service。 步驟類似於升級 Azure 搜尋服務所需的步驟。

當 QnA Maker 傳回「執行時間核心未初始化」時,如何修正此問題?

:您 App Service 的磁碟空間可能已滿。 修正磁碟空間的步驟:

  1. Azure 入口網站中,選取您 QnA Maker 的 App Service,然後停止該服務。

  2. 同樣在 App Service 上,選取 [開發工具][進階工具][執行]。 這會開啟新的瀏覽器視窗。

  3. 選取 [偵錯主控台],然後選取 [CMD] 以開啟命令列工具。

  4. 瀏覽至 site/wwwroot/Data/QnAMaker/ 目錄。

  5. 移除名稱開頭為 rd 的所有資料夾。

    請勿刪除下列項目:

    • KbIdToRankerMappings.txt 檔案
    • EndpointSettings.json 檔案
    • EndpointKeys 資料夾
  6. 啟動 App Service。

  7. 存取您的知識庫以確認其現在可正常運作。

為什麼我的 Application Insights 無法運作?

:請交叉檢查並更新下列步驟來修正此問題:

  1. 在 App Service -> 設定群組 -> 設定區段 -> 應用程式設定 -> 名稱 "UserAppInsightsKey" 參數已正確設定,並設定為個別的 Application Insights 概觀索引標籤 (「檢測金鑰」) GUID。

  2. 在 App Service -> 設定群組 ->「Application Insights」區段中 -> 請確定已啟用 Application Insights 並連線到個別的 Application Insights 資源。

我的 Application Insights 已啟用,但為何無法正常運作?

:請遵循下列步驟執行:

  1. 如果已經有某個值存在,請覆寫以將 '“APPINSIGHTS_INSTRUMENTATIONKEY” name' 的值複製到 'UserAppInsightsKey' name。

  2. 如果 'UserAppInsightsKey' 金鑰不存在應用程式設定中,請新增具有該名稱的新金鑰,然後複製值。

  3. 加以儲存,這將會自動重新啟動 App Service。 這應該會解決此問題。

與其他服務 (包括 Bot) 整合

我是否需要使用 Bot Framework 才能使用 QnA Maker?

:否,您不需要將 Bot Framework 用於 QnA Maker。 不過,Azure Bot 服務會以數個範本之一的形式提供 QnA Maker。 Bot Service 可透過 Microsoft Bot Framework 快速開發智慧型 Bot,並且可在無伺服器環境中執行。

如何使用 QnA Maker 建立新的 Bot?

:請遵循這份文件中的指示,以使用 Azure Bot Service 建立您的 Bot。

如何搭配現有的 Azure Bot 服務使用不同的知識庫?

:您需要知識庫的下列資訊:

  • 知識庫識別碼。
  • 知識庫的已發佈端點自訂子功能變數名稱稱,稱為 ,可在 host 發佈後於 [ 設定 ] 頁面上找到。
  • 知識庫發佈的端點金鑰,會在您發佈之後出現於 [設定] 頁面。

具備這項資訊之後,前往您在 Azure 入口網站中的 Bot 應用程式服務。 在 [設定 - > 組態 - > 應用程式設定] 底下,變更這些值。

知識庫的端點金鑰會在 ABS 服務中加上 QnAAuthkey 標籤。

兩個以上的用戶端應用程式可以共用知識庫嗎?

:是,您可以從任意數目的用戶端查詢知識庫。 如果知識庫的回應似乎很慢或已逾時,請考慮升級與知識庫相關聯 App Service 的服務層級。

如何在我的網站中內嵌 QnA Maker 服務?

:依照以下步驟,將 QnA Maker 服務作為網站聊天控制項內嵌至您的網站中:

  1. 依照這裡的指示建立您的常見問題集 Bot。
  2. 依照這裡的步驟啟用網路聊天

資料儲存體

會儲存哪些資料以及儲存在哪裡?

答案

當您建立 QnA Maker 服務時,您選取了 Azure 區域。 您的知識庫和記錄檔會儲存在此區域中。