七鱼开发文档中心
总览服务端 APIWebiOSAndroid鸿蒙Uniapp微信小程序插件三方接入
在线机器人知识挖掘

查询相似未采纳问题

查询相似未采纳问题。

查询指定机器人在时间范围内的相似未采纳问题。时间范围最长 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

请求参数

名称类型必填描述示例值
appKeystring是应用 AppKey1c088a89de51d0af457616605f28390f
timeint64是请求时间戳(秒);与服务器时间误差超过 10 分钟会鉴权失败1511832531
checksumstring是请求签名校验和f570a5eb049eb803b086e45829b07e48
checksumAlgorithmint32否签名算法:0-SHA-1,1-SHA-256;不传默认为 0(SHA-1)0

请求体

名称类型必填描述示例值
robotIdint64是机器人 ID123456
statusstring否处理状态:pending-待处理,ignored-已忽略pending
startTimeint64否开始时间,毫秒时间戳1700000000000
endTimeint64否结束时间,毫秒时间戳;查询范围最长 90 天1700100000000
pageSizeint32否每页条数,默认 20,最大 20020
curPageint32否页码,默认 11
typestring否未知问题类型:cluster-聚类问题,all-全部未知问题;查询相似未采纳时不使用cluster

返回参数

名称类型描述示例值
codeint32业务状态码,200 表示成功200
messagestring响应消息success
dataobject相似未采纳问题分页响应
└totalint64符合条件的记录总数100
└listobject[]相似未采纳问题列表
└idint64记录 ID10001
└questionstring问题内容怎么申请退款
└candidatesobject[]候选标准问题列表
└idint64标准问题 ID20001
└namestring标准问题名称退款规则
└askCountint32提问次数3
└lastSessionTimeint64最近会话时间,毫秒时间戳1700100000000
└statusstring处理状态pending
totalint32分页总数,分页接口返回100
requestIdstring链路请求 ID0a1b2c3d4e5f
resultobject部分历史接口使用 result 字段承载业务数据

错误码

状态码描述
14001AppKey 缺失或不存在
14002checksum 校验失败
14003请求时间戳与服务器时间误差超过 10 分钟
14004请求体不是合法 JSON 对象,或参数缺失、格式非法
14009频控限制:接口调用超过限流阈值
14500服务内部错误
14501数据查询范围超出限制
14515当前 AppKey 无接口或资源访问权限
postEndpoint
/openapi/robot/data/mining/similarUnadopted
POST
/openapi/robot/data/mining/similarUnadopted
curl -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