共用方式為

針對 QnA Maker 進行疑難排解

  • 發行項

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

注意

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

管理預測

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

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

深入了解定價層。

如何取得 QnAMaker 服務端點

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

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

    Azure 入口網站中的 QnAMaker Azure 資源群組

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

    選取 QnAMaker App Service

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

    QnAMaker 端點

管理知識庫

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

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

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

為何我的 URL/檔案不會擷取問答配對？

答：有可能是因為 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 設定

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

qnamaker appservice 重新啟動

為什麼我的 SharePoint 連結無法供擷取？

答：如需詳細資訊，請參閱資料來源位置。

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

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

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

回答：

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

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

使用 Markdown 的回答文字

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

QnA Maker 是否支援非英文的語言？

答：請參閱更多支援的語言詳細資料。

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

管理服務

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

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

我刪除了現有的搜尋服務。我該怎麼辦？

答：刪除 Azure AI 搜尋服務索引是不可逆的作業，因此索引無法復原。

我刪除了搜尋服務中的 `testkb` 索引。如何修正此問題？

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

我收到下列錯誤：請檢查 QnA Maker App Service 的 CORS 設定是否允許 https://www.qnamaker.ai，或是否有任何組織特有的網路限制。我該如何解決這種情況？

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

何時應重新整理端點金鑰？

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

我是否可以針對使用多種語言的知識庫使用相同的 Azure AI 搜尋服務資源？

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

如何變更 QnA Maker 使用之 Azure AI 搜尋服務資源的名稱？

答：Azure AI 搜尋服務資源的名稱是 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 AI Bot Service 會以數個範本之一的形式提供 QnA Maker。 Bot Service 可透過 Microsoft Bot Framework 快速開發智慧型 Bot，並且可在無伺服器環境中執行。

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

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

如何在現有的 Azure AI Bot Service 使用不同的知識庫?

答：您需要知識庫的下列資訊：

  • 知識庫識別碼。
  • 知識庫發佈的端點自訂子網域名稱 (稱為 host)，會在您發佈之後出現於 [設定] 頁面。
  • 知識庫發佈的端點金鑰，會在您發佈之後出現於 [設定] 頁面。

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

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

兩個以上的用戶端應用程式是否可以共用知識庫？

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

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

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

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

資料存放區

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

回答：

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