Artificial Intelligence Recommendation：Recommendation Engine介面調用

介面說明

POST /api/rec/feed

請求參數

item_list

當有一批召回的資料，希望通過介面傳遞進來，可以賦值給 item_list。 item_list 是一個數組，每個 item 是 map object ，item 中必須有 item_id 欄位，表示物品的ID。其餘都是可選的。 item 中如果包含 score 欄位，會當成召回得分處理。其餘欄位當成 item 屬性進行處理。

complex_type_features

複雜類型的上下文特徵需要數組傳遞過來，每個元素包含的內容如下：

使用樣本：

1. 傳遞單個值，[{"name":"age", "type":"int", "values":20}, {"name":"sex", "values":"male", "type":"string"}]

2. 傳遞數組[{"name":"list_features", "type":"list<int>", "values":[1,2,3]}]

3. 傳遞map[{"name":"map_features", "type":"map<int,int>", "values":{"1":10,"2":20,"3":30}}], 或者[{"name":"map_features", "type":"map<int,int>", "values":{"1":"10","2":"20","3":"30"}}],

type 支援的類型包括int,int64,float,double,string,list<int>,list<int64>,list<float>,list<double>,list<string>,map<int,int>,map<int,int64>,map<int,float>,map<int,double>,map<int,string>,map<string,int>,map<string,int64>,map<string,float>,map<string,double>,map<string,string>,map<int64,int>,map<int64,int64>,map<int64,float>,map<int64,double>,map<int64,string>

註：傳遞上下文中， complex_type_features 和 features 可以同時使用。

介面返回

items 條目具體說明如下：

錯誤碼說明

配置及調用樣本

這裡我們用上下文召回舉例，上下文召回是通過介面傳入召回列表，引擎配置如下，情境這裡我們用home_feed舉例：

{
  "RunMode": "product",
  "ListenConf": {
    "HttpAddr": "",
    "HttpPort": 8000
  },
  "SortNames": {
    "default": ["ItemRankScore"]
  },
  "FilterNames": {
    "default": ["UniqueFilter"]
  },
  "SceneConfs": {
    "home_feed": {
      "default": {
        "RecallNames": ["ContextItemRecall"]
      }
    }
  }
}

請求body為

{
  "uid":"13579",
  "size":2,
  "scene_id":"home_feed",
  "item_list":[{"item_id":"1111", "score":1},{"item_id":"222", "score":0.95}]
}

介面調用

通過curl命令調用

如果需要本地通過curl命令請求引擎服務，需要先在EAS控制台找到對應服務的請求地址和token，如下圖：

在服務詳情中點擊查看調用資訊，即可彈出調用資訊。

curl -X 'POST' -v \
'http://12*****.vpc.hangzhou.pai-eas.aliyuncs.com/api/predict/test/api/rec/feed' \
-H 'Authorization:YmRjZThkM2Z*****************TU5Mw==' \
-d '{
"uid":"13579",
"size":2,
"scene_id":"home_feed",
"item_list":[{"item_id":"1111", "score":1},{"item_id":"222", "score":0.95}]
}'

返回資料

{
  "code":200,
  "msg":"success",
  "request_id":"e332fe9c-7d99-45a8-a047-bc7ec33d07f6",
  "size":2,
  "experiment_id":"",
  "items":[
    {
      "item_id":"1111",
      "score":0.9991594902203332,
      "retrieve_id":"ContextItemRecall"
    },
    ...
  ]
}

通過PAI-Rec診斷工具調用

如果您是通過PAI-Rec控制台服務管理部署的服務，可以直接使用診斷工具來調試推薦結果，如下圖：

您需要選擇對應服務、環境，路由資訊選擇/api/rec/feed；

物品表：如果您有item的詳情表，這裡也可以選擇，會將item的詳情和返回的資料進行關聯；

請求資料：會展示您最近一段時間的請求參數，也可以手動填寫。

如下圖所示，選擇和填寫好相關參數，點擊診斷即可獲得推薦結果。