\(Legacy\) Boolean user input control

reference australia Updated Sep 10, 2026 4 min read va-boolean-user-input-nlu.md
Raw file servicenow.com

Use the Boolean user input control in a Virtual Agent topic to present a Yes/No prompt to the user.

Boolean user input controls prompt the user to answer a Yes/No question, and store the response as a string with a value of true or false. Use this value in topic utilities, such as the prompted Decision utility, to branch the topic flow based on the answer.

When you place this control on the canvas, a window appears with the header Add a decision node? The window message reads A decision node will be added following this node and has No and Yes options. If you select No, you must add a Decision utility to complete the Boolean. You can customize the names of the output values on the Decision node. For more information, see Decision utility.

Boolean user input control properties for NLU topic discovery

Property

Description

Node name

Name that identifies this node in the topic flow.

Variable name

Name of the variable that stores the user response to this prompt. The variable name is automatically created from the Node name property.

Prompt

Prompt or question for the user. The prompt can be either a text string or a script that returns text. This value is used only when the default value is not specified. For example: What's your name?

NLU entity[NLU topic discovery only]

Option to associate an NLU entity with the node. If an NLU entity is associated with the input variable for this node, Virtual Agent can slot-fill the specified value based on the user's utterance. Select an entity from the list of entities associated with the topic intent. When you specify an entity for the node, the Do not ask users to confirm recognized entity toggle switch is displayed. When enabled, users are not prompted to confirm the extracted entity.

Advanced

Default value

Predefine a value for user input

Predefined value for the user response to the question or prompt. The response defined in the Default value confirmation field asks the user to confirm the default value. If the user responds with no, the value becomes null. The default value can be either a text string or a script that returns text. For example, if you're using dot-walking, the default value might be: Script Variables > Last username. Or if you're using a script, the default value might be: {{vaScripts.lastUsername}}.

Confirmation messages

Input completion confirmation

Bot response shown to the user when the node interaction is complete. The message can be either a text string or a script that returns text. For example, if you're using dot-walking: Thanks, (Input Variables > Username)! Or if you're using a script, the acknowledgement might be: Thanks, {{vaInputs.username}}!

Default value confirmation

Message that asks the user to verify that the value in the Default value field is correct. This message is used instead of a value in the Prompt field. It can contain either a text string or a script that returns text. For example, if you're using dot-walking: Are you (Input Variables > Username)? Or if you're using a script, the confirmation message might be: Are you {{vaScripts.lastUsername}}?.

Conversation switching

This section is available only when NLU discovery is enabled on the instance.

Turn on to let users change the subject

Option to enable NLU prediction for this node. If enabled, users can enter text to answer questions, regardless of the type of input control being used. Virtual Agent uses this utterance to match another existing intent, letting the user switch topics.

Hide or skip this node

Conditionally show this node if

No-code condition statement or low-code script that specifies a condition for presenting this node in the conversation. The condition must evaluate to true.

Allow user to skip this node if

No-code condition statement or low-code script that specifies a condition for letting users skip this node in the conversation. The condition must evaluate to true. You can set this field using either the condition builder or a script.

Skip reprompting if

No-code condition statement or low-code script that specifies a condition for letting users skip reprompting in the conversation. When a preceding node is revisited through a topic loopback or Dialog Act, Virtual Agent bypasses this node and automatically retains its original value.

## Example Boolean user input control for NLU topic discovery

Note: Virtual Agent Designer controls may display and function differently in other channels.

Input properties

Input prompt

[Omitted image "va-boolean-properties.png"] Alt text: Basic properties include the node name, prompt, and NLU entity.

[Omitted image "va-boolean-input-web.png"] Alt text: An example prompt reads, "Would you like to add a comment?" Answers are Yes and No.

[Omitted image "va-boolean-input-slack.png"] Alt text: An example prompt reads, "Would you like to add a comment?" Answers are Yes and No.

## Channel support
Channel NLU/keyword support Constraints
Web UI Supported None
Mobile UI Supported None
Now Assist panel Supported None
Microsoft Teams Supported None
Slack Supported None
SMS Twilio Supported None
LINE Supported None
WhatsApp Supported None
Apple Messages for Business Supported None
Alexa (Voice) Supported None

Parent Topic:(Legacy) Virtual Agent Designer user input controls for NLU

Keywords Virtual AgentDesignerBooleanUser inputcontrolnodeYesNoprompt
Search documentation
Search document titles and file paths on the australia branch