2025.3.4
首页 ▸ Voice control ▸

与助手交谈 - 句子启动包

Home Assistant 提供了社区贡献的 内置句子，支持 数十种语言。

前提条件

  • 你想用助手控制的实体必须 暴露给助手。
  • 在使用实体或区域的名称时，确保使用与 Home Assistant 中定义的名称完全相同，或者 创建一个别名。

设备控制

开关实体

  • 打开客厅灯
  • 关闭天花板风扇
  • 打开电视
  • 锁上所有门
  • 打开大门

灯光

  • 将厨房灯亮度调至 50%
  • 将床头灯设为绿色
  • 将床头灯亮度调至 50%
  • 将客厅亮度调至 50%
  • 将亮度调至 50%
    • 使用语音卫星的区域
  • 将厨房灯设为红色
  • 将灯设为红色
    • 使用语音卫星的区域
  • 打开客厅的灯

窗帘

  • 关闭车库门
  • 打开厨房窗户
  • 哪些窗帘是关闭的
  • 将卧室窗帘调至 50%

场景和脚本

  • 运行隐秘模式脚本
  • 激活晚餐场景
  • 打开厨房晚餐场景

媒体播放器

  • 电视上下一项
  • 下一首曲目
  • 办公室里的下一首曲目
  • 上一曲
  • 办公室里的上一曲
  • 跳过电视上的歌曲
  • 跳过电视上的曲目
  • 跳到电视上的下一首歌
  • 暂停|继续
    • 暂停或继续语音卫星或当前区域的音乐
  • 暂停|继续 “区域” 音乐
    • 暂停或继续该区域的音乐
  • 暂停|继续 “实体”
    • 暂停或继续媒体播放器上的音乐
  • 恢复电视
  • 电视恢复
  • *将电视音量设为 90%
  • 将电视音量改为 90
  • 将电视音量调低至 90%

吸尘器

  • 将机器人送回基地
  • 启动机器人

列表

  • 将面包加入我的购物清单
  • 将装饰圣诞树加入我的十二月待办事项清单
    • 需要名为 “十二月待办事项” 的待办事项清单
  • 将清理车库加入周末清单
    • 需要名为 “周末” 的待办事项清单

日期和时间

  • 现在几点了？
  • 今天几号？

定时器

启动

  • 设置一个 5 分钟的定时器
  • 5 分钟定时器
  • 为披萨设置一个 20 分钟的定时器
  • 设置一个 1小时 3 分钟的定时器
    • 以小时、分钟和秒分开，而不是使用像 设置 63 分钟的定时器 这样的技术术语。

取消

  • 取消定时器
    • 目前无法取消多个定时器
  • 取消 5 分钟定时器
  • 取消披萨定时器
  • 取消厨房定时器
    • 必须是由厨房的语音卫星设置的

添加/移除时间

  • 为披萨定时器添加 5 分钟
  • 为厨房定时器添加 5 分钟
  • 从定时器移除 1 分钟
  • 从 5 分钟定时器移除 1 分钟

状态

  • 定时器状态
  • 披萨定时器还剩多少时间？
  • 厨房定时器还剩多少时间？
  • 5 分钟定时器还剩多少时间？

在 S3-Box-3B 运行的定时器，带有倒计时文本和加载条！

要了解如何设置，请参考 ESP32-S3-Box-3B 教程。

结合定时器和设备控制以添加延时

与常规语音定时器不同，延迟命令无法取消或修改。

  • 在 5 分钟内关闭客厅灯
  • 在 10 分钟内暂停电视
  • 在 5 分钟内打开窗帘

中止

  • 没事: 如果你错误地触发了唤醒词并想让 Home Assistant 停止监听

故障排除

支持的句子列表在不断更新，对于每种语言都有很多可能的句子，因此无法在这里列出所有句子。要了解您的语言中可以使用的内容，请按照以下步骤操作。

  1. 如果语音助手无法理解您，您可能需要稍微修改您的句子。或者检查 entity实体表示 Home Assistant 中的传感器、执行器或功能。实体用于监控物理属性或控制其他实体。实体通常是设备或服务的一部分。 [Learn more] 或 area在 Home Assistant 中，区域是设备和实体的逻辑分组，旨在匹配物理世界中的区域（或房间）：您的家。例如，客厅区域将分组您客厅中的设备和实体。 的名称是否正确。

  2. 查看测试句子：

    • 在 GitHub 的 tests 文件夹中，打开您语言的子文件夹。

    • 浏览测试文件以查看已测试的示例句子。

    • 文件名的第二部分显示 intent意图是与语音助手一起使用的术语。意图是 Home Assistant 从您的语音或文本表达中提取命令时认为您想要它执行的操作。 [Learn more]，第一部分显示 domainHome Assistant 中的每个集成都有一个唯一标识符：域。它通常显示为实体 ID 的第一部分（点之前）。。某些 domainsHome Assistant 中的每个集成都有一个唯一标识符：域。它通常显示为实体 ID 的第一部分（点之前）。，例如窗帘、风扇和灯有特定的句子。 其他 domainsHome Assistant 中的每个集成都有一个唯一标识符：域。它通常显示为实体 ID 的第一部分（点之前）。 使用通用的 homeassistant_。

      助手句子测试文件的文件夹示例

    • 以下截图显示用于测试打开灯命令的句子。请注意，这里的 客厅 只是一个占位符。 它可以是您家庭中的任何 area在 Home Assistant 中，区域是设备和实体的逻辑分组，旨在匹配物理世界中的区域（或房间）：您的家。例如，客厅区域将分组您客厅中的设备和实体。。

      一组测试句子的示例

  3. 查看测试的句子定义：

    • 在 GitHub 的 sentences 文件夹中，打开您语言的子文件夹。

    • 打开感兴趣的文件。

      打开灯的句子定义

      • () 表示可选元素。
      • [] 表示可选元素。
      • <> 表示扩展规则。要查看这些规则，请在 _common.yaml 文件中搜索 expansion_rules。
      • 语法在 模板句子语法文档 中详细解释。

  4. 查看您语言的 句子定义。

  5. 查看 响应定义。

  6. 如果询问天气预报时出现问题，请查看 故障排除部分 以查看常见错误。

更多句子

您可以扩展 内置句子 或 添加自己的句子，以触发 Home Assistant 中的任何操作。

相关主题

相关链接