自定义召回支持第三方服务API
更新时间：2025-07-28
自定义召回支持第三方服务API功能说明
支持业务方通过标准化的接口接入外部数据，将第三方数据生成的候选集与系统内置召回融合，实现多源异构召回能力的灵活扩展。
该功能适用于以下场景：
1、补充召回源：集成垂直领域服务（如实时新闻API），覆盖系统未触达的长尾内容。
2、动态数据调整：通过外部实时计算物料数据。
二、接口对接示例
请求示例
HTTP方法：POST
请求URL：http://{ip:port}/{serviceName}/{apiName}
1、输入规范样例
| 参数 | 类型 | 示例 | 说明 |
|---|---|---|---|
user_info |
dict | {"uid": 10, "query", "测试"} |
个性化推荐、相关推荐、智能搜索、猜你想搜uid必填，其余非必需；智能搜索、联想词、相关搜索query为必填 |
req_cnt |
int | 10 |
需要返回的召回物料个数 |
trace_id |
str | "213987372302138" |
traceid为必填项 |
2、输出规范样例
| 参数 | 类型 | 示例 | 说明 |
|---|---|---|---|
recall_item_list |
list | [{"nid": "xxx", "score": 1.0}] |
每个包含两个属性，nid、score为必填项 |
3、请求示例
- 请求示例
Python
1{
2 "user_info": {
3 "uid": "uid_1",
4 "hist_rec": [
5 "193"
6 ],
7 "query": "x",
8 "channels": [
9 ""
10 ],
11 "_timestamp": "1745821017000",
12 "filter": "{\"bool\": {\"must\": [{\"term\": {\"status\": 1}}, {\"range\": {\"expire_time\": {\"gt\": 1745821017000}}}]}}",
13 "cur_city": ""
14 },
15 "req_cnt": 38,
16 "trace_id": "237794112466636887852941159840767345765-8nqpx"
17}- 返回示例
Python
1{
2 "recall_item_list":[
3 {
4 "score":1.0,
5 "nid":"1"
6 },
7 {
8 "score":0.9,
9 "nid":"2"
10 }
11}三、注意事项
1、数据合规：第三方结果需符合内容安全规范，禁止返回违禁内容。
2、字段对齐：需与系统内容库映射，避免重复或无效ID。