技术常见问题

最近更新时间:2024-08-09 09:17:41

我的收藏

1. 使用密钥调用 API 报错:用户未登录

常见原因是子账号操作 API , 主账号未给子账号授权 。
授权方式请参考:

2. 腾讯云上只能看到 SecretId,看不到 SecretKey

腾讯云的规则是只有新建的时候才能看到。
可以新建一个,然后自行记录保存。
原有的一个密钥禁用(如果不使用的话),然后删除;删除之后就可以重新创建。

3. BotBizID , BotAppKey 是什么,从哪里获取?

BotBizID 是创建某个应用时的唯一标识。
BotAppKey 是分享或者通过 websocket , sse HTTP 调用的时候用来获取访问通证的一个参数。
BotBizID: 可以直接在当前页面的 URL 中获取【 appid 】。



BotAppKey: 应用列表, 点击【调用】, 就可以看到 appkey 了。
注意:
应用发布之后,【调用】按钮才可以使用,否则按钮是置灰的状态







4. 接口调用,报错:应用【机器人】不存在

调用一般的接口,传入的 BotBizId 不对,找不到对应的应用 。
调用 GetWsToken,当 Type=5 【 API 访客】的时候 , BotAppKey 必填 。

5. sessionID 和 requestID 如何使用

sessionID 用来标识一个会话,不同会话(不管是否是同一个应用)需要使用不同的 sessionID,同一个会话使用同一个 ID。sessionID 的生成规则是 uuid。
requestID 用来标识一个请求,不同请求使用不同的 requestID。




6. 通过 websocket、HTTP sse 调用的时候如何重置会话

需要用户重新生成一个 sessionID 即可 。

7. 实时文档解析后报错:msg:http client codec StatusCode: Not Found

这种情况是 cos 里面没有找到相关的文档导致的,请检查下上传文档是否传错了 cos 桶,着重检查下获取临时密钥的时候的 TypeKey,可参考以下文档:

8. 离线文档上传之后,怎么知道是否解析完成,是否可以发布

离线文档上传后,会有解析、审核、发布等状态,当前序步骤处理完成之后,文档的状态会处于待发布状态,这个时候可以调用发布接口执行文档发布 。
可以通过轮询 ListDoc 接口,查看文档是否可以发布 。
离线文档的状态可参考:文档列表 中的 Status.N 文档状态 。

9. 获取用户历史消息,GetMsgRecord

接口逻辑: 根据当前传入的会话的 session_id 获取聊天,当消息过多的时候通过 Count 和 LastRecord 来做翻页 。
例如:
session_id: xxxxxxx下有50条数据,count 设置为20,分页取消息时的传参:Count = 20 、 LastRecordId = 当前获取到的消息列表中的第一条 record_id。
说明:
1、如果传入的 session_id 不正确,会找不到相应的会话 。
2、该接口只能获取某个 sessionID 下的聊天数据,不能获取当前应用下的所有聊天数据 。
3、用户通过接口获取 API 访客数据【Type=5】的时候,需要通过 ReplyMethod 来区分 IsFromSelf : 0表示用户请求,非0表示知识引擎的回复 。

10. 如何在 websocket, HTTP sse 调用中带上知识标签

websocket 方式,在获取 token 的时候带上 VisitorLabels, 具体可参考:获取ws token
HTTP sse 方式,需要在入参的时候带上 VisitorLabels,具体可参考: 对话端接口文档(HTTP SSE)
说明:
如果一个文档关联了多个属性,多个知识标签,API 调用传入了多个属性,多个标签,在做数据搜索的时候,标签的叠加逻辑如下:同属性下多个标签搜索为或的关系,不同属性之间搜索为且的关系 。

11. 用户会话端不展示参考来源

知识引擎测试预览页面是默认展示参考来源的,即使文档未打开外部引用链接 。
在用户端或者 api 接入的方式未展示参考来源,请从下面几个方向排查:
1、参考来源未打开,可以在导入文档的时候打开; 文档导入后也可以选择编辑文档,修改外部引用链接的方式来定义应用链接 。




2、一段对话并不总是有参考来源,参考来源需要看问题的内容和知识库里面的文档,问答的相似程度来进行判断;可以对同样一个问题,分别在知识引擎的测试预览页面和用户页面进行问答,在打开了文档的外部引用链接之后,两个地方的回答应该是一样的。

12. 应用文档接口中给出的 Python 示例运行错误,无法进行问答

可能是客户未安装正确的软件版本,按照如下方法更新即可:
pip3 install -r requirements.txt
注意:
执行 pip3 install requests 命令来安装依赖,不能解决上面的问题。

13. 通过 websocket、 HTTP sse 进行图片问答时参数如何填充

1. 需要将图片上传到实时文档 cos 中,请参考:实时文档解析
2. websockt 和 HTTP sse 中的 content : 如果发送图片,在此传递 markdown 格式的图片链接,例如![](图片连接),其中图片链接需要可公有读。
content 示例:
{
"request_id": "LHWObW2Sea-3173301679",
"session_id": "f5652b8c-e88e-4abc-8629-7952b741a433",
"file_infos": [],
"content": "描述下下面这张图片![](https://lke-realtime-1251316161.cos.ap-guangzhou.myqcloud.com/public/
1746827241600319488/1780784842443587584/image/VZyKRMJllHjmzStRZEaf-1818188185015418880.jpg)"
}