智能体控制 - AIOT系统使用指南

🔧 Coze插件配置指南

💡

快速开始

通过以下步骤，在Coze平台上配置我们的IoT设备控制插件，让AI助手能够控制您的设备。整个过程大约需要5分钟。

📦 下载插件配置文件

在开始配置之前，请先下载我们为您准备好的插件配置文件。

⬇️ 下载 coze-plugin-lite.json

📄 文件大小: ~6 KB
📋 包含接口: 传感器查询、LED控制、预设指令

在Coze平台创建插件

访问Coze平台

打开 https://www.coze.cn/，使用您的账号登录。

进入资源库

在左侧导航栏中，点击 "工作空间" → "资源库"。

添加插件

点击页面右上角的 "添加插件" 按钮。

导入配置文件

在新建插件窗口中，点击右上角的 "导入" 按钮。

📁 选择文件: coze-plugin-lite.json
✅ 系统会自动解析插件配置

确认导入

依次点击 "下一步" → "确认"，完成插件添加。

启用工具

在资源库列表中找到刚添加的插件，将所有工具设置为 "启用" 状态。

⚠️

注意

确保将插件中的所有工具（传感器查询、LED控制、预设指令）都设置为启用状态。

试运行测试

刚添加的工具调试状态会显示为 "失败"，这是正常的。您需要进行试运行测试：

点击每个工具的 "试运行" 按钮
输入测试参数（可以使用以下示例值）

测试参数示例：
• uuid: test
• sensor: 温度
• port_type: led
• port_id: 1
• action: on
• preset_key: led_blink_k8x9y2

试运行通过后，状态会变更为 "通过" ✅

插件功能说明

接口名称	功能描述	主要参数
查询传感器数据	获取设备的温度、湿度等传感器数据	uuid, sensor (温度/湿度)
控制LED	控制LED灯的开关状态	device_uuid, port_type (led), port_id (1-4), action (on/off)
执行预设指令	通过preset_key执行用户自定义的预设命令	device_uuid, preset_key

💡

测试建议

配置完成后，建议先使用测试设备UUID（如 "test"）进行测试，确保一切正常后再连接真实设备。

测试对话示例：

"帮我查询一下温度"
"打开1号LED灯"
"关闭所有灯"

📝 提示词配置指南

🎯 推荐提示词（直接复制使用）

你是一个友好的智能家居助手，可以帮助用户控制IoT设备。

## 设备信息
设备UUID: 【请替换实际设备的UUID】

## 你的能力

### 1️⃣ 查询传感器数据
- 温度查询：当用户问"温度多少"、"几度"、"热不热"
- 湿度查询：当用户问"湿度多少"、"潮湿吗"、"干燥吗"

### 2️⃣ 控制LED灯
- 支持LED 1-4号
- 开灯：当用户说"打开灯"、"开灯"、"点亮LED"
- 关灯：当用户说"关灯"、"关闭灯"、"熄灯"

### 3️⃣ 执行预设指令

**可用预设列表：**

| 预设名称 | 触发词 | preset_key | 说明 |
|---------|--------|------------|------|
| 眨眼睛 | "眨眼睛"、"眨一下" | led_seq_mi71o69r | LED1点亮3秒后熄灭 |

**使用方法：**
当用户说出触发词时，使用对应的preset_key调用预设接口。

## 交互规则

### ✅ 应该做的
1. 当用户查询温度/湿度时，直接调用传感器接口
2. 当用户要控制LED时，先确认是哪个LED（1-4），然后调用控制接口
3. 当用户说出预设触发词（如"眨眼睛"）时，直接使用对应的preset_key调用预设接口
4. 用简洁友好的语言回复结果
5. 如果用户指令不明确，主动询问清楚

### ❌ 不要做的
1. 不要向用户索要设备UUID（已经通过变量传入）
2. 不要提供超出能力范围的功能（如继电器、舵机、PWM等）
3. 不要过度解释技术细节
4. 不要在用户没问的情况下重复查询数据

## 回复示例

### 传感器查询
用户："现在温度多少？"
你：[调用传感器接口]
你："当前温度是24.5°C 😊"

### LED控制
用户："帮我开灯"
你："好的，请问要打开哪个LED灯呢？我们有LED 1到4号"
用户："LED1"
你：[调用控制接口]
你："✨ LED1已打开"

### 预设指令
用户："眨眼睛"
你：[调用预设接口，preset_name="led_seq_mi71o69r"]
你："✅ LED1将点亮3秒后自动熄灭"

## 特别提示
- 所有操作都自动使用设备UUID变量，你无需管理
- 如果接口返回错误，友好地告知用户"暂时无法操作，请稍后重试"
- 保持对话自然流畅，像朋友一样交流

💡 使用说明：点击上方"一键复制"按钮复制整个提示词，然后粘贴到Coze Bot的"用户提示词"区域即可。

⚠️ 记得修改UUID。

⚠️ 将预设列表中的示例替换为你自己的预设指令和preset_key。

✨ 如何自定义预设列表

预设指令允许你通过自然语言触发复杂的设备动作序列。下面是一个完整的示例：

💡 示例：LED1亮3秒预设

在提示词中添加：

### 3️⃣ 执行预设指令

**可用预设列表：**

| 预设名称 | 触发词 | preset_key | 说明 |
|---------|--------|------------|------|
| 眨眼睛 | "眨眼睛"、"眨一下" | led_seq_mi71o69r | LED1点亮3秒后熄灭 |

**使用方法：**
当用户说出触发词时，使用对应的preset_key调用预设接口。

💬 对话示例：

用户："眨眼睛"

Bot：[调用预设接口，preset_name="led_seq_mi71o69r"]

Bot："✅ LED1将点亮3秒后自动熄灭"

🔑 如何获取 preset_key（预设标识）

📍 在管理后台查看

登录管理后台

访问 AIOT 管理后台，使用您的账号登录。

进入设备配置

点击左侧菜单的 "设备管理"，选择要配置的设备。

查看预设指令

在设备配置页面，找到 "预设指令配置" 区域。

复制 preset_key

每个预设指令旁边都会显示其 preset_key，点击复制按钮即可复制。

例如：led_seq_mi71o69r

📸 界面示意

在设备配置页面，预设指令区域显示如下：

眨眼睛

序列指令 - LED1点亮3秒后熄灭

preset_key: led_seq_mi71o69r

💡

使用技巧

多个预设：如果有多个预设指令，在提示词的表格中添加多行即可
触发词优化：为每个预设配置多个自然的触发词，提高识别率
描述清晰：在"说明"列清楚描述预设的功能，帮助AI理解
测试验证：配置完成后，用多种说法测试触发词是否生效

常见问题

❓ 插件导入失败怎么办？

确保下载的 coze-plugin-lite.json 文件完整，没有被浏览器修改。如果还是失败，可以尝试重新下载。

❓ AI响应太慢怎么办？

检查是否关闭了大模型节点的"深度思考"开关。开启深度思考会导致每次对话耗时30秒以上。

❓ 如何获取设备的UUID？

登录管理后台，在"设备管理"页面可以查看所有设备的UUID。或者在设备配置时系统会自动生成并显示。

❓ preset_key在哪里查看？

在管理后台的"设备配置"页面，每个预设指令都会显示其唯一的preset_key，点击旁边的复制按钮即可复制。preset_key的格式通常类似于 led_seq_mi71o69r。

🤖 智能体控制指南