From f7ab7092d436b576a993169cd488fd0aa28c0373 Mon Sep 17 00:00:00 2001 From: Marco Sirabella Date: Tue, 4 Jul 2017 04:45:33 -0400 Subject: [PATCH] Added new config docs for conversation (#2697) * - Updated description * - Added different example and explained action --- source/_components/conversation.markdown | 20 ++++++++++++++++++-- 1 file changed, 18 insertions(+), 2 deletions(-) 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.