4 人机协作

4.1 获取人机协作信息

  • 接口地址
/v10/tenants/{tenantId}/recommendation/questions
  • 接口请求示例
curl -X POST \
  http://robot.easemob.com/v10/tenants/9/recommendation/question \
  -H 'content-type: application/json' \
  -H 'token:eyJhbGciOiJIUzI1NiJ9eyJzdWIiOiJjaGl4aWFveXUyMTFAMTYzLmNvbSIsImlzcyI6ImVhc2Vtb2Itcm9ib3QiLCJ0ZW5hbnRJZCI6OSwiZXhwIjoxNTIyMjM3ODk1LCJpYXQiOjE1MjE2MzMwOTUsInVzZXJJZCI6IjFmYmNhNjE5LTZlMWItNDg2Yi1hOTdhLWE4MDc0ZjRlNzIxMSIsImp0aSI6IjJmZDkzOWM1LWFkNDUtNGVjMS04MzFhLTk1NzRhMDYzODg1NSIsInVzZXJuYW1lIjoiY2hpeGlhb3l1MjExQDE2My5jb20ifQ.BXVLRTwe1IzWHrCZVTNQauJFQQMneYiMr5NeCRYHc68' \
  -d '{
    "question":"你好",
    "userId":"8de05700-77e9-478a-a733-dd4e9457b756"
}'
  • 请求参数说明
url参数:
    tenantId:租户ID
请求体:
    question:问题
    userId:用户ID
    agentId:坐席ID
    recContext:推荐上下文信息
        contextMessages:上下文消息列表,每条上线文消息具有如下结构
            recQuestion:用户消息
                msgId:消息ID
                msgType:消息类型,取值:TEXT, VIDEO, AUDIO, PIC, HTML, FILE, LOC, CMD
                question:消息内容
            recUserInfo:用户信息
                userId:用户ID
                userType:用户类型,取值:VISITOR, AGENT, ROBOT,其他角色发的消息不要传过来
  • 接口返回的ResponseBody
{
    "entity": {
                "recId": "daeb66ce-3ecb-4dba-a879-b6e59900d4c1",
        "recAnswers": [{
                        "subClass": "RecTextAnswer",
            "id": "faeb66ce-3e5b-4dba-a879-b6e59900d4c2",
            "answer": "不好",
            "score": 1.0,
                        "usageCount": 0
        }],
    },
    "errorCode": null,
    "errorDescription": null,
    "first": true,
    "last": true,
    "number": 0,
    "numberOfElements": 0,
    "size": 0,
    "status": "OK",
    "totalElements": 0,
    "totalPages": 0
}
  • 接口返回参数说明
entity:
    recId:推荐ID, 唯一标识一次推荐结果,反馈时需要带上
    recAnswers:推荐答案数组,每个答案目前有两种格式
    格式一:
        subClass:RecTextAnswer
        id:答案ID
        score:推荐答案得分
        usageCount:使用次数
        answer:答案内容,单个文本答案
    格式二:
        subClass:RecGroupAnswer
        id:答案ID
        score:推荐答案得分
        usageCount:使用次数
        answers:答案内容,多个RecTextAnswer答案组成的答案组