端插件使用說明

機智云端插件目前支持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端操作