智慧建議帳戶常見問題集
本文提供使用智慧建議時可能發生之常見疑難或問題的解答。
目錄
帳戶維護
本節適用於設定或維護智慧建議帳戶的相關問題。
如何建立智慧建議帳戶？
如需有關如何設定帳戶的步驟，請移至設定概觀。
如何建立模型和服務資源？
如需有關建立模型和服務資源的步驟，請參閱帳戶建立快速入門手冊的步驟 5。
如何連絡智慧建議支援小組？
對於未解答的疑難或問題，您可以在 Microsoft Azure 入口網站中開立支援票證來聯繫智慧建議支援小組。
- 在左側功能表上，選取說明及支援。
- 選取建立支援要求。
- 完成表單。 隨即建立支援票證。
哪裡可以找到服務端點 URL？
如需有關尋找服務端點 URL 的步驟和方法，請前往 Azure 入口網站上的智慧建議帳戶，然後搜尋想要使用的端點資源。 您可以從那裡複製服務 URL 端點。 如需詳細資訊，請移至檢視建議結果快速入門手冊。
如何解決資料合約中的錯誤？
若要了解資料合約中傳回的錯誤記錄，請移至錯誤類型。
如何模式模型執行個體的錯誤記錄？
若要檢視模型執行個體的錯誤記錄，請設定您的帳戶以啟用錯誤模型。 如需詳細資訊，請移至設定錯誤記錄。 如需有關可能傳回之錯誤類型的詳細資訊，請移至錯誤類型。
為什麼看不到任何寫入記錄檔資料夾的記錄檔？
如果看不到任何寫入專用記錄檔資料夾的記錄檔，您可以檢查 IR 帳戶是否有權存取相關的容器：
- 移至智慧建議帳戶。
- 選取報表索引標籤。
- 按一下 [檢查存取] 按鈕
- 如果傳回的訊息指出「缺少用於存取儲存體帳戶的設定」，則必須授與存取相關聯容器的寫入權限。 如果傳回的訊息指出「要求的儲存體帳戶不存在，或是您沒有權限」，請確認指定的 URL 正確無誤。
如果錯誤地設定了日期時間戳記，會發生什麼情況？
如果您遇到時間戳記問題，則產品會從可用候選項目清單中移除，並且從建議中篩除。 若要修正此問題，請先檢查 ItemsAndVariants 資料實體輸入，並確定發行日期符合支援的日期時間格式 (即「yyyy-MM-ddTHH: mm:ss.fffZ」)。
讀取 model.json CSV 時發生問題
在 Excel 或任何其他適合非 CSV 的工具中開啟 CSV，可能會移除資料實體所需的 CSV 格式的空白欄。 建議您在記事本中，或在不會修改內容的相關應用程式中，開啟並檢查 CSV。
正確更新輸入資料的建議方式是什麼？
如果嘗試同時對輸入資料建立模型和進行更新，有時可能會導致對混合資料版本中的資料建立模型，並產生不可取的建議結果。 如需有關如何正確更新輸入資料的詳細資訊，請參閱我們的最佳做法指南。
API 結果和錯誤記錄
本節適用於與 API 結果或錯誤記錄文件相關的問題。
如何檢查我是否為提出 API 要求的授權使用者？
您必須先將使用者新增至端點資源的授權使用者清單，他們才能成功呼叫服務。 如需有關如何檢查授權使用者狀態的詳細資訊，請移至快速入門手冊的步驟 2：建構 API 要求。
要求失敗，但 URL 正確的。
如果 URL 正確，則可能是提出要求的使用者未列入此端點資源的授權使用者清單中。
如需有關如何檢查授權使用者狀態的詳細資訊，請移至快速入門手冊的步驟 2：建構 API 要求。
我剛建立了帳戶，但是看不到結果。
如果是剛開始，則服務需要一段時間，才能提供結果。 您可以追蹤每個您所建立模型的模型狀態。 如需詳細資訊，請參閱我們的模型狀態報表指南。
還可以查看記錄檔資料夾，了解任何與資料合約相關的問題，以及是否需要進行任何變更或更正。
如果仍然看不到任何結果，請確定您已為智慧建議帳戶提供可從相關容器讀取資料的權限：
- 移至智慧建議帳戶。
- 選取 [模型] 索引標籤。
- 選擇相關的模型元件。
- 選取 [連接字串] 索引標籤。
- 按一下 [檢查存取] 按鈕。
- 如果傳回的訊息指出「缺少用於存取儲存體帳戶的設定」，則必須授與存取相關聯容器的讀取權限。 如果傳回的訊息指出「要求的儲存體帳戶不存在，或是您沒有權限」，請確認指定的 URL 正確無誤。
此外，也請確認是否已在儲存體帳戶中放置正確的資料夾和檔案。 如需詳細資訊，請參閱下載 model.json 檔案並設定根資料夾。
如何追蹤模型狀態？
智慧建議客戶可以追蹤他們在其帳戶中所建立每個模型的模型狀態。 設定模型之後，服務會定期建立狀態記錄檔，以回報所有演算法目前的狀態 (針對您的模型層)。 若要深入了解如何存取這些記錄，請參閱模型狀態報表指南。
我的記錄檔在哪裡？或者為什麼是空的？
如果您未授與正確的儲存體 Blob 資料參與者權限，或已指向不正確的連接字串，則記錄檔可能是空白。 若要確認，請遵循我們的快速入門手冊。
此外，也請確定您的錯誤記錄檔已正確設定，並驗證模型執行個體的連接字串是否指向包含記錄檔的資料夾。
為什麼只有特定產品或特定清單不會傳回結果？
一般而言，指定項目或使用者的互動不足可能會影響結果的品質，或導致未傳回任何結果。 新產品有時還需要一些時間來取得訊息，然後才能出現在特定建議清單中。 您隨時都可以使用儀表板仔細查看產品效能。
如果發燒貨結果空白，應該怎麼辦？
對清單中的每個項目進行評分 (排名) 時，發燒貨清單 API 都會將產品存留期和互動次數納入考量。
首先計算已設定時間範圍內的互動次數，然後考慮產品的存留期 (自其發行日期在目錄中出現以來的天數)。 項目越新，分數越高，而隨著產品「變陳」，其分數呈指數級衰減。
若要控制發燒貨中的結果，您必須調整 Reco 設定資料實體資料夾中的兩個可設定欄位：
- TrendingListMaxAgeDays 設定產品存留期上限 (以天數計)。 超過 TrendingListMaxAgeDays 天數以前所發行的產品不會出現在發燒貨清單中。
- TrendingListTransactionsIntervalDays 設定彙總互動次數的時間範圍。 項目可以比這個值還要陳舊，但只會計入晚於 TrendingListTransactionsIntervalDays 天數以前的互動。
在 Reco 設定資料實體中調整這些設定，然後重新發佈您的模型。 接著，應該會開始看到建議結果。
如果「推薦項目」結果空白，應該怎麼辦？
「推薦項目」功能僅適用於有功能集標示為標準或進階的模型執行個體。 如果您已確認功能集已正確設定，請仔細查看您嘗試取得其建議的使用者。 沒有歷史互動資料 (例如先前的採購) 的使用者識別碼不會在呼叫「推薦項目」功能時傳回結果。 此外，還要確認使用者最近是否選擇不接收個人化建議。 任何已退出個人化的使用者都不會收到個人化建議。
為什麼看不到類似外觀建議？
類似外觀建議是根據類似影像提供，而這些建議只會顯示給已選取進階功能集且已在資料合約中分享其項目相片的客戶。 請確認您已選取模型的進階功能集，並且已依照影像至項目對應資料實體中所述方式正確設定影像。
哪裡可以找到 API 狀態碼的完整清單？
API 狀態碼可在這裡的 [範例 API 要求] 頁面中找到完整清單。
智慧建議支援使用哪些參數來追蹤 API 要求？
您可以選擇將下列其中一個或多個追蹤識別碼當做標頭參數新增至 API 要求。 如果您的 API 要求發生問題，我們可以新增一個或多個這些參數，根據您提供的相關識別碼更有效率地追蹤和調查您的要求。
| 標頭金鑰參數 | 描述 |
|---|---|
| CorrelationId | |
| 追蹤識別碼 | |
| 上層識別碼 | 可以根據您的需要將要求組成群組 (例如，相同使用者、區域等)。 |
可以這些標頭參數新增至任何要求類型，而不考慮 URI、查詢參數、案例等。
另請參閱
快速入門手冊：使用範例資料設定並執行智慧建議
快速入門手冊：進行經過驗證的 API 呼叫
API 狀態碼
錯誤記錄
設定概觀
資料合約概觀