用途:该技能提供对 Home Assistant REST API 的访问,用于构建集成、自动化智能家居设备,并以编程方式管理 Home Assistant 实例。
主要能力:按任务路由到对应资源文件——认证与 API 基础(resources/core-concepts.md)、实体状态查询与监控(resources/state-management.md)、灯光/温控/门锁等设备控制(resources/service-reference.md)、实体类型说明(resources/entity-types.md)、服务端模板查询与聚合(resources/templates.md)、系统配置与日志(resources/system-config.md)、完整代码示例(resources/examples.md)。
使用方式:先做任务分析,再按决策树选择端点。查询用 GET /api/states/{entity_id}、GET /api/states、GET /api/config、GET /api/services、GET /api/events、GET /api/history/period/{timestamp}、GET /api/error_log;复杂查询用 POST /api/template。控制设备用 POST /api/services/{domain}/{service},如 POST /api/services/light/turn_on,参数含 entity_id、brightness 等。修改状态用 POST/DELETE /api/states/{entity_id},触发事件用 POST /api/events/{event_type}。系统管理用 POST /api/config/core/check_config、POST /api/services/homeassistant/restart 等。批量操作可在一次调用中传入 entity_id 数组。
适用场景:查询温度或门锁状态、开关灯与开关、设置温控、控制窗帘与媒体播放器、统计开启的灯数量、检查配置与查看错误日志、编写 Python/Node.js/Bash/curl 客户端。
限制:需有效的认证令牌与正确的 entity_id(domain.name 格式);需区分 GET/POST/DELETE 方法;应处理 401、404、400、500 等错误并考虑重试与轮询性能。具体收费、价格与平台支持情况暂未提供。