管理模型

本頁說明如何調整、暫停、繼續、刪除及列出推薦模型。如需建立新推薦模型的說明，請參閱「建立推薦模型」。

調整模型

商家適用的 Vertex AI Search 會使用您提供給模型的輸入資料，調整訓練超參數。

調整作業需要 2 到 4 天，期間模型會照常運作。 如需調校費用詳細資訊，請參閱「定價」一節。

設定模型的調校頻率

建議您定期調整模型。由於資料會隨時間變化，而顧客行為也會有所不同，因此這有助於維持模型訓練的最佳狀態。此外，部分內部主要模型升級作業只能在模型經過調整後才能套用。

建立模型時，您可以設定每三個月自動調整一次，或選擇只手動調整。無論您選擇哪種設定，模型在建立後都會自動進行一次調整。

您隨時可以變更調音狀態設定。變更這項設定不會影響目前執行中的調整程序。

如何編輯模型的微調狀態設定：

主控台

  1. 前往 Search for Commerce 控制台的「Models」頁面。

    前往「Models」(模型) 頁面

    您可以在「調校狀態」下方查看每個模型的調校狀態。

  2. 按一下模型名稱，查看詳細資料頁面。

  3. 按一下「調校狀態」旁的「編輯」圖示 。

  4. 從下拉式清單中選取所需設定：

    • 每三個月。上次調整時間距今已 90 天，系統就會自動調整。
    • 僅限手動調整。只有在手動調整時才會調整。

  5. 按一下「完成」 即可儲存設定。

curl

使用 API 提出 Models.patch 要求。請參閱 Models.patch API 參考資料。

如要進一步瞭解所有 Models 欄位，請參閱 Models API 參考資料。

curl -X PATCH \
-H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
-H "Content-Type: application/json; charset=utf-8" \
-d '{
  "name": "projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/models/MODEL_ID",
  "PeriodicTuningState": "NEW_TUNING_STATE_VALUE"
}' \
'https://retail.googleapis.com/v2/projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/models/MODEL_ID?updateMask=PeriodicTuningState'

手動調整模型

手動調整會觸發模型的一次性調整作業。當目錄發生重大變更 (例如目錄階層的大小增加或變更) 或事件 (例如回填歷來事件，或在宣傳特定項目群組後資料分發方式發生變更) 時，您可能需要手動調整模型。

如要手動調整模型，請按照下列步驟操作：

主控台

  1. 前往「Search for commerce」控制台的「Models」頁面。

    前往「Models」(模型) 頁面

  2. 按一下模型名稱，查看詳細資料頁面。

  3. 按一下按鈕列中的「手動調整」。

    調整作業需要 2 到 4 天，期間模型會照常運作。

curl

使用 API 提出 Models.tune 要求。請參閱 Models.tune API 參考資料。

curl -X POST \
-H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
-H "Content-Type: application/json; charset=utf-8" \
'https://retail.googleapis.com/v2/projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/models/MODEL_ID:tune'

暫停及繼續訓練模型

如果模型處於啟用狀態 (未暫停)，則會至少每週重新訓練一次，但不會超過每天一次。為確保持續重新訓練，請務必在事件發生後 24 小時內上傳使用者事件資料。

您可以暫停模型，停止重新訓練。如果您匯入了錯誤資料，或是希望每個專案的有效模型數量不超過 10 個，建議您執行這項操作。如果您有效的模型少於 10 個，隨時可以重新啟動已暫停的模型。

如要瞭解訓練費用的詳細資訊，請參閱定價。

每分鐘最多可以啟動五個模型作業。模型作業以建立、刪除、暫停和繼續作業為限。

如要暫停或重新啟動模型，請按照下列步驟操作：

主控台

  1. 前往 Search for Commerce 控制台的「Models」頁面。

    前往「Models」(模型) 頁面

    您可以在「訓練狀態」下方查看每個模型的訓練狀態。

  2. 如要暫停正在訓練的模型 (TRAINING 的訓練狀態)，請按一下「暫停」圖示 。

  3. 如要啟動已暫停的模型 (訓練狀態為「PAUSED」)，請按一下「Resume」圖示 。

curl

如要暫停運作的模型，請使用 API 提出 Models.pause 要求。請參閱 Models.pause API 參考資料。

curl -X POST \
-H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
-H "Content-Type: application/json; charset=utf-8" \
'https://retail.googleapis.com/v2/projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/models/MODEL_ID:pause'

如要啟動已暫停的模型，請使用 API 提出 Models.resume 要求。

curl -X POST \
-H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
-H "Content-Type: application/json; charset=utf-8" \
'https://retail.googleapis.com/v2/projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/models/MODEL_ID:resume'

查看模型詳細資料

您可以在控制台中查看模型詳細資料，也可以使用 Models.get API 方法。

如要查看與特定模型相關聯的供應設定，請使用下列控制台程序。控制台和 API 回應都會提供所有其他模型詳細資料。

主控台

  1. 前往「Search for commerce」控制台的「Models」頁面。

    前往「Models」(模型) 頁面

  2. 「Models」頁面會列出所有模型，以及訓練和查詢狀態。

  3. 按一下模型名稱，查看「Details」頁面。

curl

如要取得單一模型的資訊，請使用 API 提出 Models.get 要求。請參閱 Models.get API 參考資料。

curl -X GET \
-H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
-H "Content-Type: application/json; charset=utf-8" \
'https://retail.googleapis.com/v2/projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/models/MODEL_ID'

列出模型

您可以在控制台或使用 Models.list API 方法查看模型清單。

主控台

  1. 前往「Search for commerce」控制台的「Models」頁面。

    前往「Models」(模型) 頁面

  2. 「Models」頁面會列出所有模型，以及訓練和查詢狀態。

curl

如要列出所有模型及其詳細資料，請使用 API 發出 Models.list 要求。請參閱 Models.list API 參考資料。

您可以選擇使用 pageSize 參數，設定要傳回的結果數量上限。如果有更多結果，list 回應就會包含頁面符記。您可以在 list 要求的 pageToken 參數中傳遞分頁符記，以便擷取下一頁的結果。以下範例會使用這兩個參數。

curl -X GET \
-H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
-H "Content-Type: application/json; charset=utf-8" \
'https://retail.googleapis.com/v2/projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/models?pageSize=PAGE_SIZE&pageToken=PAGE_TOKEN'

刪除模型

每分鐘最多可以啟動五個模型作業。模型作業以建立、刪除、暫停和繼續作業為限。

在控制台中刪除模型，或使用 Models.delete API 方法。

主控台

  1. 前往「Search for commerce」控制台的「Models」頁面。

    前往「Models」(模型) 頁面

  2. 按一下要刪除的模型名稱，開啟模型詳細資料頁面。

  3. 按一下按鈕列中的「刪除」圖示 。

  4. 重新輸入模型名稱，然後按一下「確認」。

curl

使用 API 提出 Models.delete 要求。請參閱 Models.delete API 參考資料。

如要進一步瞭解所有 Models 欄位，請參閱 Models API 參考資料。

curl -X DELETE \
-H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
-H "Content-Type: application/json; charset=utf-8" \
'https://retail.googleapis.com/v2/projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/models/MODEL_ID'