Prompting Users With Ask Nodes

This guide assumes familiarity with:

In this guide, you'll learn how to use the following:

  • Ask Confirmation Node
  • Ask Selection Node

Sometimes Bixby needs confirmation from users in order to proceed to the next action. This is when the Ask nodes are handy.

Use the Ask Selection Node to prompt users to choose one option from a set of options. Use the Ask Confirmation Node to process the "Yes" or "No" confirmation response from users.

Ask Confirmation Node

The Ask Confirmation node asks the user to confirm (or cancel) the following actions in the execution graph.

Ask Confirmation Node

Input Parameters

The Ask Confirmation node takes in the following input parameters:

  • Node trigger: Specify which intent you want to trigger with Ask Confirmation Node.

Node Configuration

You can configure the node with:

  1. Dialogue: Select or specify dialogue which need to be provided to user.

Ask Confirmation Node Configuration

Output Parameters

The Ask Confirmation node outputs the following parameters::

  • Yes: Triggered when user has confirmed.
  • No: Triggered when user has not confirmed.
  • Value: Node execution result. Yes or No.

Example Action Flow

The following example explains an action flow for the command "Set the volume of the #{Device}".

  1. The user utterance trigger: The user says "Set the volume of the #{Device}", which executes a POST command. For more information about sending commands, see Sending a Device Command.
  2. Validating the volume of device: If the new volume is between 80 and 100 and is greater than the current volume, then Bixby proceeds to the Ask Confirmation node; otherwise it sends the SmartThings command to the device.
  3. User confirmation: The user is prompted with an utterance. For example, in English, Bixby would say That might be really loud. Still want me to turn it up? for confirmation. The Ask Confirmation node takes the user input (either "Yes" or "No") and performs the next actions based on that.

Action flow for Ask Confirmation

Ask Selection Node

The Ask Selection node asks the user to select from the list of choices and returns the selected choice with a zero-based index.

Ask Selection Node

Input Parameters

The Ask Selection node takes in the following input parameters:

  • Node trigger: Specify which intent you want to trigger with the Ask Selection Node.
  • Choices: List of options (Choices)

Node Configuration

-Dialogue: Select or specify dialogue that need to be provided to the user.

Output Parameters

The Ask Selection node outputs the following parameters::

  • Main: Triggered when user has confirmed.
  • Value: Node execution result.

Ask Selection Node Configuration

Example Action Flow

The following example explains the whole process through an action flow for the command "Change the wind strength of the #{Device}"

Follow the steps mentioned below for Ask Selection Node support:

  1. The user utterance trigger: "Change the wind strength of the #{Device}" utterance executes the POST command (Sending an SmartThings command with an argument).
  2. Validating status of device: If the device status has failed (device is switched-off), the ‘Execution Failed’ message is displayed. If it is a pass, it will go the next step.
  3. Supported mode of device: Get all supported modes of the device and the list is passed to the next step.
  4. User selection: Once list of modes is received, user will be promoted with options. For example, in English, Bixby asks what do you want to set it to?. This node takes the result from the user, and the next steps are processed based on the user choice (selected mode).

Action flow for Ask Selection