建立供應設定

本頁說明如何建立服務設定。供應設定是一個供應實體,可與模型或一組控制項建立關聯,用於產生搜尋或建議結果。如要進一步瞭解供應設定,請參閱「關於供應設定」。

事前準備

建議和搜尋供應設定有不同的需求和選項:

  • 建議供應設定需要模型。如要將現有模型附加至新的服務設定,請取得要使用的模型 ID (使用 ServingConfig.create 方法時必須提供)。

    如果使用主控台建立服務設定,您可以在建立程序中建立新模型,不必附加現有模型。

    只要是相同類型的模型,您之後可以隨時切換。

  • 搜尋功能可以使用供應控制項,但並非必要。如要將現有控制項附加至新的放送設定,請取得您打算使用的控制項 ID。

    如果使用控制台建立放送設定,您也可以在建立過程中建立新控制項。

    建立供應設定後,您可以切換或新增供應控管機制。

建立供應設定

您可以使用下列方式建立供應設定:

每個目錄最多可有 100 項放送設定。

搜尋功能可搭配未設定的供應設定使用。任何 serving_config_id 都可以做為搜尋要求的一部分,而這項 default_search 會使用 Vertex AI Search for Commerce 的預設搜尋功能搜尋目錄。

如果您有現有刊登位置,或是建立新的刊登位置,系統會自動建立與每個刊登位置相關聯的放送設定。建立供應設定不會建立相應的刊登位置。刪除供應設定會一併刪除相應的顯示位置,刪除顯示位置也會一併刪除相應的供應設定。

在控制台中建立供應設定

在 Search for Commerce 控制台的「供應設定」頁面新增供應設定。

如要建立新的供應設定,請按照下列步驟操作:

  1. 前往 Search for commerce 控制台的「Serving Configs」(放送設定) 頁面。

    前往「Serving configs」(放送設定) 頁面

  2. 按一下「建立供應設定」

    建議做法

    1. 選取「建議」做為供應設定的適用產品。

    2. 提供供應設定名稱。

      名稱不得超過 1024 個字元,且只能包含英數字元、底線、連字號和空格。

    3. 選用:視需要更新 ID。

      ID 是根據您提供的名稱產生,且在整個專案中不得重複。長度不得超過 50 個字元,且不得包含空格。

    4. 選擇或建立要使用這項供應設定提供建議的模型。

      進一步瞭解如何建立新模型。

    5. 如果所選模型支援價格重新排序,請選取價格重新排序對建議結果的影響程度。

      如果啟用價格重新排序,系統就會將推薦機率相近的推薦產品按照價格由高至低排序。系統仍會根據關聯性排序項目,因此啟用價格重新排序功能並不等同於依價格排序。

    6. 選取要使用以規則為準或以資料為準的結果多樣化功能:

      • 以規則為準:以規則為準的結果多樣化功能會影響單一預測要求傳回的結果是否來自產品目錄中的不同類別。

      • 以資料為準:以資料為準的結果多樣化功能會運用機器學習技術,在預測結果中平衡類別多元性與關聯性。

      詳情請參閱「結果多樣性」一節。

    7. 選取建議結果的多樣化程度。

    8. 如果為這項供應設定選取「類似項目」模型,請選取是否啟用類別比對。

      啟用類別比對後,系統只會傳回與內容產品共用至少一個類別的產品結果。類別比對可與其他篩選選項搭配使用,例如價格、供應情形和篩選標記。

    1. 在「建立供應設定」頁面中,選擇「搜尋」做為供應設定的適用產品。
    2. 為放送設定命名。

      名稱長度不得超過 1024 個字元,且只能包含英數字元、底線、連字號和空格。
    3. 選用:視需要更新 ID。

      ID 是根據您提供的名稱產生,且在整個專案中不得重複。長度不得超過 50 個字元,且不得包含空格。
    4. 按一下「繼續」
    5. 選擇是否要為這項供應設定啟用動態切面。
    6. 選擇或建立放送控制項,以利搜尋最佳化。

      如要進一步瞭解控制項,請參閱建立及管理控制項
  3. 按一下「建立」即可建立新設定。

    新設定會顯示在「服務設定」頁面中。

    設定可能需要幾分鐘才會生效,並用於搜尋要求。並立即提供最佳化建議。

  4. 選用:在「放送設定」頁面中,按一下放送設定名稱,然後前往「評估」分頁,預覽這項設定會傳回的產品。

    評估預覽功能可協助您確認設定是否符合預期。

使用 ServingConfig.create 建立供應設定

您可以使用 ServingConfig.create API 方法建立提供設定。如要查看這個方法的 API 參考說明文件,請參閱 ServingConfig.create

您使用的欄位取決於要為建議或搜尋功能建立供應設定。

如要進一步瞭解 ServingConfig 欄位,請參閱 ServingConfigs API 參考資料

建議做法

