mirror of
https://github.com/home-assistant/home-assistant.io.git
synced 2025-05-28 13:57:04 +00:00
60 lines
2.9 KiB
Markdown
60 lines
2.9 KiB
Markdown
---
|
||
title: "Troubleshooting Assist"
|
||
---
|
||
|
||
This section lists a few steps that may help you troubleshoot issues with Assist.
|
||
|
||
## View debug information
|
||
|
||
1. Go to {% my voice_assistants title="**Settings** > **Voice assistants**" %}.
|
||
2. From the list of assistants, select your assistant.
|
||
|
||
3. In the dialog, select **Debug**.
|
||
|
||
4. At the top of the screen, from the dropdown menu, select the run you are interested in.
|
||
|
||
|
||
## Test a sentence per language without voice: without executing commands
|
||
|
||
If you want to test if a sentence works in a specific language without actually executing the commands, use the sentence parser in the **Developer tools**.
|
||
|
||
1. Go to {% my developer_assist title="**Developer tools** > **Assist**" %}.
|
||
2. In the sentence parser, select the language and enter the sentence you want to test.
|
||
3. The debug tool shows you the following:
|
||
- The intent triggered.
|
||
- The entities that were targeted.
|
||
- Which of the targeted entities were matched.
|
||
|
||
|
||
|
||
## Test a sentence per assistant without voice: while executing the commands
|
||
|
||
If you want to test if a sentence works with a specific assistant while actively executing the commands, use the sentence parser in the **Debug** view.
|
||
|
||
1. [Open the debug view](#view-debug-information).
|
||
2. In the top right corner, select the icon.
|
||
|
||
3. Select the assistant you want to test.
|
||
4. Select **Run text pipeline**.
|
||
|
||
5. Enter the phrase you want to test and select **Run**.
|
||
|
||
6. Check if it worked.
|
||
|
||
- 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* won’t 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.
|
||
|
||
|
||
|
||
If the **Assist** section is missing entirely, you need to add the following to your `configuration.yaml` file:
|
||
|
||
```yaml
|
||
# Example configuration.yaml entry
|
||
assist_pipeline:
|
||
```
|