机智云Gokit5AI智能体开发板（4G）操作说明

小Lin同学 · 发表于 2025-7-28 10:05:51

本帖最后由小Lin同学于 2025-7-28 10:09 编辑

机智云 Gokit5 AI智能体开发板（4G）操作说明

gokit5 是一款零代码智能体开发板，开发者可专注于智能体的业务逻辑设计，快速搭建属于自己的 AI 智能体对讲系统。本文旨在说明 Gokit5 的使用流程。

一、使用说明

1.长按②键3s对，开启设备，灯光开始闪烁（如更换键帽，可以type-c、收音口位置定位按键的位置）

2.扫描设备后方二维码进行绑定设备。

3.若设备以被绑定，则同时按下③、④键，设备恢复出厂设置需要重新绑定小程序。

4.绑定成功后，即可长按①键，与智能体进行对话。对话完成后需松手。

二、切换智能体与角色

在【机智魔方】小程序中可以对设备的智能体与音色进行切换。

点击箭头进入

选择一个智能体

点击选用

选择音色，点击保存

三、帮助说明

1.若设备通过 USB 长供电，则无需操作2️⃣开启设备，可直接操作同时长按 3S3️⃣、4️⃣键，恢复出厂设置，然后扫码绑定设备。

2.若设备已被绑定，或需将设备重置，操作为同时长按 3S3️⃣、4️⃣键，进行重置配网。

3.如设备持续 2 分钟没有收到用户的语音，将会进入休眠状态，可按2️⃣键唤醒设备。

四、添加扣子智能体

1. 功能说明

智能体发布到机智云Gokit5开发板，是使用机智魔方小程序账号添加一个Gokit5开发板。在Gokit5开发板上通过开发板与扣子智能体进行语音对讲。

2. 前提条件

已购买了Gokit5开发板并且用【机智魔方】小程序对Gokit5进行配网

已注册了扣子账号

3. 如何发布智能体到机智云Gokit5开发板

步骤一：在扣子平台上添加机智云发布渠道

1). 登录扣子平台。
2). 在工作空间-发布管理，点击右上角发布渠道管理

3). 点击右上角添加发布渠道-公共渠道，找到机智云物联网，点击添加

步骤二：在【机智魔方】上进行扣子平台的授权

1). 用微信扫码打开【机智魔方】微信小程序，或者微信搜索【机智魔方】。

2). 通过【机智魔方】小程序给Gokit5进行配网。

3). 在我的页面选择添加扣子智能体，点击去授权。

4). 复制授权页链接并用浏览器打开。

5). 回到小程序复制授权码。
6). 回到浏览器在授权页填入授权码。（小程序20250301更新：复制授权页时会自动填充授权码）
7). 授权成功后选择需要配置智能体的设备并且勾选。

步骤三：将智能体发布到机智云Gokit5开发板

1). 登录扣子平台。

2). 在左侧导航栏中选择工作空间，并在页面顶部空间列表中选择个人空间或团队空间。
系统默认创建了一个个人空间，该空间内创建的资源例如智能体、插件、知识库是你的私有资源，其他用户不可见。你也可以创建团队或加入其他团队，团队内的资源可以和其他团队成员共享。更多信息，请参考管理团队。

3). 在项目开发页面，选择智能体。
4). 在页面右上角，单击发布。

5). 在发布页面，找到机智云Gokit5开发板发布，然后点击配置，选择需要发布的设备名称。

步骤四：切换Gokit5的智能体

1). 配网后回到【机智魔方】首页，选择在步骤二中已配置的设备

2). 左右滑动可以切换智能体，找到自己发布的智能体点击选用即可体验

4. 如何解除扣子平台与设备的授权

4.1. 解除扣子平台的授权

. 在扣子的发布智能体重找到机智云渠道，点击配置

2). 在弹窗中点击解绑

4.2. 解除小程序的授权

在小程序我的-添加扣子智能体中点击解除授权

4.3. 添加、重置设备后应该如何添加智能体

添加或者重置设备之后应该在小程序-我的-添加扣子智能体中同步新的设备，并且在扣子平台上再发布一次智能体

五、端插件使用说明

机智云端插件目前支持Gokit5的按键亮度调节、播放音量调节，可用于自然语言控制设备。

1. 端插件是什么

端插件是扣子插件的一种类型，能够使智能体直接与本地设备进行交互，实现对本地设备的控制和信息获取。具体可见：《了解端插件》

2. 机智云端插件介绍

目前机智云Gokit5定义了2个端插件：volume（播放音量）、brightness（按键亮度）
可点击此链接查看：《机智云AI智能体硬件端插件》

3. 如何使用

接下来介绍机智云端插件如何在对话流中进行使用，实现通过自然语言来控制设备

1). 如volume可以用来调节音量，可以看到volume的端插件定义，需要给到该插件一个0-100的数字来控制音量的，因此需要有如下核心流程：

步骤	内容	作用	示例
1	意图识别	判断用户的输入意图是否需要对音量进行调节
2	LLM进行音量提取	用户的输入可能是”太吵了”，“把音量调大一点”等自然语言，因此需要一个语言模型来将自然语言转换为具体等音量值
3	调用端插件控制音量	将音量提取出来的值通过端插件传递到设备端