BotBuilder-Samples/samples/javascript_nodejs/05.multi-turn-prompt/README.md

3.5 KiB

Multi-turn prompt

Bot Framework v4 multi-turn prompt bot sample

This bot has been created using Bot Framework, it shows how to use the prompts classes included in botbuilder-dialogs. This bot will ask for the user's name and age, then store the responses. It demonstrates a multi-turn dialog flow using a text prompt, a number prompt, and state accessors to store and retrieve values.

Prerequisites

  • Node.js version 18 or higher

    # determine node version
    node --version
    

To try this sample

  • Clone the repository

    git clone https://github.com/microsoft/botbuilder-samples.git
    
  • In a terminal, navigate to samples/javascript_nodejs/05.multi-turn-prompt

    cd samples/javascript_nodejs/05.multi-turn-prompt
    
  • Install modules

    npm install
    
  • Start the bot

    npm start
    

Testing the bot using Bot Framework Emulator

Bot Framework Emulator is a desktop application that allows bot developers to test and debug their bots on localhost or running remotely through a tunnel.

  • Install the latest Bot Framework Emulator from here

Connect to the bot using Bot Framework Emulator

  • Launch Bot Framework Emulator
  • File -> Open Bot
  • Enter a Bot URL of http://localhost:3978/api/messages

Interacting with the bot

A conversation between a bot and a user often involves asking (prompting) the user for information, parsing the user's response, and then acting on that information. This sample demonstrates how to prompt users for information using the different prompt types included in the botbuilder-dialogs library and supported by the SDK.

The botbuilder-dialogs library includes a variety of pre-built prompt classes, including text, number, and datetime types. This sample demonstrates using a text prompt to collect the user's name, then using a number prompt to collect an age.

Deploy the bot to Azure

To learn more about deploying a bot to Azure, see Deploy your bot to Azure for a complete list of deployment instructions.

Further reading