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