管理模型

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

注意： 模型管理功能僅適用於建議。

調整模型

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

調整作業需要 2 到 4 天，期間模型仍可正常運作。 如要瞭解微調費用詳情，請參閱「定價」頁面。

設定模型的微調頻率

建議您定期調整模型。這樣一來，模型訓練就能隨著資料變化和顧客行為差異，在一年內保持最佳狀態。此外，部分內部主要模型升級只能在模型經過微調後套用。

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

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

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

主控台

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

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

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 控制台的「模型」頁面。
   
   前往「模型」頁面

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 控制台的「模型」頁面。
   
   前往「模型」頁面

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

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

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

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 控制台的「模型」頁面。
   
   前往「模型」頁面

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

3. 按一下模型名稱，即可查看「詳細資料」頁面。

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 控制台的「模型」頁面。
   
   前往「模型」頁面

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

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 控制台的「模型」頁面。
   
   前往「模型」頁面

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'