¶ 手把手教你用聆思 CSK6 大模型开发板接入智谱清言：ChatGLM
¶ 前言
多模态交互离不开硬件载体，近期有不少开发者在研究大模型开发板除了使用出厂示例自带的星火大模型，能不能接入文心一言、通义千问、豆包、智谱 glm、kimi 等国内的大模型，这个是必须支持的。但由于各家接口和数据格式不一样，有些朋友直接参考 chatgpt 的方式没有走通，因此本篇以聆思 CSK6 大模型开发板接入智谱 glm 为例，分享具体的接入步骤，大家按照文档步骤操作即可。
由上图可见，当前 SDK 方案是把开发套件当做输入端，文字或图片内容先上传到聆思的大模型平台（LSPlatform），然后平台再根据匹配的应用策略转给后端的大模型处理。基于聆思大模型平台提供的应用编排功能，我们如果要使用其他大模型，只需要从云端更改大模型接入节点，而无需去修改硬件端。
¶ 云端服务接入 ChatGLM
¶ 一、 创建应用
登录 LSplatform，创建新应用
创建成功后在弹出的界面进入应用编排服务。
¶ 二、 导入工程
-
下载工程示例：ChatGLM 示例.json
-
导入工程示例：选择
ChatGLM 示例.json文件导入。
若提示“您要导入的某些节点已经存在于工作空间中。”，则选择“导入副本”即可。
¶ 三、 链路说明
示例中包含3条链路，分别为
- 链路1: 可通过 注入 节点调用 ChatGLM 节点，并将结果输出到 output1。
- 链路2: 可通过 web 对话页调用 ChatGLM 节点，最终将大模型结果输出到对话页面上。
- 链路3: 可通过开发板调用 ChatGLM 节点，最终将大模型输出的结果进行语音合成实现端侧播报。
其中:
【prompt】节点用于添加提示词。
【构造tts输入】节点用于调整音色、语速以及"请稍后"提示语。
【keepalive】节点用于保持端云链路的连接，如果没有该节点您的 第三方大模型 响应时间超过 5s 将会下发音频失败
¶ 四、 配置参数
- 参数说明：
host:根据第三方大模型的接口文档填写path:根据第三方大模型的接口文档填写apikey：调用接口需要的api-key，文末将会给出申请的具体步骤。Model：示例提供了多种模型可选择。若要新增其他模型，可按照下列步骤自行添加。Stream：是否流式返回。
¶ 五、 部署应用
在完成参数配置，进入完整体验之前，我们可以简单测试验证，验证是否成功调用 ChatGLM 。
- 部署成功后关闭当前编排服务。
- 重启应用。
¶ 六、 测试链路
-
链路1：调用接口。
重启应用后，再次点开编排应用，点击时间戳（注入节点），会触发一次 ChatGLM 子流程调用，标记2的红框中输出类似日志即代表成功建立链接。
-
链路2：打开web对话页面。
回到我的应用，双击ChatGLM应用，在弹出的应用详情页面点击右上角分享按钮打开web验证配置，该配置页包含测试地址和访问密码。
访问web验证页面链接，在打开的web页即可与 ChatGLM 对话。
-
链路3：语音交互
在进行语音交互之前，需要将 大模型开发板 接入 ChatGLM，具体操作步骤如下：
¶ 大模型开发板接入 ChatGLM
云端接入 ChatGLM 成功后，要想在聆思 CSK6 大模型开发板上进行语音交互，需要把对接了 ChatGLM 的云端服务跟指定开发板绑定。
¶ 设备端接入产品
完成云端配置后，需将产品ID（product ID）与密钥（secret ID）写入设备，才能让设备连接对应的产品并完成鉴权服务。
若您当前设备上运行的固件不具备扫码接入功能，请参照 《应用合集TF卡》更新 TF 卡中的镜像文件夹。
配置方式：
- 先在聆思平台打开已经配置好的产品，展示出右侧的接入二维码：
- 然后在开发板的首页下滑调出菜单，点击设置图标 →再点击应用，切换到应用信息查看页：
- 点击右下角扫码接入按钮调出相机，将 LSPlatform 待接入的产品二维码置于屏幕绿色扫描框内，完成扫描后，请在应用配置信息处检查product_id和secret_id是否已更新：
注：屏幕亮度和反光会影响扫码识别，可以把二维码的网页放大200%以上再扫码。
出厂时的摄像头膜需要取下
- 接入成功后，重启开发板。
¶ 1.读取设备 id
设备 ID 是一个产品下的唯一设备标识，我们需要获取当前设备 ID 方便后续在云端配置，才能让设备鉴权通过实现端云交互。
读取方式：
cskburn desktop 是一款聆思推出的桌面烧录工具，下载地址（cskburn 桌面烧录工具 | 聆思文档中心）打开软件后
- 点击串口下拉框，选择连接开发套件后识别到的串口编号；
- 点击获取信息；
- 得到设备 ID。
¶ 2.加入设备列表
聆思平台只会对列表中的设备鉴权提供交互服务，因此需要将前面读取到的设备 ID 在设备管理页面进行导入才能实现设备正常交互。
¶ 3.接入云端应用
云端配置设备 id 后，还需将产品 ID 写入开发板固件中，才能让设备在运行时找到正确的云端产品服务完进行鉴权，鉴权完成就可以进行大模型语音交互了。
写入方式：
使用数据线连接开发板 DAP_USB 接口后，打开聆思在线串口终端，选择对应的串口设备进行连接，波特率默认 115200，完成配置后点击连接按钮。
通过 set product_id 和 set secret_id 指令可以分别配置开发板接入的大模型应用 product ID 及其密钥，示例如下：
set product_id 71cd1721-xxx-xxx-xxx-1000055c8b2f
set secret_id cb09013f-xxx-xxx-xxx-e212b32f9218
其中，product_id 和 product_secret 可在对应产品的产品信息中获取，请将指令中的参数替换为产品信息中的 id 与 secret 信息。
最后，重启开发板即可。
旧版固件请使用 aiui set product_id 与 aiui set secret_id 指令。
¶ 通过语音交互验证是否接入
用小聆小聆唤醒，并提问你是谁，语音回复它是GLM即可验证成功。至此，可以确认 ChatGLM 接入成功。
本文使用的聆思CSK6大模型开发板的详细信息可参考线上文档。https://docs2.listenai.com/x/nTn9kMMCU
¶ 附: 申请 智谱清言ChatGLM 的 api-key 的教程
-
登录 ChatGLM 官网
-
申请 api-key
-
填写 api-key