From 91972a262967b3f256f2f42d051df6f72cdfbe83 Mon Sep 17 00:00:00 2001 From: Paulus Schoutsen Date: Tue, 6 Mar 2018 13:02:17 -0800 Subject: [PATCH] Add docs for optional words in conversation utterances (#4779) --- source/_components/conversation.markdown | 81 +++++++++++++------ source/images/screenshots/voice-commands.png | Bin 30851 -> 14828 bytes 2 files changed, 57 insertions(+), 24 deletions(-) diff --git a/source/_components/conversation.markdown b/source/_components/conversation.markdown index 55b9fbb19a7..c4ae729c0f8 100644 --- a/source/_components/conversation.markdown +++ b/source/_components/conversation.markdown @@ -11,46 +11,79 @@ logo: home-assistant.png ha_category: "Voice" --- +The conversation component allows you to converse with Home Assistant. You can either converse by pressing the microphone in the frontend (supported browsers only (no iOS)) or by calling the `conversation/process` service with the transcribed text. -The `conversation` component can process sentences into commands for Home Assistant. It currently has built in functionality to recognize `turn `, but custom phrases can be added through configuration. - - -To enable the conversation option in your installation, add the following to your `configuration.yaml` file: +

+ + Screenshot of the conversation interface in Home Assistant. +

```yaml # Example base configuration.yaml entry conversation: ``` -To add custom phrases to be recognized: +{% configuration %} +intents: + description: Intents that the conversation component should understand. + required: false + type: map + keys: + '``': + description: Sentences that should trigger this intent. + required: true + type: list +{% endconfiguration %} -```yaml -# Example configuration.yaml entry with custom phrasesconversation -conversation: - boolean_test: - sentence: switch boolean # The phrase it will recognize - action: - service: input_boolean.toggle -``` +## {% linkable_title Adding custom sentences %} -The action keyword uses [script syntax](https://home-assistant.io/docs/scripts/). +By default, it will support turning devices on and off. You can say things like "turn on kitchen lights" or "turn the living room lights off". You can also configure your own sentences to be processed. This works by mapping sentences to intents and then configure the [intent script component](/components/intent_script/) to handle these intents. -To use the `conversation` component with the [`shopping list` component](/components/shopping_list/) add an intent. +Here is a simple example to be able to ask what the temperature in the living room is. ```yaml # Example configuration.yaml entry conversation: intents: - ShoppingListAddItem: - - Add {item} to my shopping list + LivingRoomTemperature: + - What is the temperature in the living room + +intent_script: + LivingRoomTemperature: + speech: + text: It is currently {% raw %}{{ states.sensor.temperature }}{% endraw %} degrees in the living room. ``` -When this component is active and you are using a supported browser voice commands will be activated in the frontend. Browse to [the demo](/demo/) using Chrome or Chromium to see it in action. +## {% linkable_title Adding advanced custom sentences %} -

- -

+Sentences can contain slots (marked with curly braces: `{name}`) and optional words (marked with square brackets: `[the]`). The values of slots will be passed on to the intent and are available inside the templates. -

- Apple iPhones do not support this feature in any browser. -

+The following configuration can handle the following sentences: + + - Change the lights to red + - Change the lights to green + - Change the lights to blue + - Change the lights to the color red + - Change the lights to the color green + - Change the lights to the color blue + +```yaml +# Example configuration.yaml entry +conversation: + intents: + ColorLight: + - Change the lights to [the color] {color} +{% raw %} +intent_script: + ColorLight: + speech: + text: Changed the lights to {{ color }}. + action: + service: light.turn_on + data_template: + rgb_color: + - "{% if color == 'red' %}255{% else %}0{% endif %}" + - "{% if color == 'green' %}255{% else %}0{% endif %}" + - "{% if color == 'blue' %}255{% else %}0{% endif %}" +{% endraw %} +``` diff --git a/source/images/screenshots/voice-commands.png b/source/images/screenshots/voice-commands.png index 5ff003a0fbf32d021f1db878ac744ea76c3402cd..39a98deef7ed7b3a44e3cb197fc628bfb7377183 100644 GIT binary patch literal 14828 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 CyeK#T