提出 ServingConfig.create 要求,要求主體中包含放送設定 ID 和 ServingConfig 執行個體。

  • servingConfigId:必填。為 ServingConfig 建立 ID。這個值的長度應為 4 至 63 個字元。有效字元為 /[a-z][0-9]-_/
  • displayName:必填。在 Search for commerce 控制台中顯示的易讀ServingConfig名稱。
  • modelID:必填。在放送時使用的模型 ID。
  • priceRerankingLevel:選用。設定價格重新排序對建議結果的影響程度。允許的值為 no-price-reranking (如未設定,則為預設值)、low-price-rarankingmedium-price-rerankinghigh-price-reranking
  • diversityLevel:選用。設定建議結果的多樣化程度。允許的值為 no-diversity (預設值)、low-diversitymedium-diversityhigh-diversityauto-diversity。如果未設定 diversityLevel,系統會停用多樣性功能。
  • diversityType:選用。設為 RULE_BASED_DIVERSITY,即可根據產品類別,讓推薦結果更多元。設為DATA_DRIVEN_DIVERSITY:根據產品中繼資料的學習結果,在關聯性和類別多元性之間取得平衡,進而提供多元的推薦內容。如果已設定 diversityLevel,但未設定 diversityType,則 diversityType 預設為以規則為準。詳情請參閱結果多樣性
  • enableCategoryFilterLevel:選用。設定是否要在「類似商品」模型中新增其他類別篩選器。允許的值為 relaxed-category-match (如未設定,則為預設值) 和 no-category-match
  • solutionTypes:必填。針對建議供應設定,設為 SOLUTION_TYPE_RECOMMENDATION
curl -X POST \
     -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     --data '{
              "displayName": "DISPLAY_NAME",
              "modelId": "MODEL_ID",
              "priceRerankingLevel": "PRICE_RERANKING_LEVEL",
              "diversityType": "DIVERSITY_TYPE",
              "diversityLevel": "DIVERSITY_LEVEL",
              "enableCategoryFilterLevel": "CATEGORY_FILTER_LEVEL",
              "solutionTypes": [ "SOLUTION_TYPE_RECOMMENDATION" ]
            }' \
    "https://retail.googleapis.com/v2/projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/servingConfigs?servingConfigId=SERVING_CONFIG_ID"
  

搜尋

提出 ServingConfig.create 要求,要求主體中包含放送設定 ID 和 ServingConfig 執行個體。

  • servingConfigId:必填。為 ServingConfig 建立 ID。這個值的長度應為 4 至 63 個字元。有效字元為 /[a-z][0-9]-_/
  • displayName:必填。在 Search for commerce 控制台中顯示的易讀ServingConfig名稱。
  • facetControlIds:選用。僅設定 FacetSpec 的控制項 ID。
  • dynamicFacetSpec.mode:選用。DynamicFacet 功能的模式。 允許的值為 DISABLED (如未設定,則為預設值) 和 ENABLED
  • boostControlIds:選用。升幅放送控制項的 ID。
  • filterControlIds:選用。篩選器放送控制項的 ID。
  • redirectControlIds:選用。重新導向放送控制項的 ID。
  • twowaySynonymsControlIds:選用。雙向同義詞放送控制項的 ID。
  • onewaySynonymsControlIds:選用。單向同義詞放送控制項的 ID。
  • doNotAssociateControlIds:選用。請勿建立關聯的放送控制項 ID。
  • replacementControlIds:選用。替代供應控制項的 ID。
  • ignoreControlIds:選用。要忽略放送控制項的 ID。
  • solutionTypes:必填。設為 SOLUTION_TYPE_SEARCH,適用於搜尋供應設定。
curl -X POST \
     -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     --data '{
              "displayName": DISPLAY_NAME,
              "facetControlIds": [
                "FACET_CONTROL_ID_1",
                "FACET_CONTROL_ID_2"
              ],
              "dynamicFacetSpec": {
                "mode": "DYNAMIC_FACET_MODE"
              },
              "boostControlIds": [
                "BOOST_CONTROL_ID_1",
                "BOOST_CONTROL_ID_2"
              ],
              "filterControlIds": [
                "FILTER_CONTROL_ID_1",
                "FILTER_CONTROL_ID_2"
              ],
              "redirectControlIds": [
                "REDIRECT_CONTROL_ID_1",
                "REDIRECT_CONTROL_ID_2"
              ],
              "twowaySynonymsControlIds": [
                "TWO_WAY_SYNONYM_CONTROL_ID_1",
                "TWO_WAY_SYNONYM_CONTROL_ID_2"
              ],
              "onewaySynonymsControlIds": [
                "ONE_WAY_SYNONYM_CONTROL_ID_1",
                "ONE_WAY_SYNONYM_CONTROL_ID_2"
              ],
              "doNotAssociateControlIds": [
                "DO_NOT_ASSOCIATE_CONTROL_ID_1",
                "DO_NOT_ASSOCIATE_CONTROL_ID_2"
              ],
              "replacementControlIds": [
                "REPLACEMENT_CONTROL_ID_1",
                "REPLACEMENT_CONTROL_ID_2"
              ],
              "ignoreControlIds": [
                "IGNORE_CONTROL_ID_1",
                "IGNORE_CONTROL_ID_2"
              ],
              "solutionTypes": [ "SOLUTION_TYPE_SEARCH" ]
    }' \
    "https://retail.googleapis.com/v2/projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/servingConfigs?servingConfigId=SERVING_CONFIG_ID"
  

後續步驟