创建投放配置

本页面介绍如何创建服务配置。服务配置是一种模型实体,它关联模型或一组用于生成搜索或建议结果的控件。如需详细了解服务配置,请参阅关于服务配置

准备工作

建议和服务搜索配置具有不同的要求和选项:

  • 建议服务配置需要模型。如果您计划将现有模型附加到新的服务配置,请获取您计划使用的模型的 ID(使用 ServingConfig.create 方法时需要此 ID)。

    如果使用控制台创建服务配置,您可以在创建过程中创建新模型,而不是附加现有模型。

    您可以稍后切换模型,只要它是同一模型类型即可。

  • 搜索可以使用服务控件,但不是必需的。如果您计划将现有控件附加到新的服务配置,请获取您计划使用的控件的 ID。

    如果使用控制台创建服务配置,您还可以在创建过程中创建新控件。

    创建服务配置后,您可以切换或向服务配置添加服务控件。

创建服务配置

您可以使用以下方式创建服务配置:

每个目录最多允许 100 个服务配置。

搜索适用于未配置的服务配置。任何 serving_config_id 都可以作为搜索请求的一部分放置,此 default_search 将使用 AI Commerce Search 默认搜索功能搜索目录。

如果您已有展示位置,或创建新的展示位置,系统会自动创建与每个展示位置关联的服务配置。 创建服务配置不会创建相应的展示位置。删除服务配置会删除其相应的展示位置,而删除展示位置将会删除其相应的服务配置。

在控制台中创建服务配置

在 Gemini Enterprise for Customer Experience 控制台中的 AI Commerce Search 的“服务配置”页面上添加新的服务配置。

如需创建新的服务配置,请执行以下操作:

  1. 在 Gemini Enterprise for Customer Experience 控制台中的 AI Commerce Search 中,前往服务配置 页面。

    前往“服务配置”页面

  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:必填。在 Gemini Enterprise for Customer Experience 控制台中的 AI Commerce Search 中显示的易读 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:必填。在 Gemini Enterprise for Customer Experience 控制台中的 AI Commerce Search 中显示的易读 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"
  

后续步骤