查询相似未采纳问题
查询相似未采纳问题。
查询指定机器人在时间范围内的相似未采纳问题。时间范围最长 90 天,pageSize 默认 20、最大 200。
请求字段限制:
- robotId:必填,机器人 ID
- status:选填,处理状态:pending-待处理,ignored-已忽略,可选值:pending/ignored
- startTime:选填,开始时间,毫秒时间戳
- endTime:选填,结束时间,毫秒时间戳;查询范围最长 90 天
- pageSize:选填,每页条数,默认 20,最大 200,最大值 200,默认值:20
- curPage:选填,页码,默认 1,默认值:1
- type:选填,未知问题类型:cluster-聚类问题,all-全部未知问题;查询相似未采纳时不使用,可选值:cluster/all
请求参数
| 名称 | 类型 | 必填 | 描述 | 示例值 |
|---|---|---|---|---|
| appKey | string | 是 | 应用 AppKey | 1c088a89de51d0af457616605f28390f |
| time | int64 | 是 | 请求时间戳(秒);与服务器时间误差超过 10 分钟会鉴权失败 | 1511832531 |
| checksum | string | 是 | 请求签名校验和 | f570a5eb049eb803b086e45829b07e48 |
| checksumAlgorithm | int32 | 否 | 签名算法:0-SHA-1,1-SHA-256;不传默认为 0(SHA-1) | 0 |
请求体
| 名称 | 类型 | 必填 | 描述 | 示例值 |
|---|---|---|---|---|
| robotId | int64 | 是 | 机器人 ID | 123456 |
| status | string | 否 | 处理状态:pending-待处理,ignored-已忽略 | pending |
| startTime | int64 | 否 | 开始时间,毫秒时间戳 | 1700000000000 |
| endTime | int64 | 否 | 结束时间,毫秒时间戳;查询范围最长 90 天 | 1700100000000 |
| pageSize | int32 | 否 | 每页条数,默认 20,最大 200 | 20 |
| curPage | int32 | 否 | 页码,默认 1 | 1 |
| type | string | 否 | 未知问题类型:cluster-聚类问题,all-全部未知问题;查询相似未采纳时不使用 | cluster |
返回参数
| 名称 | 类型 | 描述 | 示例值 |
|---|---|---|---|
| code | int32 | 业务状态码,200 表示成功 | 200 |
| message | string | 响应消息 | success |
| data | object | 相似未采纳问题分页响应 | |
| └total | int64 | 符合条件的记录总数 | 100 |
| └list | object[] | 相似未采纳问题列表 | |
| └id | int64 | 记录 ID | 10001 |
| └question | string | 问题内容 | 怎么申请退款 |
| └candidates | object[] | 候选标准问题列表 | |
| └id | int64 | 标准问题 ID | 20001 |
| └name | string | 标准问题名称 | 退款规则 |
| └askCount | int32 | 提问次数 | 3 |
| └lastSessionTime | int64 | 最近会话时间,毫秒时间戳 | 1700100000000 |
| └status | string | 处理状态 | pending |
| total | int32 | 分页总数,分页接口返回 | 100 |
| requestId | string | 链路请求 ID | 0a1b2c3d4e5f |
| result | object | 部分历史接口使用 result 字段承载业务数据 |
错误码
| 状态码 | 描述 |
|---|---|
| 14001 | AppKey 缺失或不存在 |
| 14002 | checksum 校验失败 |
| 14003 | 请求时间戳与服务器时间误差超过 10 分钟 |
| 14004 | 请求体不是合法 JSON 对象,或参数缺失、格式非法 |
| 14009 | 频控限制:接口调用超过限流阈值 |
| 14500 | 服务内部错误 |
| 14501 | 数据查询范围超出限制 |
| 14515 | 当前 AppKey 无接口或资源访问权限 |
/openapi/robot/data/mining/similarUnadoptedcurl -X POST "https://qiyukf.com/openapi/robot/data/mining/similarUnadopted?appKey=1c088a89de51d0af457616605f28390f&time=1511832531&checksum=f570a5eb049eb803b086e45829b07e48" \ -H "Content-Type: application/json" \ -d '{ "curPage": 1, "pageSize": 20, "startTime": 1700000000000, "endTime": 1700100000000, "robotId": 123456, "status": "pending" }'{
"code": 200,
"data": {},
"message": "success"
}{
"code": 14001,
"message": "AppKey not exists"
}{
"code": 14002,
"message": "Bad checksum"
}{
"code": 14003,
"message": "Bad time"
}{
"code": 14004,
"message": "body内容json解析错误"
}{
"code": 14009,
"message": "单位时间内请求过于频繁"
}{
"code": 14500,
"message": "Internal error"
}{
"code": 14501,
"message": "Data limit exceeded"
}{
"code": 14515,
"message": "未开通机器人服务"
}这篇文档有帮助吗?
关联相似问至知识库
关联相似问至知识库。 将相似未采纳或未知问题关联到指定 FAQ 知识。robotId、id、source、knowledgeId、similarity 必填;source 为 unknown 时可通过 unknownType 选择聚类问题或全部未知问题。 请求字段限制: - robotId:必填,机器人 ID - id:必填,待处理记录 ID - source:必填,问题来源:similar_unadopted-相似未采纳,unknown-未知问题,可选值:similar_unadopted/unknown - knowledgeId:选填,目标 FAQ 知识 ID;linkSimilarity 必填 - similarity:必填,待关联的问题文本,必须与待处理记录原文一致,最长 50 个字符,最大长度 50 - unknownType:选填,未知问题类型:cluster-聚类问题,all-全部未知问题;默认 cluster,可选值:cluster/all,默认值:cluster
查询未知问题
查询未知问题。 查询指定机器人在时间范围内的未知问题。type 可选 cluster(聚类问题)或 all(全部未知问题);时间范围最长 90 天。 请求字段限制: - robotId:必填,机器人 ID - status:选填,处理状态:pending-待处理,ignored-已忽略,可选值:pending/ignored - startTime:选填,开始时间,毫秒时间戳 - endTime:选填,结束时间,毫秒时间戳;查询范围最长 90 天 - pageSize:选填,每页条数,默认 20,最大 200,最大值 200,默认值:20 - curPage:选填,页码,默认 1,默认值:1 - type:选填,未知问题类型:cluster-聚类问题,all-全部未知问题;查询相似未采纳时不使用,可选值:cluster/all