diff --git a/source/images/assist/expose_entity_dialog.png b/source/images/assist/expose_entity_dialog.png new file mode 100644 index 00000000000..67a11cfc3c6 Binary files /dev/null and b/source/images/assist/expose_entity_dialog.png differ diff --git a/source/images/assist/metno_weather_entity.png b/source/images/assist/metno_weather_entity.png new file mode 100644 index 00000000000..a548e5ac78c Binary files /dev/null and b/source/images/assist/metno_weather_entity.png differ diff --git a/source/images/assist/weather_entity_voice_assistant.png b/source/images/assist/weather_entity_voice_assistant.png new file mode 100644 index 00000000000..9e5f3a7dba4 Binary files /dev/null and b/source/images/assist/weather_entity_voice_assistant.png differ diff --git a/source/voice_control/builtin_sentences.markdown b/source/voice_control/builtin_sentences.markdown index bf004fbb207..5472f89fbe3 100644 --- a/source/voice_control/builtin_sentences.markdown +++ b/source/voice_control/builtin_sentences.markdown @@ -19,7 +19,8 @@ These sentences allow you, for example, to: - *"Change kitchen lights brightness to 50%"* - *"Set bed light to green"* - **Ask about the weather** - - *"What is the weather like in Boston"* + - *"What is the weather"* + - Struggling with this one? Check the [troubleshooting section](/voice_control/troubleshooting/). - **Add items to a list** - *"Add bread to my shopping list"* - *"Add decorating christmas tree to my december chores list"* @@ -39,7 +40,7 @@ These sentences allow you, for example, to: - **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. +The sentences only work, if the {% term entities %} are available and are named exactly the way you call them. Check the [troubleshooting section](/voice_control/troubleshooting/) to see common errors when asking for the weather forecast. In addition to individual {% term entities %}, commands can target **areas**: @@ -92,3 +93,4 @@ The list of supported sentences is constantly being updated for each language. T - [Built-in response definitions](https://github.com/home-assistant/intents/tree/main/responses) - [Template sentence syntax documentation](https://developers.home-assistant.io/docs/voice/intent-recognition/template-sentence-syntax/) - [Sentence test cases](https://github.com/home-assistant/intents/tree/main/sentences) +- [Sentence troubleshooting](/voice_control/troubleshooting/) diff --git a/source/voice_control/troubleshooting.markdown b/source/voice_control/troubleshooting.markdown index f0743d7c2d3..e1a15ec7e31 100644 --- a/source/voice_control/troubleshooting.markdown +++ b/source/voice_control/troubleshooting.markdown @@ -47,7 +47,7 @@ If you want to test if a sentence works with a specific assistant while actively ## 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 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. ![Open the pipeline debug dialog](/images/assist/assist-assistants-page.png) @@ -57,3 +57,30 @@ If the **Assist** section is missing entirely, you need to add the following to # Example configuration.yaml entry assist_pipeline: ``` + +## Assist does not understand my question about the weather forecast + +The example below shows common pitfalls when enquiring about the weather. While some steps are specific to the weather, the general mechanics apply to other entities as well. + +1. Make sure you have a [weather service](/integrations/#weather) installed. + - By default, [Met.no](/integrations/met/) is installed. +2. Make sure you have an entity set up for the location you are interested in. + - For example, if you are interested in the weather in Berlin, add an entity for Berlin. + + ![Create weather entity](/images/assist/metno_weather_entity.png) +3. Make sure the entity is exposed to Assist: + - Under {% my entities title="**Settings** > **Devices & services** > **Entities**" %}, select the weather entity for that location. + - In the details view that opens, select the cogwheel, then select **Voice Assistant**. + + ![Select voice assistants](/images/assist/weather_entity_voice_assistant.png) + + - Make sure the entity is exposed to Assist. + + ![Expose entity to Assist](/images/assist/expose_entity_dialog.png) + +4. Make sure you use the exact entity name when talking to Assist. + - To view the entity name, check the list under {% my entities title="**Settings** > **Devices & services** > **Entities**" %}. + - For example, if the entity is called *Forecast Berlin*, you have to say "What is the weather in forecast Berlin like". + - Assist would not recognize it if you ask "What is the weather in Berlin like". +5. If you just ask "What is the weather" when you have weather forecast entities for multiple entities, Assist returns the weather data for the one with the oldest timestamp. +