jeans/home-assistant.io
jeans/home-assistant.io
1
0
Fork 0
mirror of https://github.com/home-assistant/home-assistant.io.git synced 2025-06-20 00:56:53 +00:00
Code Issues Packages Projects Releases Wiki Activity
home-assistant.io/source/voice_control/custom_sentences.markdown
c0ffeeca7 2fc631b626
Assist customize responses: Fix link (#37187)
2025-01-29 17:41:29 +01:00

3.3 KiB
Raw Permalink Blame History

title, related
title related
Adding a custom sentence to trigger an automation
docs title
/voice_control/aliases/ Create aliases
docs title
/docs/scripts/#respond-to-a-conversation Conversation response script action
docs title
/docs/automation/trigger/#sentence-trigger Sentence triggers
docs title
/docs/automation/trigger/#sentence-wildcards Sentence wildcards
docs title
voice_control/custom_sentences_yaml Customize responses
url title
https://developers.home-assistant.io/docs/intent_builtin/ View existing intents

You may add your own sentences to the intent recognizer by either extending an existing intent or creating a new one. You may also customize responses for existing intents.

Prerequisites

Prerequisites

You need a working Assist configuration. If you haven't done so yet, check Assist's starting page to get you ready with your setup.

To add a custom sentence to trigger an automation

This is the easiest method to get started with custom sentences for automations.

  1. Under {% my automations title="Settings > Automations & Scenes" %}, in the bottom right corner, select Create automation.

  2. In the Trigger drop-down menu, select Sentence.

  3. Enter one or more sentences that you would like to trigger an automation.

    • Do not use punctuation.
    • You can add multiple sentences. They will then all trigger that automation. Add a custom sentence

  4. To add a custom response, select Add action. Scroll all the way down and select Other actions.

    • Then, select Set conversation response. Set conversation response

  5. In the text field, enter the response you want to hear from Assist and select Save.

    Enter the response text

    • You can also use wildcards. For example, the trigger:

      play {album} by {artist}

      could have the response:

      {% raw %}

      Playing {{ trigger.slots.album }} by {{ trigger.slots.artist }}

      {% endraw %}

    • For more details, refer to conversation response script action.

  6. To test the automation, go to Overview and in the top right corner, open Assist.

    • Enter one of the sentences.

  7. If it did not work out, checkout the troubleshooting section.

    • One of the causes could be that the device you're targeting has not been exposed to Assist.

  8. Pick up your voice control device and speak the custom sentence.

    • Your automation should now be triggered.

Setting up custom sentences in configuration.yaml

To set up custom sentences in your configuration file follow this tutorial.

Related devices and installation tutorials