服务调试

服务调试功能可以方便用户测试自己的服务返回结果是否符合预期,服务调试功能的参数格式参见BeRead

参数详情

服务调试功能的参数格式参见BeRead

召回物品数量

召回返回的总doc个数,详见请求参数return_count。

当召回结果集超过return_count时,会按照doc得分返回前return_count个数的doc。

triggerList

召回的trigger列表,详见请求参数trigger_list。

x2i example

trigger_key:1,trigger_key2:1.5
// 召回trigger_key1关联的物品,关联物品的得分乘以权重1,召回trigger_key2关联的物品,关联物品的得分乘以权重1.5

vector example

-0.5430353283882141,-0.0292476424574852,-0.3608616292476654;-0.35043397545814514,-0.23355364799499512,-0.24787241220474243
// 召回向量(-0.5430353283882141,-0.0292476424574852,-0.3608616292476654),(-0.35043397545814514,-0.23355364799499512,-0.24787241220474243)距离最近的物品

过滤规则

对召回结果进行过滤的条件表达式,详见请求参数filter_rule。

example

score>1.0
// 过滤score值大于1.0的doc

score>1.0 AND city='hangzhou'
// 过滤score值大于1.0,并且city为“hangzhou”的doc

score>1.0 AND (city='hangzhou' OR city='beijing')
// 过滤score值大于1.0,并且city为“hangzhou”或“beijing”的doc

查询示例

上图中过滤条件返回了field1值为100,field2值为714或338的两条数据。

打分规则

对召回结果进行打分的表达式,详见请求参数score_rule参数。

x2i example

score*weight*2
// 使用召回表中score字段的值,乘以weight字段的值,乘以2得到最终得分。

vector example

match_score*weight*2
// 使用向量距离得分match_score的值,乘以weight字段的值,再乘以2得到最终的得分,其中match_score为计算得到的向量距离得分。

查询示例

image.png

上图中定义打分规则为weight字段的值。

userId

对于配置了行为过滤的biz,添加该参数会从行为表中找到user_id对应的item_id列表,从召回结果中过滤掉。

详情见请求参数user_id。

example

user1,user2
// 从行为表中,找出user1、user2关联物品,从召回结果中过滤掉

子召回截断数量

多路召回每一路召回的截断数量。详情见请求参数return_count参数。

单路/多路区分

单路召回和多路召回的参数基本一致,区别是多路召回的每一路子召回都有自己的召回截断数、打分规则、triggerList,以召回链路名称为前缀。