最近小铁匠的不少客户朋友都收到喵伴了，但跟着官方的用户指南操作之后还是有不少细节问题，小铁匠这边就出一个小白版本的操作指南，再汇总下常见问题，希望能帮到朋友们。
AI硬件小铁匠在这一系列文章中将会按照 硬件分析、嵌入式软件源码分析、云端开发 三个部分来进行分享，并且还会分享基于喵伴一些实践作品。在自己学习喵伴项目的同时，也希望能帮助到屏幕前的小伙伴。详情可点此查看。
操作步骤
1 扣子平台创建并发布智能体。
这一步你将拿到botid。
智能体就是喵伴的灵魂，在智能体有很多可玩性，可以跟着扣子教程《搭建一个 AI 助手智能体》来建一个完全自定义的智能体，也可以直接复制一个智能体直接发布，如 喵伴对话智能体。
这里不推荐默认的智能体苏瑶，延时太长。喵伴智能体进行过延迟优化。
确认点 1.1，扣子智能体是否已通过API发布：
可以在扣子空间中看到是否已发布，见下图。
确认点 1.2，扣子智能体的botid一定要复制正确： botid 是 url 的后缀，最后的一串。
2 获取 jwt 鉴权信息。
这一步，你将拿到 public_key、appid字段，以及私钥 private_key.pem。
菜单操作：扣子API -> 授权 -> OAUTH应用。
具体操作见这个动态图。
3 电脑上创建 bot_setting.json 文件
"bot_setting.json"，可以新建一个记事本文件，再重命名为 "bot_setting.json"。
参考文件模版，再填入自己的数据。public_key、appid在第2步获得，bot_id 在第1步获得。
如果只配置了1个智能体，bots中的第2个 bot_id 可以先不填，只填第1个 bot_id。
{
"public_key": "Z7H6nNCq3WHeDwC0xxxxxxxxxxxxxxxxxxxxxxxxxxx",
"appid": "11523xxxxxxxx",
"bots": [
{
"bot_name": "Lin Jia Nv Hai",
"bot_id": "7512052xxxxxxxxxxxx",
"voice_id": "7426720361733144585",
"description": "A warm-voiced female AI character who listens to the user's thoughts and offers comforting responses."
},
{
"bot_name": "Wan Qu Da Shu",
"bot_id": "750716xxxxxxxxxxxxx",
"voice_id": "7426720361732915209",
"description": "A male AI character with a regional accent. He responds quickly and concisely, but does not perform actions on behalf of the user."
}
]
}
常见问题
1 语音提示 “我还没有连接网络，请帮我配置网络”
如果喵伴还未连接过 Wi-Fi 网络，设备会以 20 秒时间间隔循环播报 “我还没有连接网络，请帮我配置网络”，并且屏幕上方会显示相应的 “Wi-Fi 连接” 动态图标。
- 如果喵伴连接wifi时显示乱码，因为那是中文。
- 如果喵伴扫描不到你的wifi，需要保证是2.4G频段。
- 如果喵伴连接wifi，输入密码后一直在连接中，可能是你家wifi的认证方式乐鑫芯片不支持。建议先用手机开一个2.4G频段的热点来测试，看下是否正常连接网络。
- 喵伴的主控芯片是ESP32-S3，不能支持所有的wifi认证方式，推荐用最常用的 WPA2 来试试。
- 双频wifi有的路由器没问题，有的路由器不行，可以尝试把双频分开。
2 语音提示：无效的配置文件
也就是说 "bot_setting.json" 和 ”private_key.pem“ 这两个文件是无效的。
请再检查文件是否存在。
有遇到一个客户，它的文件名是 "bot_setting .json"，多了一个空格。
3 语音提示：服务连接中
服务连接中，喵伴要通过websocket连接到智能体发布的API，卡在这一步的话，大概是两类原因，要么喵伴本地的配置有错误，要么扣子平台的智能体没发布API。
3.1 扣子平台智能体没发布
扣子平台智能体发布确认，见上方确认点1。
3.2 喵伴本地配置pem文件错误
3.3 喵伴本地配置 bot_setting.json 内容错误
非常多的人在这一步出错，public_key、appid、bot_id 这3个字段再检查下。
{
"public_key": "Z7H6nNCq3WHeDwC0xxxxxxxxxxxxxxxxxxxxxxxxxxx",
"appid": "11523xxxxxxxx",
"bots": [
{
"bot_name": "Lin Jia Nv Hai",
"bot_id": "7512052xxxxxxxxxxxx",
"voice_id": "7426720361733144585",
"description": "A warm-voiced female AI character who listens to the user's thoughts and offers comforting responses."
},
{
"bot_name": "Wan Qu Da Shu",
"bot_id": "750716xxxxxxxxxxxxx",
"voice_id": "7426720361732915209",
"description": "A male AI character with a regional accent. He responds quickly and concisely, but does not perform actions on behalf of the user."
}
]
}
常见错误有：
1.public_key、appid、bot_id 这3个字段一定要复制粘贴过来，不要漏字符。
2.上面3个字段也不要插入无关的空格。遇到好几个客户，排查到最后发现多插入了空格。
3.bot_id 搞错，和 appid 搞混，或者复制了智能体url里前面一串数字，bot_id是最后的一串数字，即上方的确认点1.2。
另外注意：json文件中的其他字段先不要去动它，等调通第一个智能体之后再慢慢改着玩。
4 语音提示：服务连接成功，但是喵伴不响应
网络连接后，正常情况下，设备会依次播报： • “服务连接中，请稍后””[音频 1] • “服务连接成功”[音频 2]。
受网络波动影响，设备可能会循环播报几次【音频 1】，若【音频 2】长时间未播报，可能表示网络情况不佳，或智能体额度已用尽。
建议在 扣子空间 - 发布管理，进入自己的智能体，看看日志。你发给智能体的每句话都有记录。
扣子空间的左下角也有资源点的余额提示。
5 语音对话延迟太大
这里不推荐默认的智能体苏瑶，延时太长。喵伴智能体进行过延迟优化，一般对话的首次响应时长都能控制在几百ms以内。
END
That's all
