File size: 4,791 Bytes
d288445 4bee647 d288445 4bee647 d288445 4bee647 d288445 4bee647 9d7438f d288445 4bee647 d288445 2761f85 9d7438f d288445 82b364a d288445 abcb242 4bee647 d288445 82b364a d288445 82b364a d288445 82b364a d288445 4bee647 d288445 4bee647 d288445 4bee647 d288445 abcb242 d288445 abcb242 d288445 4bee647 d288445 abcb242 d288445 b25a3d8 d288445 4bee647 d288445 |
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 |
<!--lint disable no-literal-urls-->
<p align="center">
<a href="https://zir-ai.com/">
<img
alt="Zir AI"
src="https://zir-ai.com/static/media/logo-light.637c616a.svg"
width="400"
/>
</a>
</p>
The source code in this repository shows a simple Rasa chatbot fallback
mechanism, which gets relevant information from ZIR Semantic Search.
# Table of contents
- [Rasa Bot & Zir](#rasa-bot--zir)
- [Setup & Play](#setup--play)
- [Set-up Rasa](#set-up-rasa)
- [Set-up repo](#set-up-repo)
- [Running the demo](#running-the-demo)
- [Customizing the bot](#customizing-the-bot)
- [Data](#data)
- [Rasa Custom Action](#rasa-custom-action)
## Rasa Bot & Zir
[Rasa](https://rasa.com/) is the leading conversational AI platform, for
personalized conversations at scale. Developers provide the questions they
expect the end customer to ask and the Rasa bot, using AI, predicts and matches
what the customer intended to ask. With this information at hand, developers can
easily match what the bot should respond to.
This is all well unless when the customer asks a valid question the developer
did not expect, for such a scenario Rasa provides a
[fallback mechanism](https://rasa.com/docs/rasa/fallback-handoff#fallbacks).
> Although Rasa will generalize to unseen messages, some messages might receive
> a low classification confidence. Using Fallbacks will help ensure that these
> low confidence messages are handled gracefully, giving your assistant the
> option to either respond with a default message or attempt to disambiguate the
> user input.
Using the mechanism the bot can ask a fallback action and search through the
reviews uploaded in [Zir-AI](https://zir-ai.com) with the help of
[custom actions](https://rasa.com/docs/rasa/custom-actions). The relevant
information is shown if available otherwise if the confidence of the question to
reviews available is low, we fallback to a generic statement.
The results sum up to be this:
## Setup & Play
Clone this repository and afterwards install Rasa using following instructions.
> You might want to create a
> [virtual environment](https://docs.python.org/3/library/venv.html) to isolate
> the dependencies rasa requires.
### Set-up Rasa
Follow the
[rasa installation instructions](https://rasa.com/docs/rasa/installation) or
copy-paste the following commands in terminal
```bash
pip3 install -U pip
pip3 install rasa
rasa --version
```
This should print the rasa version similar to follow
```bash
Rasa Version : 2.7.0
Minimum Compatible Version: 2.6.0
Rasa SDK Version : 2.7.0
Rasa X Version : None
Python Version : 3.8.5
Operating System : Linux
Python Path : /bin/python3
```
> Windows & WSL (Windows Subsystem for Linux) works too
### Set-up repo
You should be in the cloned repository folder before running following commands.
The bot uses spacy in its pipeline & requires you to have it installed. Run the
following commands in shell
```bash
pip install -r requirements.txt
python3 -m spacy download en_core_web_md
```
This will install the spacy model `en_core_web_md` the bot is configured with.
Now you'll need to train the rasa bot
```bash
rasa train
```
### Running the demo
While running the model, you are required to run the rasa action server along
with the rasa bot. So in one terminal run
```bash
rasa run actions
```
In another terminal, you can either play with the bot in your `shell` or on the
browser.
To talk to the bot in shell run
```bash
rasa shell
```
Or to talk to the bot in the browser run
```bash
rasa run --credentials ./credentials.yml --enable-api --auth-token XYZ123 --model ./models --endpoints ./endpoints.yml --cors "*"
```
Now, open the `index.html` in your browser to talk to the bot.
## Customizing the bot
Use the following information to customize the bot and the source of data.
### Data
Data for the bot is sourced from [OpinRank](https://github.com/kavgan/OpinRank/)
and reviews for Hotel Jumeirah are specifically used for this bot. Reviews are
parsed from https://github.com/amin3141/zir-souffle. Use `hotels.py` to generate
the output `json` and the `reviews.db`. Copy the generated `reviews.db` file to
this repository.
Create a corpus on [Zir AI](https://zir-ai.com/console/corpora) and upload all
the JSON files. Create an API key for access and note down the following
information
- API key
- corpus id
- customer id
### Rasa Custom Action
Use the above-collected information and replace the information in
`actions/actions.py` and you're good to go.
```python
customer_id = "1835841754"
corpus_id = 1
header = {
"customer-id": customer_id,
"x-api-key": "zqt_WvU_2atFHgqYxxT2sQswwIUgogI8K3QeWs0oqA"
}
```
|