天工ai需启用「iot指令解析器」插件并正确配置平台（home assistant/阿里云iot/涂鸦），输入带【设备域】【位置】【动作】标签或已注册别名的指令，输出含platform、service、data（含entity_id/device_id）的结构化命令，经ha developer tools验证执行。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
你需要让天工AI把“把客厅灯调暗一点”“空调设为26度除湿模式”这类口语化指令，准确转成智能设备能执行的结构化命令（如MQTT Topic + Payload或Home Assistant Service Call），而不是泛泛回答或生成文案。
确认天工AI接入智能家居协议环境
登录天工AI开发者控制台 → 进入「智能体配置」→ 在「能力插件」中启用「IoT指令解析器」插件。该插件默认不激活，【未启用时所有指令都会被当作普通文本处理，不会输出设备可执行格式】。
点击插件右侧「配置」按钮 → 选择已对接的平台：Home Assistant、阿里云IoT、涂鸦OpenAPI三选一。选错平台会导致后续生成的JSON字段名与实际API不匹配，例如Home Assistant需输出service: light.turn_on，而涂鸦需输出tuya_mqtt_topic: /v1.0/xxx。
构造带上下文约束的指令输入
直接输入“打开卧室灯”可能被解析为通用语义，无法触发设备控制。必须显式声明设备域和动作意图。
方法一：前置声明设备类型与位置
输入：“【设备域：照明】【位置：主卧】【动作：开启】请将主卧吸顶灯打开”。天工AI会识别【】内标签，优先匹配已注册的主卧灯具实体ID，并生成light.turn_on服务调用。
天工AI (iOS) 5.2.1版本新增 PPT 生成页数配置、十余种专业视频模板，并且支持设置视频比例与时长；定时任务可指定模型并推送到 IM 渠道。修复了下载失败等问题，提升了稳定性与内容创作体验，让创作更自由、更高效。
方法二：绑定设备别名（需提前在Home Assistant中设置）
在Home Assistant前端为设备设置别名“主卧主灯”，然后输入：“用‘主卧主灯’执行开灯操作”。这一步依赖HA的alias映射机制，【若别名未在HA前端保存生效，天工AI无法反查到对应entity_id】。
获取并验证输出的结构化指令
第一步：查看天工AI返回的完整响应体，确认包含以下三要素：
• “platform”: “homeassistant” 或 “tuya”
• “service”: 如 “light.turn_on”
• “data”: 必须含 “entity_id”（HA）或 “device_id”（涂鸦）字段。
第二步：复制返回的JSON内容 → 粘贴至Home Assistant Developer Tools → Services Tab → 手动触发对应service → 观察设备是否真实响应。如果设备无反应，检查JSON中entity_id是否与HA前端Settings → Devices & Services里显示的ID完全一致（含大小写、下划线）。
第三步：若返回内容含“error”: “device not found”，说明天工AI未成功关联设备实体——此时需回到第一步，重新核对插件配置中的平台选择与设备注册状态。
