Share via


Bot Framework Composer: Ask Questions to users

Introduction

The Bot Framework Composer is a fantastic tool for creating/developing Microsoft bots, as it gives you the ability to sketch out and compose the whole simple and complex Bot applications within a visual interface instead of writing actual code. Composer to create the bot solution’s code and run it immediately to test it in the emulator and deploy it to Azure using the CLI. Bot developers should check out Composer awesome tool, as this will make your Bot development even easier in terms of building smart and engaging bots with ease. A conversation between a bot and a user often involves asking the user for information and parsing the user's response. Bot should track the context of a conversation, so that it can manage the behavior and remember answers to previous questions. Bot Framework composer has provided different question format, in this article we are going to see how we can use Text, Number and Date time input from users and How we can retrieve state information from Bot state.

Create New Bot Application  

On the Bot Framework Composer homepage, click on New. Select Create from scratch. Click on Next.Give your bot a name. Once created, you should be able to see the following screen

 

Asking Question to user

Bot Framework Composer makes it easier to collect information to the user and composer provided feature for validation and variety of data types as follow 

  • Text Input
  • Number Input 
  • Confirmation 
  • Multiple Choice 
  • File or attachment 
  • Date or time
  • OAuth Login

In this article, You are going to learn more about Text,Number and Date/Time Input format and how bot can ask questions to the users. 

Composer Input Control Property – Bot Ask

Ask question Input dialog has 3 category options - Bot Asks, User Input and other. 

  • Prompt - Property -Create your custom message for Bot will send a message to the user .
  • Max turn Count – Maximum number of re- prompt attempts to collect information from user
  • Default Value - Expression to examine on each turn of the conversation as possible value to the property.
  • Allow interruptions - A Boolean expression that determines whether the parent should be allowed to interrupt the input.

User Input 

User Input tab options have "Property to fill".It’s a Property to store collected information. Input will be skipped if property has value (unless Always prompt is true). Example(user.name), user.name property can access anywhere you want to display or store. While displaying you need to use @{user.name} format. 

Bot Text Input Question 

The Greeting conversation activity screen, you can click on the “+” button and select the Ask question options  and click on Text input .

Step 1:Add Bot Asks prompt of text in the text box,which your Bot required to ask questions to the user and the type of  value will allow only as text .

Step 2: If you want to save user input and display somewhere else or store into the database, you can select user Input section and add the variable property as - user.name.

Bot Number Input Format

Bot can ask users to enter any number value using number input. To prompt a user for a number, click the + button in your screen, mouse over Ask a Question and Select the Number input.

  • In this following example Bot asking users to enter the no of years’ experience and provided max turn count as 1 and provided default value as 2.

  • Suppose users enter any text or any invalid character at one time, Bot will take as default value as 2.

  • In user Input options Bot will save the value user.exp property, it will be helpful for retrieve somewhere else.

Bot Date Time Input Format

Bot Date Time Input format control which is returned as a Timex. 

  • You can add the Bot Ask question to the Prompt text box 

  • Create Property for store the date time value, here property as “user.date”.

  • after asking for a date, the bot returns a Timex into “user.date” like below

[{

"value": "2020-02-01",

"timex": "2020-02-01"

}]

  • Because it's a json array with one item. So you can access the components like user.date[0].timex (or) user.date[0].value

Confirmation Message 

We have asked 3 different questions to the user; now let us show confirmation message to the user with whichever user responded to the bot. You can compose message like below  

Hello @{user.name} , You have @{user.exp} years’ experience and please join our company on @{user.date[0].value}

Test in Bot Emulator

Next, click on “Test in Emulator” after that browser will ask you permission to open the bot emulator, once you confirmed the message, Bot emulator will open and automatically navigate to your Bot service. You can start responding to the message to the bot.

Summary

You have successfully created and run the “Ask Question bot” using Bot framework composer. I hope you have enjoyed learning. If you have any questions/feedback/issues, please write them in the comment box.

See Also

References