diff --git a/source/_data/glossary.yml b/source/_data/glossary.yml index f492dab06ed..15436a4a85a 100644 --- a/source/_data/glossary.yml +++ b/source/_data/glossary.yml @@ -126,6 +126,8 @@ excerpt: > Each integration in Home Assistant has a unique identifier: The domain. It is often shown as the first part (before the dot) of entity IDs. + aliases: + - domains - term: Entity definition: |- An 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. Entities have states. @@ -159,6 +161,8 @@ definition: >- Groups are a way to organize your entities into a single unit. link: /integrations/group/ + aliases: + - groups - term: HASS definition: >- HASS or [hass](/docs/tools/hass/) is often used as an abbreviation for @@ -255,10 +259,14 @@ definition: >- You can use notifications to send messages, pictures, and more, to devices. link: /integrations/#notifications -- term: Packages + aliases: + - notifications +- term: Package definition: > Packages allow you to bundle different component configurations together. link: /docs/configuration/packages/ + aliases: + - packages - term: Platform definition: >- Platforms are building blocks provided by some integrations to be used by @@ -270,6 +278,8 @@ Platforms are building blocks provided by some integrations to be used by other integrations. link: /docs/configuration/platform_options/ + aliases: + - platforms - term: Reload definition: >- Applies the changes made to the Home Assistant configuration files. Changes @@ -306,7 +316,7 @@ link: /integrations/sensor/ aliases: - sensors -- term: Selectors +- term: Selector definition: >- Selectors are components for the user interface. Some selectors can, for example, show a toggle button to turn something on or off, while another @@ -316,6 +326,8 @@ Selectors are components for the user interface. Like toggle, dropdown, and more. link: /docs/blueprint/selectors/ + aliases: + - selectors - term: Service definition: |- The term service has 2 meanings in Home Assistant: diff --git a/source/voice_control/builtin_sentences.markdown b/source/voice_control/builtin_sentences.markdown index 671d05661c2..bf004fbb207 100644 --- a/source/voice_control/builtin_sentences.markdown +++ b/source/voice_control/builtin_sentences.markdown @@ -9,18 +9,43 @@ These sentences allow you, for example, to: - **Turn 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"* - **Open and close covers** - *"Close the garage door"* - *"Open kitchen window"* - **Set the brightness and color of lights** - *"Change kitchen lights brightness to 50%"* - *"Set bed light to green"* - -In addition to individual entities, commands can target **areas**: +- **Ask about the weather** + - *"What is the weather like in Boston"* +- **Add items to a list** + - *"Add bread to my shopping list"* + - *"Add decorating christmas tree to my december chores list"* +- **Get information about a state** + - *"What is the amount of energy from solar production?"* + - *"what is the heat pump co2 sensor's co2 level?"* + - *"what is the battery level of my phone?"* +- **Run a script** + - *"Run stealth mode script"* +- **Activate a scene** + - *"Activate dinner scence"* + - *"Turn kitchen dinner scene on"* +- **Inquire about people (that have device tracking activated in Home Assistant)** + - *"How many people are in the kitchen"* + - *"Who is in the garage"* + - *"Where is Anne"* +- **Abort wake word** + - *"Nevermind"*: If you triggered the wake word by mistake and want to stop Home Assistant from listening + +The sentences only work, if the {% term entities %} are available and are named exactly the way you call them. + +In addition to individual {% term entities %}, commands can target **areas**: - *"turn on all lights in the living room"* - *"open windows in the kitchen"* -- *"change kitchen brightness to 50%"* +- *"change office brightness to 50%"* - *"set bedroom lights to green"* Entity [aliases](/voice_control/aliases) are also matched so that multiple names can be used, even in different languages. @@ -29,21 +54,20 @@ You can extend the [built-in sentences](https://github.com/home-assistant/intent ## View existing sentences -Broadly speaking, you can use your voice to turn things on or off, inquire about a state, or change the brightness or color of a light. +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. -If the voice assistant doesn't understand you, you may need to rephrase your sentence a bit. -To get an idea of the specific sentences that are supported for your language, you can do the following: +**Note**: 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. 1. Take a look at the test sentences: - On GitHub, in the [tests](https://github.com/home-assistant/intents/tree/main/sentences) 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 domain. For some domains, such as covers, fans, and light, there are specific sentences. - The other domains are covered by the generic *homeassistant_*. + - 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_*. ![Example of a folder of assistant sentence test files](/images/assist/intents-test-files.png) - 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 area that you have in your home. + It could be any {% term area %} that you have in your home. ![Example of a set of test sentences](/images/assist/assist-test-file-light-turn-on.png)