Voice control: add some troubleshooting steps (#27999)

* Voice control: add some troubleshooting steps

* Add speech-to-text troubleshooting steps
This commit is contained in:
c0ffeeca7 2023-06-28 21:58:30 +02:00 committed by GitHub
parent 8857c693b3
commit e411cb4747
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23

View File

@ -6,7 +6,7 @@ This section lists a few steps that may help you troubleshoot issues with Assist
## View debug information
1. Go to **Settings** > **Voice assistants**.
1. Go to {% my voice_assistants title="**Settings** > **Voice assistants**" %}.
1. From the list of assistants, select your assistant.
![Select your assistant](/images/assist/assistant-select.png)
1. In the dialog, select **Debug**.
@ -25,9 +25,29 @@ This section lists a few steps that may help you troubleshoot issues with Assist
![Open the pipeline debug dialog](/images/assist/assistant-debug-pipeline-02.png)
1. Check if it worked.
![Open the pipeline debug dialog](/images/assist/assistant-debug-pipeline-03.png)
* If the phrase does not work, try a variant. For example, if *Turn off the light* doesn't work, try: *Turn off the lights in the kitchen*.
* Check if your phrase is [supported](/voice_control/builtin_sentences/).
* Make sure you are using the name of the area as it is defined in Home Assistant. If you have a room called *bathroom*, the phrase *Turning on the lights in the bath* wont work.
## If the phrase did not work, even without voice
1. Try a variant. For example, if *Turn off the light* doesn't work, try: *Turn off the lights in the kitchen*.
1. Check if the phrase is [supported](/voice_control/builtin_sentences/).
1. Check if the devices are exposed to Assist.
* Under {% my voice_assistants title="**Settings** > **Voice assistants**" %}, open the **Expose** tab.
* If you do not see the device in the list, select **Expose entities** and add the device.
1. If the phrase includes an area, make sure the device is added to that area.
* Under **{% my integrations title="Settings > Devices & Services" %}**, on the integration, select devices.
* From the list of devices, select the device of interest.
* In the top right corner, select the pencil item.
* Add the device to that area.
1. Make sure you are using the name of the area exactly as it is defined in Home Assistant.
## If the phrase worked with Assist, but not with voice
1. [Open the debug view](#view-debug-information).
1. If you see that speech-to-text failed:
- Go back to your voice assistant.
- Under **Speech-to-text**, check if there are multiple variants supported for your language.
- Try out different language variants. It could be that recognition works better with one of the variants.
## I do not see any assistant