Skip to content

Commit 15205f1

Browse files
authored
Assist troubleshooting: add sentence parser procedure (home-assistant#28314)
1 parent 1178288 commit 15205f1

File tree

3 files changed

+20
-4
lines changed

3 files changed

+20
-4
lines changed
70.7 KB
Loading
Loading

source/voice_control/troubleshooting.markdown

+20-4
Original file line numberDiff line numberDiff line change
@@ -14,16 +14,32 @@ This section lists a few steps that may help you troubleshoot issues with Assist
1414
4. At the top of the screen, from the dropdown menu, select the run you are interested in.
1515
![Debug speech-to-text](/images/assist/assistant-debug-02.png)
1616

17-
## Test if the phrase works without voice
17+
## Test a sentence per language without voice: without executing commands
18+
19+
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**.
20+
21+
1. Go to {% my developer_assist title="**Developer tools** > **Assist**" %}.
22+
2. In the sentence parser, select the language and enter the sentence you want to test.
23+
3. The debug tool shows you the following:
24+
- The intent triggered.
25+
- The entities that were targeted.
26+
- Which of the targeted entities were matched.
27+
![Open the Assist developer tool sentence parser](/images/assist/assistant-debug-06.png)
28+
29+
30+
## Test a sentence per assistant without voice: while executing the commands
31+
32+
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.
1833

1934
1. [Open the debug view](#view-debug-information).
2035
2. In the top right corner, select the icon.
2136
![Open the pipeline debug dialog](/images/assist/assistant-debug-04.png)
22-
3. Select **Run text pipeline**.
37+
3. Select the assistant you want to test.
38+
4. Select **Run text pipeline**.
2339
![Open the pipeline debug dialog](/images/assist/assistant-debug-pipeline-01.png)
24-
4. Enter the phrase you want to test and select **Run**.
40+
5. Enter the phrase you want to test and select **Run**.
2541
![Open the pipeline debug dialog](/images/assist/assistant-debug-pipeline-02.png)
26-
5. Check if it worked.
42+
6. Check if it worked.
2743
![Open the pipeline debug dialog](/images/assist/assistant-debug-pipeline-03.png)
2844
- 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*.
2945
- Check if your phrase is [supported](/voice_control/builtin_sentences/).

0 commit comments

Comments
 (0)