julianweng / austin

Chatbot allowing students to practice equation-based problems in natural conversational language.

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

austin

A chatbot that helps you grasp numeric relationships and concepts with conversational ease.

  • Dynamically generates questions and presents it in a conversational manner.
  • Easily adaptable to any topic area with numerical relationships.
  • Answers to user requests for certain questions with flexibility according to wording.
  • Intelligently chooses variable solved for and topic area based on past usage history.

How-Tos

Use existing container

How to launch a docker container with RASA X and the necessary packages in it. (Port 5002 is for RASA X, 5005 is for RASA Core, 5055 is for action server and port 80 for built-in web interface)

Windows: docker run -d -p 5005:5005 -p 5002:5002 -p 5055:5055 -p 80:80 -p 8888:8888 --name austin -e GRANT_SUDO=yes --user root -e JUPYTER_ENABLE_LAB=yes -v %cd%:/home/jovyan julianweng/austin

Linux/Mac? (untested with mac): docker run -d -p 5005:5005 -p 5002:5002 -p 5055:5055 -p 80:80 -p 8888:8888 --name austin -e GRANT_SUDO=yes --user root -e JUPYTER_ENABLE_LAB=yes -v $PWD:/home/jovyan julianweng/austin

Run various commands (run the first command and then the two after that concurrently to talk with it and train it)

docker exec -it austin rasa train --domain ./domain # train RASA model
docker exec -it austin rasa run actions # run action server
docker exec -it austin rasa x --domain ./domain # run RASA X
docker exec -it austin rasa run --enable-api --cors "*" # run RASA core with pretrained model
docker exec -it austin python -m http.server 80 -d ./web

All the files in this folder will be mounted to the container, and be used by the RASA X.

Known issues

After running rasa x and loading the webpage, you might run into an error concerning "Sanic response handler." The only known solution at this time is to wait for the models to load after running the rasa x command before opening Rasa X in localhost:5002 (a useful heuristic is waiting until the three userwarnings are printed in the terminal from which you launched rasa x).

How to add new questions types

Navigate to /actions/quiz/questions.csv. Add a new row for every question added. For equation, enter in a symbolic equation with a "symbol" being any combination of sucessive capital letters (avoiding repeats with symbols used for other variables). The category is a placeholder for now. Aliases are a list of common phrases used to describe the equation or question type, they do not need to be all-emcompassing since the program uses a separate semantic similarity model to match what a user asks for with the correct equation type. QuestionTexts are templates for the bot to generate questions with. It is composed of a list separated with the "#" symbol of strings in the format {symbol of independent variable}: Bob has &{symbol of dependent variable} apples, how many pears does he have? Each variable that could be an independent variable must have its own entry within this list.

If your new equation involves a variable that has not been included in any equation to date, navigate to /actions/quiz/alias.csv and add a new row, with the Symbol in the Symbol column and any aliases in the Aliases column (these are emcompassing).

EndPoints

credentials.yml

For RASA X to talk to RASA Core

rasa:
    url: "http://localhost:5002/api"
    # url: "http://austinrasa.ngrok.io/api"

endpoints.yml

For RASA Core to talk to Action Server

action_endpoint:
    url: "http://localhost:5055/webhook"
    # url: "https://austinaction.ngrok.io/webhook"

constants.js

For RABuilt-in Web Widget to talk to RASA Core and Action Server

const rasa_server_url = "https://austincore.ngrok.io";
//const rasa_server_url = "http://localhost:5005";

const rasa_action_url = "https://austinaction.ngrok.io";
// const rasa_action_url = "http://localhost:5055";

Expose RASA online

Run this on host machine. ngrok start --all --config=ngrok.yml

Directories

domain

data

actions

Contains all of the custom python code for the quiz.

Other Directories

You usually don't have to change these directories.

bots

Any bot not supported by Rasa's endpoints.

web

This contains the static files for the built-in web chatting application.

more_data

This is where the unused traning data is stored.

models

It's where the models are stored when training is done.

About

Chatbot allowing students to practice equation-based problems in natural conversational language.

License:GNU General Public License v3.0


Languages

Language:JavaScript 52.6%Language:Python 35.4%Language:HTML 10.8%Language:Dockerfile 1.3%