home-assistant.io/source/_components/conversation.markdown
Marco Sirabella f7ab7092d4 Added new config docs for conversation (#2697)
* - Updated description

* - Added different example and explained action
2017-07-04 10:45:33 +02:00

1.3 KiB

layout, title, description, date, sidebar, comments, sharing, footer, logo, ha_category
layout title description date sidebar comments sharing footer logo ha_category
page Conversation Instructions how to have conversations with your Home Assistant. 2015-03-15 00:39 true false true true home-assistant.png Voice

The conversation component can process sentences into commands for Home Assistant. It currently has built in functionality to recognize turn <Friendly Name> <on/off>, but custom phrases can be added through configuration.

To enable the conversation option in your installation, add the following to your configuration.yaml file:

# Example base configuration.yaml entry
conversation:

To add custom phrases to be recognized:

# Example configuration.yaml entry with custom phrasesconversation
conversation:
    boolean_test:
        sentence: switch boolean # The phrase it will recognize
        action:
            service: input_boolean.toggle

The action keyword uses script syntax.

When this component is active and you are using a supported browser voice commands will be activated in the frontend. Browse to the demo using Chrome or Chromium to see it in action.

Apple iPhones do not support this feature in any browser.