Create and Hook Up New Chatbot

Disclaimer: Preview version; content and features subject to change. 


This tutorial is geared towards any researcher and developer who wants to create new NLP content with a chatbot and hook that up to VHToolkit 2.0.

Page Contents



This tutorial shows how the configuration file in VHToolkit 2.0 can be used to use new chatbots, and how to create a new chatbot in AWS Lex V2.


  • AWS account
  • AWS admin

How To Edit the VHToolkit 2.0 Config File

Either manually edit with a text editor, or open it up through Unity.


File locations:

  • Windows: C:\Users\<user>\AppData\LocalLow\USC-ICT\VHToolkit-IVA2023\config\ride.json
  • Mac: Macintosh HD/Users/<user>/Library/ApplicationSupport/.com.UCT-ICT.AvatarTestbed/config/ride.json


  • Use (Command +) F11 to bring up the debug menu and go to the Config submenu
  • Click Open Folder Location or Edit Config

How To Point Towards a New Chatbot

The ride.json config file has several sections, including one for awsLex. This combines information for both version 1 and version 2 of Lex. We will be using V2.

To change the bot from the default shipped with the VHToolkit 2.0 Preview to a dedicated tutorial example, change the following values:

  • Bot alias ID: NUYJVTFRYZ
  • AccessKey: AKIASLAD6BP52Q7I4G64
  • SecretKey: qzNiABMxlV40oh8fPiZUmQXIxTWVoVMapZ+xC1T+

Save the file, load VHToolkit 2.0 Preview, and choose ExampleNLP. Cycle through the providers on the left until you reach AWS Lex V2. The VHToolkit should automatically send “hello” in order to get the conversation started. For a first time start-up, this may take a few seconds.

How To Create a New AWS Lex V2 Chatbot Based on an Existing One

  • Log into the AWS Console:
  • Search for “Lex” in the AWS Console and click the service
  • AWS Lex will open and will automatically go to V2
    • To verify, see that the lower left menu says “Return to the V1 console”
  • To export VHToolkit-IVA-Example:
    • Select the bot
    • From the Action menu at the top right, select Export
    • Default options are good
    • Click Export

  • To import VHToolkit-IVA-Example:
    • Choose Import from the Action menu at the top right
    • Choose name (e.g., VHToolkit-IVA-<Name>)
    • Browse file for the one you just exported
    • For IAM Permissions, select Use an existing role
    • For COPPA, answer “no”
    • Click Import


  • To build the new bot:
    • Click on your new bot and go to Intents
    • Click Build at top right
    • Once built, click Test at the top right to test