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 服務 （資源群組）

    QnAMaker Azure resource group in Azure portal

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

    Select QnAMaker App Service

  3. 端點 URL 可在 [概觀] 區段中取得

    QnAMaker endpoint

管理知識庫

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

答 ：請勿刪除任何與 QnA Maker 資源一起建立的 Azure 服務，例如搜尋或 Web 應用程式。 當您刪除 QnA Maker 時，QnA Maker 必須執行這些動作，QnA Maker 將會停止正常運作。

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

為什麼我的 URL（s）/file（s） 未擷取問答組？

答 ：QnA Maker 可能無法從有效的常見問題 URL 自動擷取一些問答內容。 在這種情況下，您可以將 QnA 內容貼到 .txt 檔案中，並查看工具是否可以內嵌。 或者，您可以透過 QnA Maker 入口 網站，以編輯方式將內容新增至您的知識庫。

我可建立多大的知識庫？

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

當我嘗試建立新的知識庫時，為何我在下拉式清單中未看到任何項目？

答 ：您尚未在 Azure 中建立任何 QnA Maker 服務。 請在這裡 閱讀 以瞭解如何執行此動作。

如何與他人共用知識庫？

答 ：共用可在 QnA Maker 服務層級運作，也就是說，服務中的所有知識庫都會共用。 請參閱 這裡 如何共同作業知識庫。

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

答 ：共用是以 Azure 角色型存取控制為基礎。 如果您可以與另一位使用者共用 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 的多媒體自動擷取

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

在 Markdown 中回答文字

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

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

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

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

管理服務

何時應該重新開機應用程式服務？

答 ：當使用者設定 頁面 端點索引鍵 資料表 中知識庫 的版本值旁邊時，請重新整理您的應用程式服務。

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

答 ：如果您刪除 Azure AI 搜尋服務索引，作業是最終的，而且無法復原索引。

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

答 ：如果您在搜尋服務中刪除 testkb 索引，您可以從最後一個已發佈的 KB 還原資料。 請使用 GitHub 上提供的 Recovery 工具 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 服務。 這些步驟與升級 Azure 搜尋服務 所需的 步驟類似。

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

答 ：您的應用程式服務的磁碟空間可能已滿。 修正磁碟空間的步驟：

  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 概觀索引標籤 （「Instrumentation Key」） Guid。

  2. 在 App Service - > 設定 群組 - > 「Application Insights」 區段 - > 確定已啟用應用程式深入解析並聯機至個別的 Application Insights 資源。

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

答 ：請遵循下列指定步驟：

  1. 將 '「APPINSIGHTS_INSTRUMENTATIONKEY」 name' 的值複製到 'UserAppInsightsKey' 名稱，方法是覆寫其中已經有一些值。

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

  3. 儲存它，這會自動重新開機 App Service。 這應該會解決此問題。

與其他服務整合，包括 Bot

我需要使用 Bot Framework 才能使用 QnA Maker 嗎？

答 ：否，您不需要搭配 QnA Maker 使用 Bot Framework 。 不過，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 應用程式服務。 在 [設定 - > 組態 - > 應用程式設定 下，變更這些值。

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

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

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

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

答 ：請遵循下列步驟，將 QnA Maker 服務內嵌為網站中的網路聊天控制項：

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

資料儲存

儲存哪些資料，以及其儲存位置？

回答：

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