故障排除助手

本节列出了几个可能帮助您排除Assist问题的步骤。

查看调试信息

1. 转到 设置 > 语音助手。
2. 从助手列表中，选择您的助手并在对话框中选择 调试。
3. 在屏幕顶部，从下拉菜单中选择您感兴趣的运行。

测试每种语言的句子，无需语音：不执行命令

如果您想测试一个句子在特定语言中是否有效，而不实际执行命令，请使用 开发者工具 中的句子解析器。

1. 转到 开发者工具 > Assist。
2. 在句子解析器中，选择语言并输入您想测试的句子。
3. 调试工具将显示以下内容：
   • 触发的意图。
   • 目标实体。
   • 匹配的目标实体。

测试每个助手的句子，无需语音：在执行命令时

如果您想测试一个句子与特定助手的工作情况，同时积极执行命令，请使用 调试 视图中的句子解析器。

1. 打开调试视图。
2. 在右上角，选择图标。
3. 选择您想测试的助手。
4. 选择 运行文本管道。
5. 输入您想测试的短语并选择 运行。
6. 检查是否有效。
   • 如果短语无效，尝试变体。例如，如果 关掉灯 不工作，尝试：关掉厨房的灯。
   • 检查您的短语是否 支持。
   • 确保您使用的区域名称与Home Assistant中的定义一致。如果您有一个叫 浴室 的房间，短语 打开浴室的灯 将无法工作。

我看不到任何助手

如果在 设置 > 语音助手 下您看不到任何助手，您没有使用默认配置。下面的图片显示了 Assist 部分。

如果 Assist 部分完全缺失，您需要在 configuration.yaml 文件中添加以下内容：

# 示例 configuration.yaml 条目
assist_pipeline:

Assist 无法理解我关于天气预报的问题

以下示例显示了询问天气时的常见误区。虽然某些步骤与天气相关，但一般机制也适用于其他实体。

1. 确保您已安装 天气服务。

   • 默认情况下，安装了 Met.no。

2. 确保您已经为您感兴趣的位置设置了一个实体。

   • 例如，如果您对柏林的天气感兴趣，添加一个柏林的实体。

     

3. 确保实体对Assist可见：

   • 在 设置 > 设备和服务 > 实体 下，选择该位置的天气实体。

   • 在打开的详细信息视图中，选择齿轮图标 ，然后选择 语音助手。

     

   • 确保实体对Assist可见。

     

4. 确保您对Assist说话时使用确切的实体名称。

   • 要查看实体名称，请检查 设置 > 设备和服务 > 实体 下的列表。

   • 例如，如果实体被称为 柏林天气预报，您必须说 “柏林天气预报的天气怎么样”。

   • 如果您问 “柏林的天气怎么样”，Assist将无法识别。

   • 如果您想用柏林代替 柏林天气预报，您可以创建一个实体名称别名。

     • 您可以创建任意数量的别名。

     

5. 如果您只是问 “天气怎么样”，而您有多个实体的天气预报，Assist始终返回第一个添加的地方的数据。目前，没有办法更改这一点。

我没有收到语音回复

我的语音助手理解我并处理了命令，但我没有收到语音回复。

语音回复是在Home Assistant中通过我们支持的文本到语音（或 TTSTTS（文本到语音）允许 Home Assistant 与您对话。 [Learn more] ）引擎生成的。 然后，语音助手设备会从Home Assistant获取音频文件并播放它。

本地网络设置

为了使此获取过程正常工作，Home Assistant必须将其自己的URL传达给设备。 如果您有复杂的网络设置，或者您以前更改了此设置，传达的URL可能是错误的。

要修复URL，请执行以下步骤：

1. 在 您的用户个人资料 中，启用 高级模式。
2. 转到 设置 > 系统 > 网络。
3. 将本地网络Home Assistant URL更改为可以本地访问的URL，并指向Home Assistant。
   • 对于大多数用户，自动选项有效并且推荐使用。

缺少媒体源

如果您使用YAML配置且没有default_config:，请确保 media_source: 存在。

调整您设备的Assist音频配置

您觉得背景噪音或扬声器音量有问题吗？在某些情况下，调整噪声抑制和您的语音助手设备（如 S32-S3-BOX-3）的增益等设置可能会有所帮助。

调整您设备的Assist音频配置

1. 确保您已安装ESPHome插件：

   • 转到 设置 > 附加组件 > 附加组件商店。
   • 如果您没有安装 ESPHome 附加组件，请安装它。

2. 启动ESPHome附加组件，并选择 打开Web界面。

3. 将您的设备接入ESPHome附加组件：

   • 一旦ESPHome附加组件启动，您会看到您的设备为 已发现。
   • 选择 接入。
   • 当被提示时，输入您本地2.4 GHz Wi-Fi网络的网络凭证并选择 接入。

4. 如果您看到此设备可用更新的通知，选择 更新。

5. 确保您可以访问配置文件。

   • 如果您不确定使用什么方法，请 安装文件编辑器 附加组件。
   • 在文件编辑器配置中，确保禁用 强制基础路径 选项。

6. 编辑常规配置以启用调试模式：

   • 访问 config 文件夹并打开 configuration.yaml 文件。

   • 输入以下文本：

     assist_pipeline:
        debug_recording_dir: /share/assist_pipeline
     

7. 保存更改并重启Home Assistant。

8. 导航到 /share/assist_pipeline。

   • 对于您给出的每个语音命令，您将找到一个子文件夹，里面有以 .wav 格式存储的音频文件。

9. 收听感兴趣的音频文件。

10. 打开配置文件：

    • 在ESPHome附加组件中，选择您的设备，点击 编辑。
    • 这将允许您编辑该设备的配置文件。

11. 要添加一个调整噪声抑制和音量的部分，请添加以下行：

    voice_assistant:
       noise_suppression_level: 3
       auto_gain: 31dBFS
       volume_multiplier: 10.0
    

12. 调整设置：

    • 如果音频太吵，请增加 noise_suppression_level （最大为4）。
    • 如果音频太安静，请增加 auto_gain （最大为31）或 volume_multiplier （没有最大值，但过高的值最终会导致失真）。

13. 注意：收集调试录音会影响您的磁盘空间。

    • 一旦您找到有效的配置，删除包含音频文件的文件夹。
    • 在 configuration.yaml 文件中，删除 assist_pipeline 条目并重启Home Assistant。