SuperAPI AI 工具集

home-assistant

通用与其它

查看项目

更新于 10-16 06:15

技能介绍

该技能用于通过 Home Assistant 的 REST API 和 webhook 控制智能家居设备。使用前需配置连接信息:推荐在 ~/.config/home-assistant/config.json 中填写 url 与 token,或设置环境变量 HA_URL 和 HA_TOKEN。长期访问令牌需在 Home Assistant 个人资料页创建。

主要能力包括:列出与搜索实体、查询实体状态、控制设备(开、关、切换、亮度等)、触发脚本与自动化、激活场景,以及调用各类服务。文档给出的常见域包括 light、switch、climate、cover、media_player、scene、script、automation,示例实体如 light.kitchen、climate.thermostat、cover.garage。

使用方式上,可直接用 curl 调用 REST 接口,例如列出实体:curl -s -H "Authorization: Bearer $HA_TOKEN" "$HA_URL/api/states";控制灯光:curl -X POST -H "Authorization: Bearer $HA_TOKEN" -H "Content-Type: application/json" "$HA_URL/api/services/light/turn_on" -d '{"entity_id": "light.living_room"}'。也可通过 scripts/ha.sh CLI 包装脚本操作,如 ha.sh list lights、ha.sh state light.living_room、ha.sh on light.living_room 200、ha.sh scene movie_night、ha.sh climate climate.thermostat 22、ha.sh call light turn_on '{"entity_id":"light.room","brightness":200}'。

入站 webhook 方面,Home Assistant 自动化可调用 rest_command 向指定 webhook 地址发送事件与区域信息,由接收方据此通知或触发动作。

限制与故障处理:401 表示令牌过期或无效,需重新生成;连接被拒需检查 HA_URL 及 HA 是否运行;实体不存在时可通过列出实体确认真实 entity_id。更高级用法参见 references/api.md。其他平台支持或收费信息暂未提供。