Assist: add troubleshooting on weather queries (#30073)

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/)

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.
+