SuperAPI AI 工具集

home-assistant-entities-services

办公与效率

查看项目

更新于 10-15 14:39

技能介绍

用途

该技能面向 Home Assistant 的实体(entities)与服务(services)管理,帮助在自动化、脚本或配置操作中正确地发现、检查与修改实体及其相关资源。适用于用户询问实体或服务、需要检查当前状态与元数据、涉及辅助元素(helpers)选择、模板编写,或进行实体重命名与重构等场景。

主要能力

技能覆盖以下操作类别:

  • 实体发现:通过 ha_get_overview、ha_search_entities、ha_get_state 发现实体并获取状态。
  • 使用与历史查询:通过 ha_deep_search、ha_get_history、ha_get_statistics 查找使用情况与历史数据。
  • 实体管理:通过 ha_get_entity、ha_set_entity、ha_rename_entity、ha_rename_entity_and_device 获取、设置、重命名实体。
  • 设备管理:通过 ha_get_device、ha_update_device 获取与更新设备。
  • 辅助元素(helpers):通过 ha_config_list_helpers、ha_config_set_helper、ha_create_config_entry_helper 列出、设置与创建辅助元素。
  • 标签(labels):通过 ha_config_get_label、ha_config_set_label、ha_manage_entity_labels 获取、设置标签并管理实体标签。
  • 分组(groups):通过 ha_config_list_groups、ha_config_set_group、ha_config_remove_group 列出、设置与移除分组。
  • 服务(services):通过 ha_list_services、ha_call_service 列出与调用服务。

使用方式

技能定义了明确的工作流:

  1. 在操作前先发现实体与服务。
  2. 在更新前检查当前状态与元数据。
  3. 当涉及辅助元素选择、模板编写或实体重命名/重构时,遵循 home-assistant-best-practices 参考文档。
  4. 提供最少的工具调用或 YAML 示例。

参考文件均相对于该 SKILL.md 文件所在位置,包括:

  • 最佳实践:home-assistant-best-practices(其 references/helper-selection.md、references/template-guidelines.md、references/device-control.md、references/safe-refactoring.md)
  • 状态对象快速参考:references/STATE_OBJECT_QUICKREF.md
  • 受限模板:references/LIMITED_TEMPLATES.md

适用场景

  • 用户询问 Home Assistant 中的实体或服务。
  • 需要检查实体当前状态或元数据后再进行更新。
  • 涉及辅助元素选择、模板编写或实体重命名与重构。
  • 需要列出或调用服务、管理标签与分组。

限制

资料未提供该技能的具体安装方式、依赖版本、平台兼容性、收费或价格信息,这些内容暂未提供。