diff --git a/source/_integrations/assist_pipeline.markdown b/source/_integrations/assist_pipeline.markdown index 61719835821..080fda04907 100644 --- a/source/_integrations/assist_pipeline.markdown +++ b/source/_integrations/assist_pipeline.markdown @@ -17,6 +17,12 @@ ha_platforms: The Assist pipeline integration provides the foundation for the [Assist](/docs/assist/) voice assistant in Home Assistant. -There is no need to manually install this integration. The Assist pipeline integration is part of the default configuration and set up automatically if needed by other integrations. +For most users, there is no need to install this integration manually. The Assist pipeline integration is part of the default configuration and is set up automatically if needed by other integrations. +If you are not using the default integration, you need to add the following to your `configuration.yaml` file: + +```yaml +# Example configuration.yaml entry +assist_pipeline: +``` For more information, refer to the procedure on [configuring a pipeline](/docs/assist/voice_remote_local_assistant/). diff --git a/source/docs/assist/troubleshooting.markdown b/source/docs/assist/troubleshooting.markdown index 01c2711a64c..fd7e65e42c1 100644 --- a/source/docs/assist/troubleshooting.markdown +++ b/source/docs/assist/troubleshooting.markdown @@ -28,3 +28,18 @@ This section lists a few steps that may help you troubleshoot issues with Assist * If the phrase does not work, try a variant. For example, if *Turn off the light* doesn't work, try: *Turn off the lights in the kitchen*. * Check if your phrase is [supported](/docs/assist/builtin_sentences/). * Make sure you are using the name of the area as it is defined in Home Assistant. If you have a room called *bathroom*, the phrase *Turning on the lights in the bath* won’t work. + + +## 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. + +![Open the pipeline debug dialog](/images/assist/assist-assistants-page.png) + +If the **Assist** section is missing entirely, you need to add the following to your `configuration.yaml` file: + + ```yaml + # Example configuration.yaml entry + assist_pipeline: + ``` + \ No newline at end of file diff --git a/source/docs/assist/voice_remote_local_assistant.markdown b/source/docs/assist/voice_remote_local_assistant.markdown index 8caf539b1aa..52a84101ba3 100644 --- a/source/docs/assist/voice_remote_local_assistant.markdown +++ b/source/docs/assist/voice_remote_local_assistant.markdown @@ -28,8 +28,16 @@ For the quickest way to get your local Assist pipeline started, follow these ste * **Piper** converts text into speech. * **Wyoming** is the protocol they are both using to communicate. 1. Setup your assistant. - * Go to **Settings** > **Voice assistants** and select **Add assistant**. + * Go to {% my voice_assistants title="**Settings** > **Voice assistants**" %} and select **Add assistant**. ![Enter a name for your voice assistant](/images/assist/piper-whisper-install-05.png) + + * **Troubleshooting**: If you do not see any assistants here, you are not using the default configuration. In this case, you need to add the following to your `configuration.yaml` file: + + ```yaml + # Example configuration.yaml entry + assist_pipeline: + ``` + * Enter a name. You can pick any name that is meaningful to you. * Select the language that you want to speak. * Under **Conversation agent**, select **Home Assistant**. diff --git a/source/images/assist/assist-assistants-page.png b/source/images/assist/assist-assistants-page.png new file mode 100644 index 00000000000..7847e17b48b Binary files /dev/null and b/source/images/assist/assist-assistants-page.png differ