解锁本地设备交互：机智云端插件接入Gokit5实战指南（音量/亮度控制）

端插件使用说明

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

1、端插件是什么

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

《了解端插件》

机智云端插件介绍

目前机智云Gokit5定义了2个端插件：volume（播放音量）、brightness（按键亮度）

可点击此链接查看：

《机智云AI智能体硬件端插件》

如何使用

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

1）、如volume可以用来调节音量，可以看到volume的端插件定义，需要给到该插件一个0-100的数字来控制音量的，因

此需要有如下核心流程：

2）、通过变量来让智能体知道当前设备的运行状态

如果只是单纯的通过意图识别→音量提取→端插件 的核心链路，如果智能体不知道当前音量是无法做出准确的音量值输出的，因此我们可以在智能体定义2个变量值，用于存储每次调整的音量和亮度变化值。并且也可以支持通过查询变量来完成音量以及亮度的查询。

变量默认值建议按以下数值：

常见问题

1、为什么在扣子发布智能体时找不到我的设备？

-在【机智魔方】小程序中，我的-添加扣子智能体-配置智能体到设备中，确认已经选择了设备进行同步

-在【机智魔方】小程序中，我的-添加扣子智能体中，确认授权状态时处于授权成功

2、Gokit5配不上网

-确认所在地点信号是正常的

-确认设备与路由器的物理距离不超过20米

-确认SIM卡是否有效，是否有流量

3、设备列表中设备离线

-设备休眠：按键唤醒（设备在2分钟无对话会自动触发）

-网络波动：重启路由器

4、设备无法开机

-可能是设备没电了，找到Type-C供电

5、小程序无法添加该设备

-设备未注册

-设备已被配过网，可长按、按键重置设备

6、扣子平台发布渠道中找不到机智云物联网

-确保已添加机智云渠道，可查看本文档的步骤一

7、机智云物联网渠道找不到设备

-确保在扣子平台上，工作空间-发布管理-右上方发布渠道管理中添加机智云物联网

8、对话没有反应

-可能是网络不好，尝试换个网络或者重置设备配置到手机热点

-确保智能体是有输出的，可以在扣子平台上调节页面测试

9、授权页面无法打开

iOS用户：使用Safari浏览器（禁用内容拦截器）

Android用户：切换Chrome浏览器、系统浏览器尝试

通用方案：扫码后手动复制链接到PC端操作