iot-gnvirtualdevice-manage
SKILL.md
自然语言驱动的 IoT 业务操作指南
本文档面向「大模型 / 对话式助手」场景：用户通过自然语言完成设备注册、设备解绑、设备上/下线、IoT 设备列表查询等操作。底层业务逻辑与 IoT 平台 HTTP 接口约定一致，与具体宿主（Web、Box、独立 Agent）无关。
使用前必须先完成环境配置；配置须与当前对话角色（或用户）绑定，并由宿主持久化记忆后注入模型上下文——模型本身不长期「背诵」密钥。
1. 文档目标与适用范围
| 目标 | 说明 |
|---|---|
| 意图识别 | 将用户说法映射到固定业务意图（注册 / 解绑 / 上下线 / 列表等）。 |
| 槽位填充 | 从话术中抽取或通过澄清问题补全：productKey、deviceId、单台/批量、家庭名（familyName）、白名单/排除名单、在线状态等；口语说法与 PK/设备 ID 的对应关系见 §4。 |
| 回复与确认 | 成功/失败须含 PK、设备 id、操作名称及失败原因（失败时）；列表仅用六列表格；禁止省略明细；环境与入参未明说时须二次确认并可提示「上次沿用」——详见 §1.1。 |
| 安全与上下文 | 登录态、环境（测试/预发/正式）、账号身份由会话上下文提供，模型不杜撰密钥。 |
不在本文范围：账户密码明文存储、绕过平台鉴权、未授权解绑他人设备。