创建服务配置

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

准备工作

推荐和搜索服务配置有不同的要求和选项：

推荐服务配置需要模型。如果您计划将现有模型附加到新的服务配置，请获取您计划使用的模型的 ID（使用 ServingConfig.create 方法时需要此 ID）。

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

您日后可以切换模型，前提是切换后的模型与之前的模型类型相同。
搜索可以使用投放控制，但不是必需的。如果您计划将现有控件附加到新的服务配置，请获取您计划使用的控件的 ID。

如果使用控制台创建投放配置，您还可以在创建过程中创建新的控制变量。

创建投放配置后，您可以切换或添加投放控件。

创建服务配置

您可以使用以下方法创建投放配置：

Search for Commerce 控制台。
ServingConfig.create API。

每个目录最多允许有 100 个投放配置。

搜索功能可与未配置的服务配置搭配使用。任何 serving_config_id 都可以作为搜索请求的一部分放置，并且此 default_search 将使用 Vertex AI Search for Commerce 的默认搜索功能搜索目录。

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

在控制台中创建服务配置

在 Search for Commerce 控制台中的“投放配置”页面上添加新的投放配置。

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

前往商业搜索控制台中的投放配置页面。

前往“投放配置”页面
点击 创建投放配置。
建议
1. 选择建议作为服务配置的商品。
2. 为您的投放配置提供名称。
  
  名称不得超过 1024 个字符，并且只能包含字母数字字符、下划线、连字符、空格。
3. 可选：如果需要，请更新 ID。
  
  该 ID 通过您提供的名称生成，并且在项目中必须是唯一的。名称不能超过 50 个字符，并且不能包含空格。
4. 选择或创建您希望此服务配置为之提供建议的模型。
  
  详细了解如何创建新模型。
5. 选择价格重排序应会对推荐结果的影响程度（如果所选模型支持此功能）。
  
  启用这项功能后，推荐概率相近的推荐产品会按价格进行排序，价格最高的商品列在第一位。相关性仍会用于订购商品，因此启用价格重排序与按价格排序不同。
6. 选择是使用基于规则的结果多样化还是基于数据的结果多样化：
  - 基于规则：基于规则的结果多样化会影响单个预测请求返回的结果是否来自产品目录的不同类别。
  - 数据驱动：数据驱动的结果多样化使用机器学习来平衡预测结果中的类别多样性与相关性。
  如需了解详情，请参阅结果多样化。
7. 选择建议结果的多样化程度。
8. 如果您为此服务配置选择了“类似商品”模型，请选择是否启用类别匹配。
  
  启用类别匹配后，返回的商品结果仅为与上下文商品共享至少一个类别的商品。类别匹配可以与其他过滤选项（例如价格、供应情况和过滤标记）结合使用。
搜索
1. 在创建服务配置页面上，选择搜索作为服务配置的商品。
2. 为您的投放配置提供一个名称。
  
  名称不得超过 1024 个字符，并且只能包含字母数字字符、下划线、连字符、空格。
3. 可选：如果需要，请更新 ID。
  
  该 ID 通过您提供的名称生成，并且在项目中必须是唯一的。名称不能超过 50 个字符，并且不能包含空格。
4. 点击继续。
5. 选择是否为此投放配置启用动态构面。
6. 选择或创建服务控件来优化搜索。
  
  如需详细了解控件，请参阅创建和管理控件。
点击创建，以新建配置文件。

新配置会显示在“投放配置”页面中。

配置可能需要几分钟才能用于搜索请求。它可以立即用于推荐。
可选：在“投放配置”页面上，点击投放配置名称并转到其评估标签页，以预览为此配置返回的产品。

评估预览可帮助您确认配置是否按预期运行。

使用 `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-raranking、medium-price-reranking 和 high-price-reranking。
diversityLevel：可选。设置建议结果的多样化程度。允许的值包括 no-diversity（默认值）、low-diversity、medium-diversity、high-diversity 和 auto-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"

后续步骤

从新的展示位置请求预测。

创建服务配置 使用集合让一切井井有条 根据您的偏好保存内容并对其进行分类。

准备工作

创建服务配置

在控制台中创建服务配置

建议

搜索

使用 ServingConfig.create 创建服务配置

建议

搜索

后续步骤

创建服务配置

使用 `ServingConfig.create` 创建服务配置