重要
自 2023 年 9 月 20 日起，您將無法建立新的個人化資源。 個人化服務將於 2026 年 10 月 1 日正式停用。 我們建議遷移到開源的 Microsoft/learning-loop。
新手模式使您對 Personalizer 服務及其機器學習功能更加信任和放心，也確保傳送給服務的資訊能被學習，且不會對線上流量構成風險。
設定新手模式
登入 Azure 入口網站，取得您的個人化資源。
在 [設定] 頁面的 [模型設定] 索引標籤上，選取 [新手模式]，然後選取 [儲存]。
對現有應用程式的變更
您現有的應用程式不應變更其目前選取要顯示哪些動作的方式，或應用程式如何判斷價值 (該動作的獎勵) 的方式。 對應用程式的唯一變更可能是發送至 Personalizer Rank API 的操作順序。 您應用程式目前所顯示的動作會以動作清單中的「第一個動作」來傳送。 排名 API會使用第一個動作來定型您的個人化工具模型。
設定您的應用程式來呼叫排名 API
為了將個人化工具新增至您的應用程式，您需要呼叫排名和獎勵 API。
在現有應用程式邏輯中判斷動作清單及其特徵的時間點之後，新增排名 API 呼叫。 動作清單中的第一個動作必須是您現有邏輯所選取的動作。
設定您的程式碼，以顯示與排名 API 回應的獎勵動作識別碼相關聯的動作。
設定您的應用程式來呼叫獎勵 API
注意
處於新手模式時，獎勵 API 呼叫不會影響訓練。 服務會藉由比對您應用程式的目前邏輯或預設動作來學習。 不過在這個階段實施獎勵通話，確實有助於確保日後透過 Azure 入口網站中簡單切換，順利轉換到線上模式。 此外，系統將會記錄獎勵，讓您分析目前邏輯的執行程度，以及收到多少獎勵。
使用您現有的商務邏輯來計算所顯示動作的獎勵。 此值必須在 0 到 1 的範圍內。 使用獎勵 API 將此獎勵傳送至個人化工具。 不會立即期望獎勵值，並且其可以延遲一段時間，視您的商務邏輯而定。
如果您未在設定的 [獎勵等候時間] 內傳回獎勵，則會改為記錄預設獎勵。
評估學徒模式
在 Azure 入口網站的 Monitor 頁面，檢視您的 Personalizer 資源的 匹配效能。
新手模式提供下列評估計量：
- 基準 – 平均獎勵：應用程式預設值的平均獎勵 (基準)。
- 個人化工具–平均獎勵：個人化工具可能已達到的總獎勵平均值。
- 最新 1000 個事件的獎勵成就率：基準和個人化工具獎勵的比率 – 已對最新 1000 個事件進行標準化。
將行為切換至線上模式
當您確定個人化工具已訓練到滾動平均值維持在 75% 至 85% 之間時，模型便已準備好切換到線上模式。
在 Azure 入口網站中，進入您的 Personalizer 資源，在Setup頁面的Model settings分頁中，選擇 *Online mode，然後選擇儲存。
您不需要對排名和獎勵 API 呼叫進行任何變更。