diff --git a/source/_components/conversation.markdown b/source/_components/conversation.markdown index 3b9bb80892f..5397a3297ee 100644 --- a/source/_components/conversation.markdown +++ b/source/_components/conversation.markdown @@ -12,16 +12,32 @@ ha_category: "Voice" --- -The conversation component can process sentences into commands for Home Assistant. It is currently limited to parsing commands in the format `turn `. +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: ```yaml -# Example configuration.yaml entry +# Example base configuration.yaml entry conversation: ``` +To add custom phrases to be recognized: +```yaml +# 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](https://home-assistant.io/docs/scripts/). + + + + 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.