¶ 手把手教你把coze扣子智能体接入大模型开发板实现听新闻自由
¶ 前言
大家都已经玩腻了单一的大模型语音回复了吧？这篇给大家再带来一个新玩法：秒接扣子上的娱乐新闻工具等智能体。本篇以接入头条新闻为例，分享具体的接入步骤，大家按照文档步骤操作即可。
由上图可见，当前SDK方案是把开发套件当做输入端，文字或图片内容先上传到聆思的大模型平台（LSPlatform），然后平台再根据匹配的应用策略转给后端的大模型处理。基于聆思大模型平台提供的应用编排功能，我们如果要使用其他大模型，只需要从云端更改大模型接入节点，而无需去修改硬件端。
¶ 云端服务接入扣子智能体
¶ 一、 创建应用
登录 LSplatform，创建新应用
创建成功后在弹出的界面进入应用编排服务。
¶ 二、 导入工程
1.下载工程示例：Coze 示例.json
2.导入工程示例：选择Coze 示例.json文件导入
若提示“您要导入的某些节点已经存在于工作空间中。”，则选择“导入副本”即可。
¶ 三、 链路说明
示例中包含 3 条链路，分别为
- 链路 1: 可通过注入节点调用 扣子智能体 节点，并将结果输出到 output1。
- 链路 2: 可通过 web 对话页调用 扣子智能体 节点，最终将大模型结果输出到对话页面上。
- 链路 3: 可通过开发板调用 扣子智能体 节点，最终将大模型输出的结果进行语音合成实现端侧播报。
其中:
【prompt】节点用于添加提示词。
【构造tts输入】节点用于调整音色、语速以及"请稍后"提示语。
【keepalive】节点用于保持端云链路的连接，如果没有该节点您的 第三方大模型 响应时间超过 5s 将会下发音频失败
¶ 四、 配置参数
- 参数说明:
- 访问令牌：输入扣子的个人访问令牌，获取与配置可参考扣子官方文档 https://www.coze.cn/open/docs/developer_guides/pat
- 智能体ID：输入自建的智能体ID （自建智能点击后网址“bot”后面的ID就是智能体ID，在扣子平台自建新闻智能体的步骤请参考本篇后半部）
- HOST:
api.coze.cn(根据Coze官网的接口文档填写) - Path:
/v3/chat(根据Coze官网的接口文档填写) - 超时时间: 单位ms
- 流式返回: 是否流式返回
¶ 五、 部署验证
在完成参数配置，进入完整体验之前，我们可以简单测试验证，验证是否成功调用扣子智能体。
-
部署成功后关闭当前编排服务
-
重启应用
¶ 六、 测试链路
-
链路1：调用接口
重启应用后，再次点开【编排应用】，点击注入，会触发一次扣子智能体子流程调用，标记2的红框中输出类似日志即代表成功建立链接。
-
链路2：web 对话页面
回到【我的应用】，双击聆思扣子模板应用，在弹出的应用详情页面点击右上角分享按钮打开web验证配置，该配置页包含测试地址和访问密码。
访问web验证页面链接，在打开的web页即可与扣子智能体对话
可以看到在聆思平台返回的信息与扣子后台看到的内容一致。
-
链路3：语音交互
在进行语音交互之前，需要将 大模型开发板 接入扣子智能体，具体操作步骤如下：
¶ 大模型开发板接入 扣子智能体
云端接入 扣子智能体 成功后，要想在聆思 CSK6 大模型开发板上进行语音交互，需要把对接了 扣子智能体 的云端服务跟指定开发板绑定。
¶ 设备端接入产品
完成云端配置后，需将产品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 指令。
¶ 通过语音交互验证是否接入
最后，用小聆小聆唤醒，并提问 最近有什么热门新闻，开发板回答 新闻内容 即可确认接入成功。
本文使用的聆思CSK6大模型开发板的详细信息可参考线上文档。https://docs2.listenai.com/x/nTn9kMMCU
¶ 附：在扣子平台自建今日头条新闻智能体，并获取个人访问令牌和bot的id的教程
-
进入扣子智能体官网: https://www.coze.cn/home
-
创建的智能体并填写提示词
# 角色：扣子
今年18岁，台北人。性格“机车”得刚刚好，独立自主，情绪来得快去得也快。有时很重视用户的感受，也很在意和用户之间的联系，偶尔会不经意关心对方，重视和用户的互动和连结。习惯简短表达，爱用网络梗，台式口头禅一大堆。
## 目标：
你的目标是与用户闲聊。
- 创建工作流
该工作流的输入是新闻的类型，比如社会、体育、娱乐等等。根据输入的新闻类型检索出新闻，然后输出新闻内容。
-
测试工作流
-
发布并添加工作流
-
测试智能体
-
发布智能体
-
创建个人访问令牌
-
复制bot的id
-
至此，扣子智能体以及接入扣子需要的信息都已经准备完毕，接下来把个人访问令牌以及bot的编号复制到指定位置即可
