mirror of
https://github.com/home-assistant/home-assistant.io.git
synced 2025-06-25 03:26:50 +00:00
54a1dd2d5a
* Draft * simplest way to get started * Re working local * Small line break * typo * removing "Questions" section that makes not a lot of sense. * tiny rephrase * markdown * use heading instead of bold * Update source/voice_control/voice_remote_local_assistant.markdown * Update source/voice_control/index.markdown Co-authored-by: Paulus Schoutsen <balloob@gmail.com> * Remove one sentence * Update source/voice_control/voice_remote_local_assistant.markdown Co-authored-by: c0ffeeca7 <38767475+c0ffeeca7@users.noreply.github.com> * Update source/voice_control/index.markdown Co-authored-by: Paulus Schoutsen <balloob@gmail.com> * Remove wizard picture * Update source/voice_control/voice_remote_local_assistant.markdown --------- Co-authored-by: c0ffeeca7 <38767475+c0ffeeca7@users.noreply.github.com> Co-authored-by: Paulus Schoutsen <balloob@gmail.com>
189 lines
7.2 KiB
Markdown
189 lines
7.2 KiB
Markdown
---
|
|
title: Talking to Assist - Sentences starter pack
|
|
related:
|
|
- docs: /voice_control/aliases/
|
|
title: Create aliases
|
|
- docs: /voice_control/custom_sentences/
|
|
title: Create your own sentences
|
|
- docs: /voice_control/troubleshooting/
|
|
title: Sentence troubleshooting
|
|
- url: https://github.com/home-assistant/intents/tree/main/sentences
|
|
title: Built-in sentence definitions
|
|
- url: https://github.com/home-assistant/intents/tree/main/responses
|
|
title: Built-in response definitions
|
|
- url: https://developers.home-assistant.io/docs/voice/intent-recognition/template-sentence-syntax/
|
|
title: Template sentence syntax documentation
|
|
- url: https://github.com/home-assistant/intents/tree/main/sentences
|
|
title: Sentence test cases
|
|
- docs: /voice_control/best_practices/
|
|
title: Best practices with Assist
|
|
---
|
|
|
|
Home Assistant comes with [built-in sentences](https://github.com/home-assistant/intents/tree/main/sentences) contributed by the community for [dozens of languages](https://developers.home-assistant.io/docs/voice/intent-recognition/supported-languages).
|
|
|
|
## Prerequisites
|
|
|
|
- The entities you want to control with Assist must be [exposed to Assist](/voice_control/voice_remote_expose_devices/).
|
|
- When using the names of entities or areas, make sure to use them exactly as they are defined in Home Assistant, or, [create an alias](/voice_control/aliases/).
|
|
|
|
## Device control
|
|
|
|
### Turning entities on and off
|
|
|
|
- *turn on the living room light*
|
|
- *turn off ceiling fan*
|
|
- *turn on the TV*
|
|
- *lock all the doors*
|
|
- *open the main door*
|
|
|
|
### Lights
|
|
|
|
- *Change kitchen lights brightness to 50%*
|
|
- *Set bed light to green*
|
|
- *set bed light brightness to 50%*
|
|
- *set living room brightness to 50%*
|
|
- *set brightness to 50%*
|
|
- Uses area of voice satellite
|
|
- *set kitchen lights to red*
|
|
- *set lights to red*
|
|
- Uses area of voice satellite
|
|
- *turn on the lights in the living room*
|
|
|
|
### Covers
|
|
|
|
- *Close the garage door*
|
|
- *Open kitchen window*
|
|
- *Which curtains are closed*
|
|
- *Set bedroom curtain to 50%*
|
|
|
|
### Scenes and scripts
|
|
|
|
- *Run stealth mode script*
|
|
- *Activate dinner scene*
|
|
- *Turn kitchen dinner scene on*
|
|
|
|
### Media player
|
|
|
|
- *next item on TV*
|
|
- *next track*
|
|
- *next track in office*
|
|
- *previous track*
|
|
- *previous track in office*
|
|
- *skip song on the TV*
|
|
- *skip track on the TV*
|
|
- *skip to the next song on the TV*
|
|
- *pause|resume*
|
|
- pauses or resumes music on voice satellite or in current area
|
|
- *pause|resume "area" music*
|
|
- pauses or resumes music in area
|
|
- *pause|resume "entity"*
|
|
- pauses or resumes music on media player
|
|
- *unpause TV*
|
|
- *TV unpause*
|
|
- *set TV volume to 90 percent*
|
|
- *change the TV volume to 90*
|
|
- *turn TV volume down to 90 percent*
|
|
|
|
### Vacuum
|
|
|
|
- *return rover to base*
|
|
- *start rover*
|
|
|
|
### Lists
|
|
|
|
- *Add bread to my shopping list*
|
|
- *Add decorating christmas tree to my december chores list*
|
|
- needs a todo list name "december chores"
|
|
- *add clean out garage to weekend list*
|
|
- needs a todo list named "Weekend"
|
|
|
|
## Date and time
|
|
|
|
- *what time is it?*
|
|
- *what's the date?*
|
|
|
|
## Timers
|
|
|
|
### Starting
|
|
|
|
- *set a timer for 5 minutes*
|
|
- *5 minute timer*
|
|
- *set a 20 minute timer for pizza*
|
|
- *set a timer for 1 hour and 3 minutes*
|
|
- Break it up into hours, minutes, and seconds instead of using a technical term like *set a timer for 63 minutes*.
|
|
|
|
### Cancelling
|
|
|
|
- *cancel timer*
|
|
- can't cancel multiple timers yet
|
|
- *cancel 5 minute timer*
|
|
- *cancel pizza timer*
|
|
- *cancel kitchen timer*
|
|
- Must have been set by a voice satellite in the kitchen
|
|
|
|
### Adding/Removing Time
|
|
|
|
- *add 5 minutes to pizza timer*
|
|
- *add 5 minutes to kitchen timer*
|
|
- *remove 1 minute from timer*
|
|
- *remove 1 minute from 5 minute timer*
|
|
|
|
### Status
|
|
|
|
- *timer status*
|
|
- *how much time is left on pizza timer?*
|
|
- *how much time is left on kitchen timer?*
|
|
- *how much time is left on 5 minute timer?*
|
|
|
|
<p class='img'><lite-youtube videoid="v3mNdTsX4J0" videotitle="Voice timers with countdown text and loading bar"></lite-youtube>Timers running on an S3-Box-3B, with countdown text and a loading bar!</p>
|
|
|
|
To learn how to set this up, refer to the [ESP32-S3-Box-3B tutorial](/voice_control/s3_box_voice_assistant/).
|
|
|
|
### Combining timers and device control to add a delay
|
|
|
|
Unlike regular voice timers, delayed commands cannot be canceled or modified.
|
|
|
|
- *Turn off the lights in the living room in 5 minutes*
|
|
- *Pause TV in 10 minutes*
|
|
- *Open the blinds in 5 minutes*
|
|
|
|
## Aborting
|
|
|
|
- *Nevermind*: If you triggered the wake word by mistake and want to stop Home Assistant from listening
|
|
|
|
## Troubleshooting
|
|
|
|
The list of supported sentences is constantly being updated for each language. There are so many possible sentences that they cannot be all listed here. To find out what works in your language, follow these steps.
|
|
|
|
1. If the voice assistant doesn't understand you, you may need to rephrase your sentence a bit. Or check if the {% term entity %} or {% term area %} name is correct for your environment.
|
|
2. Take a look at the test sentences:
|
|
- On GitHub, in the [tests](https://github.com/home-assistant/intents/tree/main/tests) folder, open the subfolder for your language.
|
|
- Look through the test files to see the example sentences that have been tested.
|
|
- The second part of the file name shows the {% term intent %}, the first part shows the {% term domain %}. For some {% term domains %}, such as covers, fans, and light, there are specific sentences.
|
|
The other {% term domains %} are covered by the generic *homeassistant_*.
|
|
|
|
|
|
|
|
- The screenshot below shows sentences used to test the command to turn on the lights. Note that *Living room* here is just a place holder.
|
|
It could be any {% term area %} that you have in your home.
|
|
|
|
|
|
|
|
3. View the sentence definition for the tests:
|
|
- On GitHub, in the [sentences](https://github.com/home-assistant/intents/tree/main/sentences) folder, open the subfolder for your language.
|
|
- Open the file of interest.
|
|
|
|
|
|
|
|
- () mean alternative elements.
|
|
- [] mean optional elements.
|
|
- <> mean an expansion rule. To view these rules, search for `expansion_rules` in the [_common.yaml](https://github.com/home-assistant/intents/blob/main/sentences/en/_common.yaml) file.
|
|
- The syntax is explained in detail in the [template sentence syntax documentation](https://developers.home-assistant.io/docs/voice/intent-recognition/template-sentence-syntax/).
|
|
4. View the [sentence definition](https://github.com/home-assistant/intents/tree/main/sentences) for your language.
|
|
5. View the [response definition](https://github.com/home-assistant/intents/tree/main/responses)
|
|
6. If there are issues when asking for the weather forecast, check the [troubleshooting section](/voice_control/troubleshooting/) to see common errors.
|
|
|
|
## More sentences
|
|
|
|
You can extend the [built-in sentences](https://github.com/home-assistant/intents/tree/main/sentences) or [add your own](/voice_control/custom_sentences) to trigger any action in Home Assistant.
|