Talking to Assist - Sentences starter pack
Home Assistant comes with built-in sentences contributed by the community for dozens of languages.
Prerequisites
- The entities you want to control with Assist must be exposed to Assist.
- 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.
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
Fans
- set kitchen fan speed to 50%
- kitchen fans 50%
Climate
- what is the temperature in the living room?
- set bedroom temp to 21 degrees
- set the fan mode to auto
- set the bedroom fan mode to low
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
- Mute my TV
- Unmute the television
- volume up
- turn up the volume in the living room
To play media by name, use a media player that can search for the type of media you want to play. Music Assistant, Sonos, and Jellyfin support media search for different types of media.
- play the track Bohemian Rhapsody
- play the song Bohemian Rhapsody in the kitchen
Vacuum
- return rover to base
- start rover
To send a vacuum to clean an area, the vacuum must support cleaning areas, and its areas must be mapped to Home Assistant areas. For the steps, refer to Mapping your vacuum areas to Home Assistant areas.
- clean the living room
-
vacuum in here
- Uses area of voice satellite
- clean living room with rover
Lawn mower
- start mowing
-
start clippy
- Starts the lawn mower named “Clippy”
- dock the mower
-
stop mowing
- Sends the lawn mower back to its dock
Lists
- Add bread to my shopping list
- check off bread from 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”
- complete clean out garage on my weekend list
- delete clean out garage in my weekend list
Weather
- what’s the weather?
-
what’s the weather like in London?
- Needs a weather entity named “London”
Date and time
- what time is it?
- what’s the date?
Broadcasting
-
broadcast that dinner is ready
- Plays the message on all other voice satellites that can play announcements. For example, Home Assistant Voice Preview Edition can. Analog phones that you connect through Voice over IP don’t get the message.
Timers
Timers created with Assist are voice timers. They are separate from Timer helper entities and do not create timer.* entities that you can use in dashboards, scripts, or automations.
A voice timer belongs to the voice satelliteA standalone device with a microphone that you use to talk to Assist. Some voice satellites also have a speaker to play Assist’s replies. Unlike a browser or the Home Assistant Companion app, a voice satellite isn’t signed in to a user account. This means Home Assistant can’t tell who is speaking. Each voice satellite uses at least one assistant. where you start it. The voice satellite must support timers. For example, Home Assistant Voice Preview Edition supports them. The Assist dialog in Home Assistant doesn’t. If you start a timer where timers aren’t supported, Assist responds that the device doesn’t support 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
- If several timers are running, Assist first looks for a timer of the voice satellite that you talk to. Then it looks in the area of the voice satellite, and then on its floor. If it still finds more than one timer, name the timer, or cancel all timers.
- cancel 5 minute timer
- cancel pizza timer
-
cancel kitchen timer
- Must have been set by a voice satellite in the kitchen
-
cancel all timers
- Cancels the voice timers of all voice satellites
- cancel all kitchen timers
Pausing and resuming
- pause timer
- resume timer
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?
To learn how to set this up, refer to the ESP32-S3-Box-3B tutorial.
Combining timers and device control to add a delay
Unlike regular voice timers, delayed commands can’t be canceled, paused, or changed. They also work where voice timers aren’t supported. For example, they work in the Assist dialog in Home Assistant.
- 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
Assist answers “Sorry, I couldn’t understand that”
Symptom
Assist answers “Sorry, I couldn’t understand that”.
Description
The Home Assistant conversation agentSoftware that Home Assistant uses to understand a request and decide what to do. Home Assistant has a built-in conversation agent. Integrations can add others, including ones that use AI. Conversation agents that use AI can also use AI tools. Each assistant uses a conversation agent. [Learn more] only understands sentences that match one of its built-in sentences for your language, or one of your own sentences. A small change in the wording can stop a sentence from matching. The community adds new sentences all the time, and there are too many to list them all on this page.
Resolution
To find a sentence that works in your language, follow these steps.
- Test the sentence:
- Go to Settings > Tools > Assist.
- Select your language, enter the sentence, and select Parse sentences.
- If the result shows No intent matched, Assist doesn’t understand this sentence. For more on the sentence parser, refer to Test a sentence per language without voice.
- Look at the tested sentences for your language.
- On GitHub, open the tests folder, and then the folder of your language. For example,
enfor English. - Each folder in it is named after an intentIntent is a term used with voice assistants. The intent is what Home Assistant thinks you want it to do when it extracts a command from your voice or text utterance. [Learn more]. For example,
HassTurnOnturns things on, andHassLightSetchanges the brightness or color of lights. - Open a file in the folder of the intent. Each file tests one kind of sentence. For example,
area_domain.yamltests sentences with an area and a kind of entity, like turn on the lights in the kitchen. - The area and entity names in the test files are only examples. Use the names from your home instead.
- On GitHub, open the tests folder, and then the folder of your language. For example,
- To see all the sentences that Assist understands for an intent, open the same intent folder in the sentences folder of your language.
-
For example,
HassTurnOn/area_domain.yamlcontains these sentences, among others:- "<turn> on [<all>] [<the>] {area} <light>" - "(light up|illuminate) [<the>] {area}" -
() mean alternative elements.
-
[] mean optional elements.
-
{} mean a list, like the names of your areas.
-
<> mean an expansion rule. For these English examples, refer to the English expansion rules.
-
The syntax is explained in detail in the template sentence syntax documentation.
-
- Rephrase your sentence to match one of these sentences, and test it again, as in step 1.
- Result: The sentence parser shows the intent and the entities that your sentence targets.
- If none of the built-in sentences fits, add your own sentence. For the steps, refer to Create your own sentences.
Assist answers “Sorry, I am not aware of any device called …”
Symptom
Assist answers “Sorry, I am not aware of any device called …”, with the name that you used. For an area, it answers “Sorry, I am not aware of any area called …”.
Description
Assist understood the sentence, but no entityAn entity represents a sensor, actor, or function in Home Assistant. Entities are used to monitor physical properties or to control other entities. An entity is usually part of a device or a service. [Learn more] or areaAn area in Home Assistant is a logical grouping of devices and entities that represents a room or space in your home, such as the living room, kitchen, or garage. [Learn more] in Home Assistant has the name that you used.
Resolution
- Use the name of the entity or area exactly as it’s defined in Home Assistant.
- If you call it by another name, add that name as an alias. For the steps, refer to Create aliases.
- Say the sentence again.
- Result: Assist does what you asked.
Assist answers “Sorry, … is not exposed”
Symptom
Assist answers “Sorry, … is not exposed”, with the name of the entity.
Description
Assist found the entityAn entity represents a sensor, actor, or function in Home Assistant. Entities are used to monitor physical properties or to control other entities. An entity is usually part of a device or a service. [Learn more], but the entity isn’t exposed to Assist. Assist can only control entities that you expose to it.
Resolution
- Expose the entity to Assist. For the steps, refer to Exposing entities to voice assistants.
- Say the sentence again.
- Result: Assist does what you asked.
More sentences
You can extend the built-in sentences or add your own to trigger any action in Home Assistant.