智能硬件语音交互接入大模型知识库的排错指引

前言

前篇讲了把大模型知识库接入到聆思CSK6大模型开发板的文章，这篇讲一下配置失败时该怎么去定位问题和解决。

阅读这篇文章前建议先看：三步把知识库接到智能语音硬件上-CSDN博客

一、排错流程顺序参考

        该排错流程也适用于开发板接入其他自建大模型应用的错误定位

二、云端鉴权问题处理

原因1：聆思平台（platform）云端产品管理页没有添加开发板的设备ID

处理方法：按序号顺序操作，添加开发板设备ID

查看设备ID：

在开发板应用首页下滑调出菜单，以此点击设置图标 →应用，进入应用信息查看页：

原因2、更换过联网环境，DNS解析失败

如果不是以上两个原因，可以查下串口日志，聆思在线串口终端如果出现以下信息则是网络问题

处理方法：重启设备，重新尝试。若多次尝试失败，建议更换网络。

三、提问无回复语音的处理

原因1：开发板关联了无效的product id和应用

如果开发板上的product id错误，使用开发板重新扫描上图位置中的二维码即可修正；

如果是配置应用显示为0，如下图所示，选择对应服务保存即可。

原因2：自建服务没有启动

测试环境和正式环境需要有一个是正常运行状态，如果是服务运行异常，可以启动对应服务来解决

四、回复未调用知识库的处理

如果知识库相关的问题回复内容跟接入的知识库无关，此时可以判定为知识库调用失败。

【重要提醒】知识库生效是需要有API KEY，如果有报“APlkey is missing”，请参考官方文档生成可用的API KEY，详细操作参考 获取API密钥 | 聆思文档中心 

1、首先，在聆思平台（LSPlatform）后台查看语音请求是否正确理解，并落域到正确的节点处理

2、其次，检查大模型流程的【知识库】或【知识点检索】节点关联的[知识库ID]信息是否正确。

3、然后，使用【知识库体验】测试知识库回复内容是否符合预期

4、如果回复不符合预期，可以点击调用的知识库进入切片内容界面，通过关键词搜索快速定位切片信息，检查切片内容是否正确。

5、如果要补充问答信息，可以使用【QA管理功能】进行补充

五、知识库文档格式要求

如果使用智能分片处理文档生成的内容不符合预期，采用自定义分片的方式。

文档导入知识库前需要对文档内容和格式进行处理，可以参考官方文档进行：知识库文档最佳规范指南 | 聆思文档中心

如果您对大模型+智能硬件感兴趣，可以点下关注，我们会持续更新~