端插件使用說明

機(jī)智云端插件目前支持Gokit5的按鍵亮度調(diào)節(jié)、播放音量調(diào)節(jié)，可用于自然語言控制設(shè)備。

1、端插件是什么

端插件是扣子插件的一種類型，能夠使智能體直接與本地設(shè)備進(jìn)行交互，實現(xiàn)對本地設(shè)備的控制和信息獲取。具體可見：

《了解端插件》

機(jī)智云端插件介紹

目前機(jī)智云Gokit5定義了2個端插件：volume（播放音量）、brightness（按鍵亮度）

可點擊此鏈接查看：

《機(jī)智云AI智能體硬件端插件》

如何使用

接下來介紹機(jī)智云端插件如何在對話流中進(jìn)行使用，實現(xiàn)通過自然語言來控制設(shè)備

1）、如volume可以用來調(diào)節(jié)音量，可以看到volume的端插件定義，需要給到該插件一個0-100的數(shù)字來控制音量的，因

此需要有如下核心流程：

2）、通過變量來讓智能體知道當(dāng)前設(shè)備的運(yùn)行狀態(tài)

如果只是單純的通過意圖識別→音量提取→端插件 的核心鏈路，如果智能體不知道當(dāng)前音量是無法做出準(zhǔn)確的音量值輸出的，因此我們可以在智能體定義2個變量值，用于存儲每次調(diào)整的音量和亮度變化值。并且也可以支持通過查詢變量來完成音量以及亮度的查詢。

變量默認(rèn)值建議按以下數(shù)值：

常見問題

1、為什么在扣子發(fā)布智能體時找不到我的設(shè)備？

-在【機(jī)智魔方】小程序中，我的-添加扣子智能體-配置智能體到設(shè)備中，確認(rèn)已經(jīng)選擇了設(shè)備進(jìn)行同步

-在【機(jī)智魔方】小程序中，我的-添加扣子智能體中，確認(rèn)授權(quán)狀態(tài)時處于授權(quán)成功

2、Gokit5配不上網(wǎng)

-確認(rèn)所在地點信號是正常的

-確認(rèn)設(shè)備與路由器的物理距離不超過20米

-確認(rèn)SIM卡是否有效，是否有流量

3、設(shè)備列表中設(shè)備離線

-設(shè)備休眠：按鍵喚醒（設(shè)備在2分鐘無對話會自動觸發(fā)）

-網(wǎng)絡(luò)波動：重啟路由器

4、設(shè)備無法開機(jī)

-可能是設(shè)備沒電了，找到Type-C供電

5、小程序無法添加該設(shè)備

-設(shè)備未注冊

-設(shè)備已被配過網(wǎng)，可長按、按鍵重置設(shè)備

6、扣子平臺發(fā)布渠道中找不到機(jī)智云物聯(lián)網(wǎng)

-確保已添加機(jī)智云渠道，可查看本文檔的步驟一

7、機(jī)智云物聯(lián)網(wǎng)渠道找不到設(shè)備

-確保在扣子平臺上，工作空間-發(fā)布管理-右上方發(fā)布渠道管理中添加機(jī)智云物聯(lián)網(wǎng)

8、對話沒有反應(yīng)

-可能是網(wǎng)絡(luò)不好，嘗試換個網(wǎng)絡(luò)或者重置設(shè)備配置到手機(jī)熱點

-確保智能體是有輸出的，可以在扣子平臺上調(diào)節(jié)頁面測試

9、授權(quán)頁面無法打開

iOS用戶：使用Safari瀏覽器（禁用內(nèi)容攔截器）

Android用戶：切換Chrome瀏覽器、系統(tǒng)瀏覽器嘗試

通用方案：掃碼后手動復(fù)制鏈接到PC端操作