机智云Gokit5AI智能体开发板（4G）操作说明
本帖最后由 小Lin同学 于 2025-7-28 10:09 编辑机智云 Gokit5 AI智能体开发板（4G）操作说明
Gokit5 是一款零代码智能体开发板，开发者可专注于智能体的业务逻辑设计，快速搭建属于自己的 AI 智能体对讲系统。本文旨在说明 Gokit5 的使用流程。
一、使用说明1.长按②键3s对，开启设备，灯光开始闪烁（如更换键帽，可以type-c、收音口位置定位按键的位置）2.扫描设备后方二维码进行绑定设备。3.若设备以被绑定，则同时按下③、④键，设备恢复出厂设置需要重新绑定小程序。4.绑定成功后，即可长按①键，与智能体进行对话。对话完成后需松手。
https://club.gizwits.com/data/attachment/forum/202507/25/114137dvkim83m8q8m6jqo.png.thumb.jpg
二、切换智能体与角色在【机智魔方】小程序中可以对设备的智能体与音色进行切换。https://club.gizwits.com/data/attachment/forum/202507/25/114330uabs61zn0y9yb0x4.png.thumb.jpg点击箭头进入https://club.gizwits.com/data/attachment/forum/202507/25/114336u41lf9fqfc5399f4.png.thumb.jpg选择一个智能体https://club.gizwits.com/data/attachment/forum/202507/25/114340v2sw373sp8t062oj.png.thumb.jpg
点击选用https://club.gizwits.com/data/attachment/forum/202507/25/114345zlv0zq8fro0obnld.png.thumb.jpg选择音色，点击保存三、帮助说明1.若设备通过 USB 长供电，则无需操作2️⃣开启设备，可直接操作同时长按 3S3️⃣、4️⃣键，恢复出厂设置，然后扫码绑定设备。2.若设备已被绑定，或需将设备重置，操作为同时长按 3S3️⃣、4️⃣键，进行重置配网。3.如设备持续 2 分钟没有收到用户的语音，将会进入休眠状态，可按2️⃣键唤醒设备。四、添加扣子智能体1. 功能说明智能体发布到机智云Gokit5开发板，是使用机智魔方小程序账号添加一个Gokit5开发板。在Gokit5开发板上通过开发板与扣子智能体进行语音对讲。2. 前提条件已购买了Gokit5开发板并且用【机智魔方】小程序对Gokit5进行配网已注册了扣子账号3. 如何发布智能体到机智云Gokit5开发板步骤一：在扣子平台上添加机智云发布渠道1). 登录扣子平台。
2). 在工作空间-发布管理，点击右上角发布渠道管理
https://club.gizwits.com/data/attachment/forum/202507/25/115133ut81jn9lnn1jfr7a.png.thumb.jpg
3). 点击右上角添加发布渠道-公共渠道，找到机智云物联网，点击添加
https://club.gizwits.com/data/attachment/forum/202507/25/115138b842qqwb52czvzg8.png.thumb.jpg
步骤二：在【机智魔方】上进行扣子平台的授权1). 用微信扫码打开【机智魔方】微信小程序，或者微信搜索【机智魔方】。https://club.gizwits.com/data/attachment/forum/202507/25/115143h418it8ki8r1khyo.png.thumb.jpg2). 通过【机智魔方】小程序给Gokit5进行配网。3). 在我的页面选择添加扣子智能体，点击去授权。https://club.gizwits.com/data/attachment/forum/202507/25/115148rm7bpmbjzyugm8ju.jpg.thumb.jpghttps://club.gizwits.com/data/attachment/forum/202507/25/115153baae0ne0s32kskp0.jpg.thumb.jpghttps://club.gizwits.com/data/attachment/forum/202507/25/115210ycu41psc3r484u8r.jpg.thumb.jpg4). 复制授权页链接并用浏览器打开。https://club.gizwits.com/data/attachment/forum/202507/25/115252wvs8adjaw33ea8hl.jpg.thumb.jpg5). 回到小程序复制授权码。
6). 回到浏览器在授权页填入授权码。（小程序20250301更新：复制授权页时会自动填充授权码）
7). 授权成功后选择需要配置智能体的设备并且勾选。https://club.gizwits.com/data/attachment/forum/202507/25/115301zjpppshyppai2ih8.jpg.thumb.jpghttps://club.gizwits.com/data/attachment/forum/202507/25/115307amx29omdzf92eix2.jpg.thumb.jpghttps://club.gizwits.com/data/attachment/forum/202507/25/115315rgrt9k4k2g8gd48g.jpg.thumb.jpg步骤三：将智能体发布到机智云Gokit5开发板1). 登录扣子平台。2). 在左侧导航栏中选择工作空间，并在页面顶部空间列表中选择个人空间或团队空间。
系统默认创建了一个个人空间，该空间内创建的资源例如智能体、插件、知识库是你的私有资源，其他用户不可见。你也可以创建团队或加入其他团队，团队内的资源可以和其他团队成员共享。更多信息，请参考管理团队。3). 在项目开发页面，选择智能体。
4). 在页面右上角，单击发布。5). 在发布页面，找到机智云Gokit5开发板发布，然后点击配置，选择需要发布的设备名称。https://club.gizwits.com/data/attachment/forum/202507/25/115325gap9c6f9h1kf1f96.jpg.thumb.jpg步骤四：切换Gokit5的智能体1). 配网后回到【机智魔方】首页，选择在步骤二中已配置的设备https://club.gizwits.com/data/attachment/forum/202507/25/115330ccgyrzddydp4ol5g.jpg.thumb.jpg2). 左右滑动可以切换智能体，找到自己发布的智能体点击选用即可体验https://club.gizwits.com/data/attachment/forum/202507/25/115337hx8f1ljyfn4grl85.jpg.thumb.jpg4. 如何解除扣子平台与设备的授权4.1. 解除扣子平台的授权. 在扣子的发布智能体重找到机智云渠道，点击配置https://club.gizwits.com/data/attachment/forum/202507/25/115344ggnbr7buibdvghyq.jpg.thumb.jpg
2). 在弹窗中点击解绑https://club.gizwits.com/data/attachment/forum/202507/25/115348a6fy2f9tggf9yxo2.jpg.thumb.jpg4.2. 解除小程序的授权在小程序我的-添加扣子智能体 中 点击解除授权https://club.gizwits.com/data/attachment/forum/202507/25/115402b6a5ieaa2ei6io1o.jpg.thumb.jpg4.3. 添加、重置设备后应该如何添加智能体添加或者重置设备之后应该在小程序-我的-添加扣子智能体中同步新的设备，并且在扣子平台上再发布一次智能体
https://club.gizwits.com/data/attachment/forum/202507/25/115406blqd39yyy6q99a9y.jpg.thumb.jpghttps://club.gizwits.com/data/attachment/forum/202507/25/115416umhslrkwt104jmok.jpg.thumb.jpg五、端插件使用说明机智云端插件目前支持Gokit5的按键亮度调节、播放音量调节，可用于自然语言控制设备。1. 端插件是什么端插件是扣子插件的一种类型，能够使智能体直接与本地设备进行交互，实现对本地设备的控制和信息获取。具体可见：《了解端插件》https://club.gizwits.com/data/attachment/forum/202507/25/120340q0bombl7c70r92bo.jpg.thumb.jpg2. 机智云端插件介绍目前机智云Gokit5定义了2个端插件：volume（播放音量）、brightness（按键亮度）
可点击此链接查看：《机智云AI智能体硬件端插件》3. 如何使用接下来介绍机智云端插件如何在对话流中进行使用，实现通过自然语言来控制设备https://club.gizwits.com/data/attachment/forum/202507/25/120347a6jnyhpn6h6ppcp6.jpg.thumb.jpg1).如volume可以用来调节音量，可以看到volume的端插件定义，需要给到该插件一个0-100的数字来控制音量的，因此需要有如下核心流程：https://club.gizwits.com/data/attachment/forum/202507/25/120355qih38s5ipmh7i6zn.jpg.thumb.jpg
步骤内容作用示例
1意图识别判断用户的输入意图是否需要对音量进行调节https://club.gizwits.com/data/attachment/forum/202507/25/120402dttp96hbv3wz9tvv.png.thumb.jpg
2LLM进行音量提取用户的输入可能是”太吵了”，“把音量调大一点”等自然语言，因此需要一个语言模型来将自然语言转换为具体等音量值https://club.gizwits.com/data/attachment/forum/202507/25/120408dm74qmsnhhmrvola.png.thumb.jpg
3调用端插件控制音量将音量提取出来的值通过端插件传递到设备端https://club.gizwits.com/data/attachment/forum/202507/25/120417z2b2rr1hrul66zhc.png.thumb.jpg
2). 通过变量来让智能体知道当前设备的运行状态
如果只是单纯的通过意图识别→音量提取→端插件 的核心链路，如果智能体不知道当前音量是无法做出准确的音量值输出的，因此我们可以在智能体定义2个变量值，用于存储每次调整的音量和亮度变化值。并且也可以支持通过查询变量来完成音量以及亮度的查询。https://club.gizwits.com/data/attachment/forum/202507/25/120423w5eeuiae0dazuzja.jpg.thumb.jpg变量默认值建议按以下数值：
变量默认值
volume80
brightness100
https://club.gizwits.com/data/attachment/forum/202507/25/120428uxvn5j3up5a23snp.jpg.thumb.jpghttps://club.gizwits.com/data/attachment/forum/202507/25/120433rlclr7b09d60baeq.jpg.thumb.jpg
六、常见问题1.为什么在扣子发布智能体时找不到我的设备？-在【机智魔方】小程序中，我的-添加扣子智能体-配置智能体到设备中，确认已经选择了设备进行同步-在【机智魔方】小程序中，我的-添加扣子智能体中，确认授权状态时处于授权成功2.Gokit5配不上网-确认所在地点信号是正常的-确认设备与路由器的物理距离不超过20米-确认SIM卡是否有效，是否有流量3.设备列表中设备离线-设备休眠：按2️⃣键唤醒（设备在2分钟无对话会自动触发）-网络波动：重启路由器4.设备无法开机-可能是设备没电了，找到Type-C供电5.小程序无法添加该设备-设备未注册-设备已被配过网，可长按3️⃣、4️⃣按键重置设备6.扣子平台发布渠道中找不到机智云物联网-确保已添加机智云渠道，可查看本文档的步骤一7.机智云物联网渠道找不到设备-确保在扣子平台上，工作空间-发布管理-右上方发布渠道管理中添加机智云物联网8.对话没有反应-可能是网络不好，尝试换个网络或者重置设备配置到手机热点-确保智能体是有输出的，可以在扣子平台上调节页面测试9.授权页面无法打开iOS用户：使用Safari浏览器（禁用内容拦截器）Android用户：切换Chrome浏览器、系统浏览器尝试通用方案：扫码后手动复制链接到PC端操作其他异常可以联系邮箱反馈
反馈邮箱：privacy@gizwits.com其他异常可以联系邮箱反馈
反馈邮箱：privacy@gizwits.com©2011-2025; Gizwits IoT Technology Co., Ltd. 粤ICP备11090211号
页:
[1]