创建在线服务需要配置三个环节：召回策略、排序策略、业务规则，建议一个完整的在线服务三个环节都进行配置。也可支持选择部分环节进行配置。

召回策略

召回规则可选择在【策略管理】-【召回策略】中已经发布成功的内置召回和自定义召回，每个召回规则需要配置权重、召回数量、保送数量以及整体的召回数量；此外，自定义召回还需选择参数文件（非必选）。

• 每路召回权重&召回数量：权重和召回数量，共同影响该路召回进入召回合并阶段的数量。参数配置要求是大于0的正整数。
• 召回保送：开启后对应召回规则的结果将直接进入精排，不再需要经过召回合并及粗排。通常在物品需要保量时使用，详见：通过保量功能，提高冷启动物品的推荐精准度。
• 保送数量：指保送进精排的结果数量，保送数量不能超过召回数量。
• 召回数量：所有召回策略召回数量合并后最终召回的总数。若整体召回数量大于上述所选召回策略的召回数量总和，则返回所有召回结果；若整体召回数量小于上述所选召回策略的召回数量总和，则按照此处设置的整体召回数量返回召回结果。此处设置的数量不包含保送的数量。
• 参数文件：自定义召回在该在线服务中生效的参数配置。

如果不启动平台的召回策略，但是使用了平台的排序/规则，需要在在线请求时将用户的召回结果回传，回传后的物品将会按照平台的排序/规则等功能进行干预，否则将会出现在线请求返回为空的情况。

您也可以将自定义的召回和平台配置的召回结合使用。二者融合的逻辑如下：

• 召回环节：
  • 平台配置的召回按照权重和数量进行 merge，自定义召回的 item 不参与 merge。
  • 平台配置的“整体召回数量”包括自定义召回数量。
  • 平台召回/自定义召回的 item 在进入排序前都会进行过滤，包含平台配置的过滤规则、以及接口传入的filterItems。
• 排序：自定义召回的 item 直接进入粗排（如没有粗排则直接进精排），且顺序在最前面。

排序策略

排序是将召回的商品通过模型进行重新排序，排序策略分为精排、粗排两种，排序策略使用的模型是模型管理中创建的，自建模型可参考模型开发流程。
排序策略可以选择多个模型，多个模型通过排序参数实现模型得分的融合。
粗排数量指的是出粗排进精排的物品数量，注意：

• 包含保送物品的数量。
• 若配置了召回保送，但没有开启精排策略，那么召回保送的物品会在正常物品粗排后，插入到最前面，一起进入规则环节。

业务规则

此环节需要选用在【策略管理】-【业务规则】中创建好的业务规则，包括内置规则和自定义规则。
选择内置规则请注意：

• 不可选择两个配置完全相同的规则。
• 注意选择规则存在的依赖：
  • 选择保量规则，要求先在【召回策略】中选择该规则依赖的召回。
  • 选择打散规则，如果该规则对召回/保量规则进行打散，则要求先在【召回策略】中选择该规则依赖的召回，或在【业务规则】中选择该规则依赖的保量规则。
  • 选择加权规则，如果该规则对召回规则进行加权，则要求先在【召回策略】中选择该规则依赖的召回。

选择自定义规则请注意：

• 每类自定义规则，即自定义过滤、自定义重排、自定义返回字段分别仅支持添加一个。
• 请注意自定义规则可能会与平台配置的规则冲突，请自行保证正确性。

在线服务内置规则和自定义规则可以一起使用，其生效的顺序为：
召回—>召回合并&过滤—>自定义过滤—>粗排—>精排—>内置规则—>自定义重排—>自定义返回字段

此外，针对保底策略平台目前仅支持默认保底规则，即当前请求的场景（spm）出现服务异常时，将使用该 spm 下点击高热的 5000 条行为记录作为兜底结果来源。勾选则平台会在服务异常时做兜底，否则平台不进行兜底，API 直接报错。

关闭个性化推荐功能
智能推荐平台支持终端关闭个性化推荐功能，通过在推荐 API 接口请求消息中携带 ClosePersonalizedRecommend 参数表示是否关闭个性化推荐功能。

• 当 ClosePersonalizedRecommend=false 或者不携带该参数时，和当前推荐流程一致。
• 当 ClosePersonalizedRecommend=true 时，表示关闭个性化推荐。此时，在线服务的召回、排序、过滤&规则生效机制产生变更。
  • 召回：
    • 内置召回仅可使用高热召回（包括父物品高热），其他内置召回均不生效。
    • 推荐 API 接口传入召回（candidateItems）：生效。
    • 自定义召回：需要用户在代码中写当个性化推荐开关为 true 时，当前召回是否生效的逻辑。
  • 排序：粗排和精排均跳过不生效。
  • 过滤&规则：
    • merge 后的 item 全部进入业务规则流程。
    • 内置过滤、内置规则：生效。
    • 推荐 API 接口传入过滤（filterItems）：生效。
    • 自定义过滤、自定义排序公式、自定义规则：需要用户在代码中写当个性化推荐开关为 true 时，当前过滤、排序、规则是否跳过的逻辑。

一个栏位下只能有一个在线服务。在在线服务列表，可以对某个版本的在线服务进行编辑、复制、上线/下线、删除等操作。

• 编辑：待上线、上线失败的服务版本允许编辑，已上线、上线中、下线中、已下线的版本不允许编辑。
• 复制：为保证线上服务稳定性，已上线的版本不允许直接编辑。如果希望更改线上配置，可以通过【复制已上线的版本-生成新版本-在新版本基础上进行修改-上线新版本】的方式，替换掉当前线上版本的配置。
• 删除：待上线、上线失败、已下线的服务版本允许删除，已上线、上线中、下线中的版本不允许删除。删除操作不可恢复，请谨慎使用。
• 上线/下线：
  • 待上线、上线失败、已下线的服务版本允许上线，在线服务上线后，即可通过调用推荐API可获取推荐结果；已上线的版本允许下线。
  • 对于已上线的版本进行下线操作时，会导致在线请求无结果的情况。如果不是该栏位弃用，建议不要进行在线服务下线操作。
  • 同一个应用下，只能同时有一个在线服务版本操作上线或下线。