From 0f1d7c9c98e7f946c3675a648c8038eacb9b2224 Mon Sep 17 00:00:00 2001
From: c0ffeeca7 <38767475+c0ffeeca7@users.noreply.github.com>
Date: Fri, 27 Oct 2023 18:17:23 +0200
Subject: [PATCH] Add procedure on configuring a cloud voice assistant (#29557)

* Add procedure on configuring a cloud voice assistant

- make procedure on installing the openWakeWord add-on
  - a standalone procedure
- reference this procedure in related procedures

* Add missing link

* Apply suggestions from code review

Co-authored-by: Michael Hansen <hansen.mike@gmail.com>

---------

Co-authored-by: Michael Hansen <hansen.mike@gmail.com>
---
 source/_includes/asides/voice_navigation.html |   2 +
 source/images/assist/assistants_ha_cloud.png  | Bin 0 -> 23426 bytes
 .../install_wake_word_add_on.markdown         |  24 +++++++++
 .../thirteen-usd-voice-remote.markdown        |  27 ++++------
 .../voice_remote_cloud_assistant.markdown     |  51 ++++++++++++++++++
 5 files changed, 86 insertions(+), 18 deletions(-)
 create mode 100644 source/images/assist/assistants_ha_cloud.png
 create mode 100644 source/voice_control/install_wake_word_add_on.markdown
 create mode 100644 source/voice_control/voice_remote_cloud_assistant.markdown

diff --git a/source/_includes/asides/voice_navigation.html b/source/_includes/asides/voice_navigation.html
index 9637726c1fe..f6443a7d7b9 100644
--- a/source/_includes/asides/voice_navigation.html
+++ b/source/_includes/asides/voice_navigation.html
@@ -14,7 +14,9 @@
     <ul class="divided sidebar-menu">
       <li>{% active_link /voice_control/using_voice_assistants_overview/ Voice assistants: Overview %}</li>
       <li>{% active_link /voice_control/voice_remote_local_assistant/ Configuring a local assistant %}</li>
+      <li>{% active_link /voice_control/voice_remote_cloud_assistant/ Configuring a cloud assistant %}</li>
       <li>{% active_link /voice_control/voice_remote_expose_devices/ Exposing devices to voice assistant %}</li>
+      <li>{% active_link /voice_control/install_wake_word_add_on/ Installing the openWakeWord add-on %}</li>
       <li>{% active_link /voice_control/builtin_sentences/ Built-in sentences %}</li>
       <li>{% active_link /voice_control/custom_sentences/ Custom sentences %}</li>
       <li>{% active_link /voice_control/using_tts_in_automation/ Using Piper TTS in automations %}</li>
diff --git a/source/images/assist/assistants_ha_cloud.png b/source/images/assist/assistants_ha_cloud.png
new file mode 100644
index 0000000000000000000000000000000000000000..79e0c43089a1f91f4c8e438f2c8c78c417cb6f1b
GIT binary patch
literal 23426
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

literal 0
HcmV?d00001

diff --git a/source/voice_control/install_wake_word_add_on.markdown b/source/voice_control/install_wake_word_add_on.markdown
new file mode 100644
index 00000000000..88705f18654
--- /dev/null
+++ b/source/voice_control/install_wake_word_add_on.markdown
@@ -0,0 +1,24 @@
+---
+title: "Installing the openWakeWord add-on"
+---
+
+To use wake words, you need to install the openWakeWord add-on.
+
+## Prerequisites
+
+- Home Assistant version 2023.10 or later, installed with the Home Assistant Operating System
+
+## Installing the openWakeWord add-on
+
+1. Go to {% my supervisor_addon addon="core_openwakeword" title="**Settings** > **Add-ons** > **openWakeWord**" %} and select **Install**.
+2. Start the add-on.
+3. Go to {% my integrations title="**Settings** > **Devices & Services**" %}.
+   - Under **Discovered**, you should now see the **Wyoming** integration.
+   - Select **Configure** and **Submit**.
+   - **Result**: You have successfully installed the openWakeWord add-on and Wyoming integration.
+4. Under {% my voice_assistants title="**Settings** > **Voice assistants**" %}, when you select a voice assistant, in the **Wake word** section, you should now see the wake word options that are available out of the box.
+5. If you do not like the available options, you can [create your own wake word](/voice_control/create_wake_word/).
+
+## Related topics
+
+- [Create your own wake words](/voice_control/create_wake_word/)
diff --git a/source/voice_control/thirteen-usd-voice-remote.markdown b/source/voice_control/thirteen-usd-voice-remote.markdown
index b7776565a70..06c47294f24 100644
--- a/source/voice_control/thirteen-usd-voice-remote.markdown
+++ b/source/voice_control/thirteen-usd-voice-remote.markdown
@@ -18,32 +18,23 @@ your smart home. Issue commands and get responses!
 - [M5Stack ATOM Echo Development Kit](https://shop.m5stack.com/products/atom-echo-smart-speaker-dev-kit?ref=NabuCasa)
 - USB-C cable to connect the ATOM Echo
 
-## Installing the openWakeWord add-on
-
-As a first step, you need to install the openWakeWord add-on. This must be installed before setting up the ATOM Echo.
-
-1. Go to {% my supervisor_addon addon="core_openwakeword" title="**Settings** > **Add-ons** > **openWakeWord**" %} and select **Install**.
-2. Start the add-on.
-3. Go to {% my integrations title="**Settings** > **Devices & Services**" %}.
-   - Under **Discovered**, you should now see the **Wyoming** integration.
-   - Select **Configure** and **Submit**.
-   - **Result**: You have successfully installed the openWakeWord add-on and Wyoming integration.
-
 ## Adding a wake word to your voice assistant
 
-1. Go to {% my voice_assistants title="**Settings** > **Voice assistants**" %} and select **Add assistant**.
-2. Give your assistant a name, for example the wake word you are going to use.
-3. Select the language you are going to use to speak to Home Assistant.
+1. Install the openWakeWord add-on:
+   - Follow steps 1-3 of the procedure on [installing the openWakeWord add-on](/voice_control/install_wake_word_add_on). 
+2. Go to {% my voice_assistants title="**Settings** > **Voice assistants**" %} and select **Add assistant**.
+3. Give your assistant a name, for example the wake word you are going to use.
+4. Select the language you are going to use to speak to Home Assistant.
    - If the **Text-to-speech** and **Speech-to-text** sections do not provide language selectors, this means you do not have an Assist pipeline set up.
    - Set up [Home Assistant Cloud](https://www.nabucasa.com) or a manually configured [Assist pipeline](/voice_control/voice_remote_local_assistant).
-4. Under **Text-to-speech**, select the language and voice you want Home Assistant to use when speaking to you.
-5. To define the wake word engine, under **Wake word**, select **openwakeword**.
+5. Under **Text-to-speech**, select the language and voice you want Home Assistant to use when speaking to you.
+6. To define the wake word engine, under **Wake word**, select **openWakeWord**.
    - Then, select **ok nabu**.
    - If you created a new assistant, select **Create**.
    - If you edited an existing assistant, select **Update**.
    - **Result**: You now have a voice assistant that listens to a wake word.
-6. For the first run, it is recommended to use **ok nabu**, just to test the setup.
-   - Once you have it all set up, you can [create your own wake words](/voice_control/create_wake_word/). 
+7. For the first run, it is recommended to use **ok nabu**, just to test the setup.
+   - Once you have it all set up, you can [create your own wake words](/voice_control/create_wake_word/).
 
 ## Installing the software onto the ATOM Echo
 
diff --git a/source/voice_control/voice_remote_cloud_assistant.markdown b/source/voice_control/voice_remote_cloud_assistant.markdown
new file mode 100644
index 00000000000..5b0aa60a761
--- /dev/null
+++ b/source/voice_control/voice_remote_cloud_assistant.markdown
@@ -0,0 +1,51 @@
+---
+title: "Creating a cloud Assist pipeline"
+---
+
+In Home Assistant, the Assist pipelines are made up of various components that together form a voice assistant.
+
+You can use Assist out of the box by typing into its text field. But the main goal is to use a voice command. A speech-to-text engine is used so that you can speak to the assistant. For Assist to be able to talk to you, you need to set up a text-to-speech engine. You can use these engines fully locally on your own hardware. To learn how, [follow this procedure](/voice_control/create_wake_word/).
+
+If you have Home Assistant Cloud, there is a default assistant set up automatically. The advantage of using Home Assistant Cloud is that there is more powerful hardware at play. This makes for faster processing and an overall more smooth experience. This procedure shows how to tweak the settings of the assistant that is set up with Home Assistant Cloud.
+
+## Prerequisites
+
+- In this procedure, Home Assistant Cloud will be used
+- Home Assistant Cloud is a paid subscription. It helps run servers and pay for things like development and security audits. If you just want to try this for the fun of it, you can start a free 1 month trial and then cancel.
+
+## Setting up a cloud Assist pipeline
+
+To have the fastest processing voice assistant experience, follow these steps:
+
+1. If you haven't done this already, [enable Home Assistant Cloud](https://www.nabucasa.com/config/).
+2. As soon as you're connected to Home Assistant Cloud, a voice assistant has been created for you.
+   - This voice assistant is using text-to-speech and speech-to-text engines based on the region settings of your Home Assistant user.
+3. To view the settings, go to {% my voice_assistants title="**Settings** > **Voice assistants**" %} and under **Assist**, select **Home Assistant Cloud**.
+     ![Select the Home Assistant Cloud voice assistant](/images/assist/assistants_ha_cloud.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:
+       ```
+4. If the predefined language settings work for you, skip the next step.
+5. If you want to make some changes:
+   - If you like, change the name. You can pick any name that is meaningful to you.
+   - If you do not agree with the predefined language, select the language that you want to speak.
+   - Under **Conversation agent**, select **Home Assistant**.
+   - Under **Speech-to-text**, select the language you want to speak.
+   - Under **Text-to-speech**, select the language you want Assist to use when speaking to you.
+   - Depending on your language, you may be able to select different language variants.
+   - If you want to use a wake word, [install the openWakeWord add-on](/voice_control/install_wake_word_add_on/).
+
+6. That's it. You can now speak to your device, and the device can answer in the language you defined.
+7. If you haven't done so yet, [expose your devices to Assist](/voice_control/voice_remote_expose_devices/#exposing-your-devices).
+   - Otherwise you won't be able to control them by voice.
+
+## Related topics
+
+- [Enable Home Assistant Cloud](https://www.nabucasa.com/config/)
+- [Installing the openWakeWord add-on](/voice_control/install_wake_word_add_on/)
+- [Create your own wake word](/voice_control/create_wake_word/)
+- [Expose your devices to Assist](/voice_control/voice_remote_expose_devices/#exposing-your-devices)