Assist: update intro topic (#29613)

This commit is contained in:
c0ffeeca7 2023-10-31 08:57:46 +01:00 committed by GitHub
parent 5a5d56beda
commit 49b501e5b3
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23

View File

@ -6,28 +6,75 @@ title: Assist - Talking to Home Assistant
Assist is our feature to allow you to control Home Assistant using natural language. It is built on top of an open voice foundation and powered by knowledge provided by our community.
## Supported platforms
Assist is available to use on most platforms that can interface with Home Assistant. Look for the Assist icon <img src='/images/assist/assist-icon.svg' alt='Assist icon' style='height: 32px' class='no-shadow'>:
<lite-youtube videoid="qkgdHTHM7Uw" videotitle="Home Assistant Year of the Voice, Part 3"></lite-youtube>
### Phone
The easiest way to get started with Assist is probably by using it on your phone.
- Inside the Home Assistant app in the top-right corner, select the Assist icon.
- On Apple devices via [Siri and Assist shortcuts](/voice_control/apple).
- On Android phones as the default [digital assistant or home screen shortcut](/voice_control/android)
- On Wear OS watches as the default digital assistant or using [Assist tile or complication](//voice_control/android/#assist-on-wear-os).
- On Android phones as the default [digital assistant or home screen shortcut](/voice_control/android).
- On a tablet in kiosk mode, you can use a [dashboard button](/voice_control/start_assist_from_dashboard/) to start Assist.
### Watch
You can also set a wake word, so that Assist starts
Assist is also available on watches:
- On Wear OS watches as the default digital assistant or using [Assist tile or complication](/voice_control/android/#assist-on-wear-os/).
<lite-youtube videoid="Dr_ZCbt8w5k" videotitle="Assist on Wear OS"></lite-youtube>
### Google Assistant or Amazon Alexa
_Want to use Home Assistant with Google Assistant or Amazon Alexa? Get started with [Home Assistant Cloud](https://www.nabucasa.com/config/)._
With Assist, you can use the [built-in sentences](/voice_control/builtin_sentences) to control entities and areas, or [create your own](/voice_control/custom_sentences).
### Analog phone
[List of supported languages.](https://developers.home-assistant.io/docs/voice/intent-recognition/supported-languages)
With the Voice over IP integration, you can even use an [analog phone](/voice_control/worlds-most-private-voice-assistant/) to talk to Assist.
Did Assist not understand your sentence? [Contribute them.](https://developers.home-assistant.io/docs/voice/intent-recognition/)
<lite-youtube videoid="0YJzLIMrnGk" videotitle="Using an analog phone to control Home Assistant"></lite-youtube>
The Assist icon doesn't show up? Make sure the [conversation](/integrations/conversation/) integration is enabled. If you use YAML for configuration and have removed `default_config:`, the conversation integration may not be included in the config file.
### ESPHome
And of course you can use [ESPHome devices](/voice_control/thirteen-usd-voice-remote/), to create your own awesome Assistant device. Like @piitaya did with his 3D printed R5 droid.
<lite-youtube videoid="vQ7Hmeume9g" videotitle="Wake word demonstration on ESPHome-based 3D printed droid in Home Assistant"></lite-youtube>
## Wake words
You can [enable a wake word](/voice_control/install_wake_word_add_on) to activate Assist. There are predefined wake words, such as "OK Nabu", but you can also [define your own wake word](/voice_control/create_wake_word/)
<lite-youtube videoid="ziebKt4XLZQ" videotitle="Wake word demonstration on $13 ATOM Echo in Home Assistant"></lite-youtube>
## Create an assistant with an OpenAI personality
Want to talk to Super Mario? Or another figure? If you want Assist to respond in a fun way, you can create an assistant with an [OpenAI personality](/voice_control/assist_create_open_ai_personality/).
<lite-youtube videoid="eLx8_NAqptk" videotitle="Give your voice assistant personality using the OpenAI integration"></lite-youtube>
## Supported languages and sentences
Assist already supports a wide range of [languages](https://developers.home-assistant.io/docs/voice/intent-recognition/supported-languages).
Use the [built-in sentences](/voice_control/builtin_sentences) to control entities and areas, or [create your own sentences](/voice_control/custom_sentences/).
Did Assist not understand your sentence? [Contribute them](https://developers.home-assistant.io/docs/voice/intent-recognition/).
_Assist was introduced in Home Assistant 2023.2._
<lite-youtube videoid="ziebKt4XLZQ" videotitle="Wake word demo on $13 ATOM Echo in Home Assistant"></lite-youtube>
## Related topics
- [Home Assistant Cloud](https://www.nabucasa.com/config/)
- [Assist on Android](/voice_control/android)
- [Assist on Wear OS](/voice_control/android/#assist-on-wear-os)
- [Siri and Assist shortcuts](/voice_control/apple)
- [Assist dashboard button](/voice_control/start_assist_from_dashboard/)
- [Build a 13$ voice remote using an ESPHome device](/voice_control/thirteen-usd-voice-remote/)
- [Enable a wake word](/voice_control/install_wake_word_add_on)
- [Create your own wake words](/voice_control/create_wake_word/)
- [Built-in sentences](/voice_control/builtin_sentences)