本文包含有關個人化工具服務常見疑難排解問題的解答。
單一區域資料落地
個人化工具何時會被取代?
從 2023 年 9 月 20 日起，您將無法建立新的個人化工具資源。 個人化工具服務將於 2026 年 10 月 1 日淘汰。
如何在具有單一區域資料落地的區域中複寫我的資料？
個人化工具不會在客戶部署服務執行個體所在區域以外的地方儲存/處理客戶資料。
設定問題
我變更了組態設定，現在我的迴圈並未在相同的學習層級執行。 發生什麼事？
部分設定會重設您的模型。 請在閱讀文件後，仔細規劃並執行設定變更。
使用 API 設定個人化工具時，我收到錯誤訊息。 發生什麼事？
如果您使用單一 API 要求來設定您的服務並變更學習行為，將會收到錯誤訊息。 您必須進行兩個個別的 API 呼叫：首先要設定您的服務，然後變更學習行為。
交易錯誤
我收到服務發出的 HTTP 429 (太多要求) 回應。 我能做什麼?
如果您在建立個人化工具執行個體時挑選了免費定價層，則允許的排名要求數目會有配額限制。 如果您預期增加的 API 呼叫數量會超過所選服務層級的閾值，請檢閱排名 API 的 API 呼叫率 (Azure 入口網站中 [個人化工具] 資源的 [計量] 窗格) 並調整定價層 ([定價層] 窗格)。
我收到排名或獎勵 API 的 5xx 錯誤。 我該怎麼做？
5xx 錯誤應該是暫時性問題。 如果錯誤持續發生，請在 Azure 入口網站中 [個人化工具] 資源的 [支援 + 疑難排解] 區段中，選取 [新增支援要求] 連絡支援人員。
學習迴圈
在新手模式中，學習迴圈不會達到 100% 符合非個人化 (基準) 原則。 如何修正此問題?
個人化工具的有效性在新手模式中很少會達到接近應用程式基準的 100%，而且永遠不會超過。 最佳做法是不以達到 100% 為目標，而是根據使用案例，以 60% - 80% 為範圍。 但如果學習效能緩慢或停滯於 60% 以下，可能已發生下列問題：
- 使用排名 API 呼叫傳送的功能不足
- 功能中傳送的錯誤 - 例如將非匯總的功能資料 (例如時間戳記) 傳送至排名 API
- 迴圈處理的錯誤 - 例如，未將獎勵資料傳送給事件的獎勵 API
若要解決這些問題，您可能需要變更傳送至迴圈的功能，或確保獎勵分數正確擷取排名 API 呼叫傳回的動作值，然後加以調整。
學習迴圈似乎未有效或快速學習。 如何修正此問題?
在排名呼叫設定有效的優先順序之前，學習迴圈需要幾千個獎勵呼叫。
如果您不確定學習迴圈目前的行為，請執行離線評估，並套用更正的學習原則。
我所有項目的排名結果持續獲得全部相同的機率。 如何得知個人化工具正在學習？
個人化工具會在排名 API 的結果剛啟動而具有空白模型時，或在您重設個人化工具迴圈，而您的模型仍在 [模型更新頻率] 期間時，在排名 API 結果中傳回相同的機率。
新的更新週間開始時，您會看到更新後的模型結果變更機率。
學習迴圈正在學習，但似乎無法再學習，且排名結果的品質並不好。 我該怎麼做？
- 請確定已在 Azure 入口網站對該迴圈完成並套用一項評估。
- 請確定已透過獎勵 API 成功傳送並處理所有獎勵。
如何得知學習迴圈會定期更新，並用來對我的資料進行評分？
您可以在 Azure 入口網站的 [模型和學習設定] 頁面中找到上次更新模型的時間。 如果您看到舊的時間戳記，很可能是因為您未傳送排名和獎勵通話。 如果服務沒有任何傳入資料，則不會更新學習。 如果您看到學習迴圈的更新頻率不足，您可以編輯迴圈的 [模型更新頻率]。
離線評估
離線評估的功能重要度會傳回包含數百或數千個項目的長清單。 發生什麼事？
這通常是因為時間戳記、使用者識別碼或所傳入的一些更精細的功能。
我建立了離線評估，且幾乎會立即成功。 這是為什麼？ 我沒有看到任何結果？
離線評估會使用該期間傳送至排名/獎勵 API 的事件定型模型和資料。 如果您的應用程式未在評估開始與結束期間內傳送任何資料，則評估會很快完成且沒有任何結果。
學習原則
如何匯入學習原則？
安全性
個人化工具支援哪些 API 驗證通訊協定？
個人化工具 API 使用 Microsoft Entra ID，而其支援各種驗證和同步通訊協定。
我的迴圈 API 金鑰已遭盜用。 我能做什麼?
您可以在交換用戶端之後重新產生一個金鑰，以使用另一個金鑰。 擁有兩個金鑰可讓您以延遲的方式傳播金鑰，而不需要任何停機。 基於安全性考量，建議您定期執行此動作。