home-assistant.io/source/docs/assist/troubleshooting.markdown
c0ffeeca7 618f94ae5b
Assist: adding assist_pipeline to config file (#27329)
* Assist: adding assist_pipeline to config file

For users who do not use the default configuration

- add info on how to add assist_pipeline
- add troubleshooting item

* fix markdown list numbering

* Tiny tweak

---------

Co-authored-by: Franck Nijhof <git@frenck.dev>
2023-05-08 18:34:48 -05:00

2.0 KiB
Raw Permalink Blame History

title
Troubleshooting Assist

This section lists a few steps that may help you troubleshoot issues with Assist.

View debug information

  1. Go to Settings > Voice assistants.
  2. From the list of assistants, select your assistant. Select your assistant
  3. In the dialog, select Debug. Open the debug dialog
  4. At the top of the screen, from the dropdown menu, select the run you are interested in. Debug speech-to-text

Test if the phrase works without voice

  1. Open the debug view.
  2. In the top right corner, select the icon. Open the pipeline debug dialog
  3. Select Run text pipeline. Open the pipeline debug dialog
  4. Enter the phrase you want to test and select Run. Open the pipeline debug dialog
  5. Check if it worked. Open the pipeline debug dialog
    • 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.
    • 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.

I do not see any assistant

If under {% my voice_assistants title="Settings > Voice assistants" %} you do not see any assistants, you are not using the default configuration. The image below shows the Assist section.

Open the pipeline debug dialog

If the Assist section is missing entirely, you need to add the following to your configuration.yaml file:

# Example configuration.yaml entry
assist_pipeline: