Skip to content

Latest commit

 

History

History
 
 

13.basic-bot

README.md

basic-bot

This bot has been created using Microsoft Bot Framework,

This samples shows how to:

  • Use LUIS to implement core AI capabilities
  • Implement a multi-turn conversation using Dialogs
  • Handle user interruptions for such things as Help or Cancel
  • Prompt for and validate requests for information from the user

To try this sample

  • Clone the repository 
    git clone https://github.com/microsoft/botbuilder-samples.git
  • In a terminal, 
    cd samples/javascript_nodejs/13.basic-bot
  • [Optional] Update the .env file under samples/javascript_nodejs/08.suggested-actions with your botFileSecret For Azure Bot Service bots, you can find the botFileSecret under application settings.
  • Install modules 
    npm install
  • Create required services
  • Run the sample 
    npm start

Testing the bot using Bot Framework Emulator

Microsoft 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 Bot Framework Emulator from here

Connect to bot using Bot Framework Emulator v4

  • Launch Bot Framework Emulator
  • File -> Open Bot Configuration and navigate to samples/javascript_nodejs/13.basic-bot folder
  • Select basic-bot.bot file

Deploy this bot to Azure

See here to learn more about deploying this bot to Azure and using the CLI tools to build the LUIS models this bot depends on.

Further Reading

Additional Resources

Dependencies

  • Restify Used to host the web service for the bot, and for making REST calls
  • dotenv Used to manage environmental variables

Project Structure

index.js references the bot and starts a Restify server. bot.js loads the dialog type you selected when running the generator and adds it as the default dialog.

Configuring the bot

Update .env with the appropriate keys botFilePath and botFileSecret.

  • For Azure Bot Service bots, you can find the botFileSecret under application settings.
  • If you use MSBot CLI to encrypt your bot file, the botFileSecret will be written out to the console window.
  • If you used Bot Framework Emulator V4 to encrypt your bot file, the secret key will be available in bot settings.

Running the bot

node ./index.js

Developing the bot

nodemon ./index.js