個人化工具常見問題

本文包含個人化工具服務常見問題的解答。

單一區域資料落地

個人化工具何時會被取代?

從 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 金鑰已遭入侵。 我能做什麼?

您可以在交換用戶端以使用另一個金鑰之後重新產生一個金鑰。 擁有兩個金鑰可讓您以懶惰的方式傳播金鑰,而不需要停機。 基於安全性考慮,建議您定期執行這項操作。