Static Choice user input control
-
- UpdatedAug 3, 2023
- 9 minutes to read
- Vancouver
- Virtual Agent
Use the Static Choice user input control in a Virtual Agent topic to list predefined choices available to the user. A user can select only one item from a choice list.
Choice list display
The choice list contains up to 10 items per page. When more than 10 items exist, users have the option to display the additional items and filter the search results. The choice list prompt contains a search icon 
that users can select to filter the results.
The header card can contain a large or small image or a YouTube video card, along with descriptive text. The choice list contains up to five items by default, but the search feature is suppressed. If there are more than five items, users can choose to show the additional items.
To control the number of items displayed below a header card, add the com.glide.cs.web_header_picker_page_limit system property. Use the Value to specify the number of items displayed in the choice list. For details about creating a system property, see Add a system property.
Static Choice user input control properties for LLM topic discovery
| Property | Description |
|---|---|
| Name | Name that identifies this Static Choice user control node in the topic flow. |
| Detail description | The one piece of information needed from the user. For example, Ask the user which service catalog item they need. |
| Choices | |
| Display name | For each choice, the text that appears to the user for that choice. Use short phrases in your choice lists.
|
| Value | For each choice, the string that is stored in the variable when the corresponding choice is selected. |
| Advanced | |
| Enforce user prompt | Toggle to open a field for a custom message shown to the user instead of the message generated by the LLM. You can create custom messages in plain language, input a script, or define conditions with the data pill picker. |
| Hide this node | |
| Conditionally use 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. |
Example Static Choice user input control for LLM topic discovery
| Input properties | List prompt |
|---|---|
|
The choice list displays 10 items per page. When 10 or more results are returned, the following occurs:
|
Static Choice user input control properties for NLU topic discovery
| Property | Description |
|---|---|
| Node name | Name that identifies this Static Choice user control 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 | 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 displays. When enabled, users are not prompted to confirm the extracted entity. This field is available only when NLU discovery is enabled on the instance. |
| Choices | |
| Display name | For each choice, the text that appears to the user for that choice. Use
short phrases in your choice lists.
|
| Value to store | For each choice, the string that is stored in the variable when the corresponding choice is selected. |
| Advanced | |
| Header card | |
| Insert | Toggle switch to insert a header card above the choice list. You can use the Add card dialog box or a script.
For detailed information, see Insert a header card in a Static Choice or Dynamic Choice control. |
| Would you like help | Option to use the Virtual Agent Designer interface or provide a script. Choose one of the
following options:
|
| Add card dialog box | |
| This section is available only when Header card is enabled. | |
| Card type | Type of header card. Choose one of the following:
|
| Title | Image or video title. Enter the title text or use a data pill or script to specify the title. |
| Title Link | URL of the video title hyperlink. Specify the link by either entering the link text, using a data pill, or using a script. If this field is empty, the title displays as plain text. This field is available only when the YouTube Video Card option is selected. |
| Description | Brief explanation of the image or video. |
| YouTube Video ID | Alphanumeric string at the end of the YouTube URL. For example, in the URL https://www.youtube.com/watch?v=AacDp2mUQ1I, the YouTube video ID is AacDp2mUQ1I. This field is available only when the YouTube Video Card option is selected. |
| Image URL Link | URL link for the image or the image file. To set
this field, do one of the following:
This field is available only when the Large image with text or the Small image with text option is selected. |
| Image alt text | Alternative, screen-readable text that describes the
image for accessibility programs. This text is used along with the image. Enter the
text using the text field, data pill, or script.
This field is available only when the Large image with text or the Small image with text option is selected. |
| Default value | |
| Default Value | 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. |
Example Static Choice user input control for NLU topic discovery
| Input properties | List prompt |
|---|---|
|
The choice list displays 10 items per page. When 10 or more results are returned, the following occurs:
|
The choice list contains five items per page. When five or more results are returned, the list provides an option to show more results.
Note: The search feature is suppressed when a header card is
used. |