文档首页 > > API参考> 问答机器人> 问答统计API>

问答统计

问答统计

分享
更新时间:2021/03/08 GMT+08:00

功能介绍

获取指定时间范围内的问题答复统计,支持按周期统计。

URI

  • URI格式

    GET /v1/{project_id}/qabots/{qabot_id}/requests/reply-rates?start_time={start_time}&end_time={end_time}&interval={interval}&time_zone={time_zone}

  • 参数说明
表1 URI参数说明

名称

是否必选

说明

project_id

来自公有云的Project ID,用于资源隔离。

qabot_id

qabot编号,UUID格式,如:303a0a00-c88a-43e3-aa2f-d5b8b9832b02。

获取方法:

登录对话机器人服务控制台,在智能问答机器人列表中查看qabot_id。

start_time

查询的起始时间,long,UTC时间,默认值为0。

end_time

查询的结束时间,long,UTC时间,默认值为当前时间的毫秒数。

interval

统计周期目前支持year,month,week,day。

time_zone

请求所在时区,例如:中国东八区为"+08:00";美国西五区为"-05:00";默认为"UTC"。(注意+-:符号需要经过urlEncorder加码)

请求消息

GET https://cbs-ext.cn-north-4.myhuaweicloud.com/v1/{project_id}/qabots/{qabot_id}/requests/reply-rates?interval=day&time_zone=%2B08%3A00

Request Header: 
Content-Type: application/json 
X-Auth-Token: MIINRwYJKoZIhvcNAQcCoIINODCCDTQCAQExDTALBglghkgBZQMEAgEwgguVBgkqhkiG...

响应消息

响应参数如表2所示。

表2 响应参数

名称

参数类型

说明

startutc

long

统计开始时间。

调用失败时无此字段。

endutc

long

统计结束时间。

调用失败时无此字段。

interval

String

统计周期目前支持year、month、week、day。

调用失败时无此字段。

time_zone

String

所在时区,例如:中国东八区为"+08:00";美国西五区为"-05:00";默认为"UTC"。

调用失败时无此字段。

total

Object

总计答复率统计数据,具体参见表3

调用失败时无此字段。

intervals

Array of Object

间隔答复率统计数据,具体参见表4

调用失败时无此字段。

error_code

String

调用失败时的错误码,具体参见错误码

调用成功时无此字段。

error_msg

String

调用失败时的错误信息。

调用成功时无此字段。

表3 total字段数据结构

名称

参数类型

说明

question_count

long

间隔周期用户提问总数。

direct_count

long

间隔周期直接回答个数。

recommend_count

long

间隔周期推荐回答个数。

notmatch_count

long

间隔周期未匹配个数。

chat_count

long

间隔周期闲聊匹配个数

dialog_count

long

间隔周期技能会话匹配个数。

invalid_count

dialog_rate

invalid_rate

direct_rate

recommend_rate

notmatch_rate

chat_rate

long

long

long

double

double

double

double

间隔周期无效问题匹配个数。

间隔周期技能回答比例。

间隔周期无效问题回答比例。

间隔周期直接回答比率。

间隔周期推荐回答比率。

间隔周期未匹配比率。

间隔周期闲聊匹配比率

表4 intervals字段数据结构

名称

参数类型

说明

start

String

间隔周期开始时间。

question_count

long

间隔周期用户提问总数。

direct_count

long

间隔周期直接回答个数。

recommend_count

long

间隔周期推荐回答个数。

notmatch_count

long

间隔周期未匹配个数。

chat_count

long

间隔周期闲聊匹配个数

dialog_count

long

间隔周期技能会话匹配个数。

invalid_count

long

间隔周期无效问题匹配个数。

dialog_rate

long

间隔周期技能回答比例。

invalid_rate

long

间隔周期无效问题回答比例。

direct_rate

double

间隔周期直接回答比率。

recommend_rate

double

间隔周期推荐回答比率。

notmatch_rate

double

间隔周期未匹配比率。

chat_rate

double

间隔周期闲聊匹配比率

示例

按领域统计答复率。

  • 请求示例
    GET https://cbs-ext.cn-north-4.myhuaweicloud.com/v1/{project_id}/qabots/{qabot_id}/requests/reply-rates?interval=day&time_zone=%2B08%3A00
    
    Request Header:  
    Content-Type: application/json
    X-Auth-Token: MIINRwYJKoZIhvcNAQcCoIINODCCDTQCAQExDTALBglghkgBZQMEAgEwgguVBgkqhkiG...
  • Python语言请求代码示例
    import requests
    url = "https://{endpoint}/v1/{project_id}/qabots/{qabot_id}/requests/reply-rates?start_time={start_time}&end_time={end_time}&interval={interval}&time_zone={time_zone}"
    token = "用户获取得到的实际token值"
    headers = {'Content-Type': 'application/json', 'X-Auth-Token': token}
    
    response = requests.get(url, headers=headers, json=body, verify=False)
    print(response.text)
  • 响应示例
    • 成功响应示例
      {
          "interval":"day",
          "startutc":1613059200000,
          "endutc":1613720547615,
          "time_zone":"+08:00",
          "total":
             {
                 "question_count":179,
                 "direct_count":86,
                 "recommend_count":4,
                 "notmatch_count":85,
                 "chat_count":0,
                 "invalid_count":2,
                 "dialog_count":2,
                 "direct_rate":0.480,
                 "recommend_rate":0.022,
                 "notmatch_rate":0.475,
                 "dialog_rate":0.011,
                 "chat_rate":0.000,
                 "invalid_rate":0.011
             },
          "intervals":[
             {
                 "start":"2021-02-14",
                 "question_count":28,
                "direct_count":7,
                "recommend_count":0,
                "notmatch_count":21,
                "chat_count":0,
                "invalid_count":0,
                "dialog_count":0,
                "direct_rate":0.250,
                "recommend_rate":0.000,
                "notmatch_rate":0.750,
                "dialog_rate":0.000,
                "chat_rate":0.000,
                "invalid_rate":0.000
             },
            {
                "start":"2021-02-15",
                "question_count":2,
                "direct_count":0,
                "recommend_count":0,
                "notmatch_count":2,
                "chat_count":0,
                "invalid_count":0,
                "dialog_count":0,
                "direct_rate":0.000,
                "recommend_rate":0.000,
                "notmatch_rate":1.000,
                "dialog_rate":0.000,
                "chat_rate":0.000,
                "invalid_rate":0.000
             },
            {
                "start":"2021-02-19",
                "question_count":149,
                "direct_count":79,
                "recommend_count":4,
                "notmatch_count":62,
                "chat_count":0,
                "invalid_count":2,
                "dialog_count":2,
                "direct_rate":0.530,
                "recommend_rate":0.027,
                "notmatch_rate":0.416,
                "dialog_rate":0.013,
                "chat_rate":0.000,
                "invalid_rate":0.013
             }
          ]
      }

    • 失败响应示例
      {
          "error_code":"CBS.0021",
          "error_msg":"request parameter error"
      }

状态码

状态码请参见状态码

错误码

错误码请参见错误码

分享:

    相关文档

    相关产品