1. 使用密钥调用 API 报错:用户未登录
常见原因是子账号操作 API , 主账号未给子账号授权 。
创建子账号与子账号授权方式:


1.2 在角色管理,单击添加用户后跳转到访问管理界面进行添加子账号用户。

1.3 用户授权
1.3.1 点击快速创建对用户进行授权。

1.3.2 针对需要创建的子账号用户设立角色信息,并分配对应的用户权限。

1.3.3 若需用户能访问并操作知识引擎,需在用户权限处给予对应子账号知识引擎的读写权限。

1.4 点击快速创建后即可复制对应的子账号账号密码。


用户分配与绑定权限:


自定义角色编辑:

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 接口,查看文档是否可以发布 。
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表示知识引擎的回复 。
4. 该接口只支持获取最近半年时间的数据 。
10. 如何在 websocket, HTTP sse 调用中带上知识标签
websocket 或者 HTTP sse方式,请在对话入参中的custom_variables字段中带上标签的值。
注意:
11. 用户会话端不展示参考来源
知识引擎测试预览页面是默认展示参考来源的,即使文档未打开外部引用链接 。
在用户端或者 api 接入的方式未展示参考来源,请从下面几个方向排查:
1. 参考来源未打开,可以在导入文档的时候打开; 文档导入后也可以选择编辑文档,修改外部引用链接的方式来定义应用链接 。


2. 一段对话并不总是有参考来源,参考来源需要看问题的内容和知识库里面的文档,问答的相似程度来进行判断;可以对同样一个问题,分别在知识引擎的测试预览页面和用户页面进行问答,在打开了文档的外部引用链接之后,两个地方的回答应该是一样的。
12. 应用文档接口中给出的 Python 示例运行错误,无法进行问答
可能是客户未安装正确的软件版本,按照如下方法更新即可:
pip3 install -r requirements.txt
注意:
执行 pip3 install requests 命令来安装依赖,不能解决上面的问题。
13. 通过 websocket、 HTTP sse 进行图片问答时参数如何填充
1. 需要将图片上传到实时文档 cos 中,请参考:实时文档解析。
2. websocket 和 HTTP sse 中的 content : 如果发送图片,在此传递 markdown 格式的图片链接,例如,其中图片链接需要可公有读。
content 示例:
{"request_id": "LHWObW2Sea-3173301679","session_id": "f5652b8c-e88e-4abc-8629-7952b741a433","file_infos": [],"content": "描述下下面这张图片"}
14. Token 校验失败
1. 检查是否同一个 token 校验了多次。一个 token 只能校验一次,第二次会报错。
2. 检查 token 是否在有效期内,有效期是60s。
15. 参考来源事件说明
应用发布之后并不一定有参考来源事件 (reference 事件),需要包含下面两个必要条件:
1. 确保文档已打开外部引用链接, 可以通过批量设置的方式打开,请按需开启。

2. 当前业务规则对召回的内容和大模型召回的内容加工后的回答做阈值计算,若达到设定的阈值,才会返回参考来源。
说明:
召回的内容经过大模型后与召回内容产生差异的主要原因如下:
大模型会对输入的内容进行合并、润色等方面的处理。
用户设定的提示词会对大模型输出内容做限定处理。