Content

Python

• Install Python 3.11.x.

• Lower versions of Python may not be compatible with this course.

GitHub

1. Login to GitHub (create an account if you do not have one).

2. Create a new repository called conversational-ai and make it private.

3. From the [Settings] menu, add the instructors as collaborators of this repository.

   • Jinho Choi: jdchoi77

   • Talyn Fan: talynfan

   • Benjamin Ascoli: bossben

   • Sichang Tu: SichangTu

PyCharm

Install PyCharm on your local machine:

• The following instructions assume that you have "PyCharm 2022.3.x Professional Edition".

• You can get the professional version by applying for an academic license.

Configure your GitHub account:

1. Go to [Preferences] - [Version Control] - [GitHub].

2. Press [+], select Log in via GitHub, and follow the procedure.

Create a new project:

1. Press the [Get from VCS] button on the Welcome prompt.

2. Choose [GitHub] on the left menu, select the conversational-ai repository, and press [Clone] (make sure the directory name is conversational-ai).

Setup an interpreter:

1. Go to [Preferences] - [Project: conversational-ai] - [Project Interpreter].

2. Click Add Interpreter and select Add Local Interpreter.

3. In the prompted window, choose [Virtualenv Environment] on the left menu, configure as follows, then press [OK]:

   • Environment: New

   • Location: LOCAL_PATH/conversational-ai/venv

   • Base interpreter: Python 3.11

Install packages:

1. Open a terminal by clicking [Terminal] at the bottom (or go to [View] - [Terminal]).

2. Upgrade pip (if necessary) by entering the following command into the terminal:

   Copy

   python -m pip install --upgrade pip

3. Install the Emora State Transition Dialogue Manager (STDM) with the following command:

   Copy

   pip install emora_stdm

4. If the terminal prompts "Successfully installed ...", the packages are installed on your machine.

Task

1. Create a package called src under the conversational-ai directory.

2. Create the quiz package under the src package.

3. Create a python file called quiz0.py under the quiz package and copy the code:

from emora_stdm import DialogueFlow

transitions = {
    'state': 'start',
    '`Hello. How are you?`': {
        '[{good, fantastic}]': {
            '`Glad to hear that you are doing well :)`': {
                'error': {
                    '`See you later!`': 'end'
                }
            }
        },
        'error': {
            '`I hope your day gets better soon :(`': {
                'error': {
                    '`Take care!`': 'end'
                }
            }
        }
    }
}

df = DialogueFlow('start', end_state='end')
df.load_transitions(transitions)

if __name__ == '__main__':
    df.run()

4. Run quiz0 by clicking [Run] - [Run 'quiz0']. An alternative way of running the program is to click the green triangle by the line #26 and select Run 'quiz0':

5. Conduct the following two dialogues with the chatbot you just created (S: system, U: user):

S: Hello. How are you?
U: I'm good
S: Glad to hear that you are doing well :)
U: Thanks
S: See you later!
==========================================
S: Hello. How are you?
U: It's not going well
S: I hope your day gets better soon :(
U: Hopefully
S: Take care!

This is what your directory structure may look like in PyCharm after finishing this assignment:

Submission

1. Create the .gitignore file under the conversational-ai directory and copy the content:

.idea/
venv/

2. Add the following files to git by right-clicking on them and selecting [Git] - [Add]:

• quiz0.py

• .gitignore

3. Commit and push your changes to GitHub:

• Right-click on conversational-ai.

• Select [Git] - [Commit Directory].

• Enter a commit message (e.g., Submit Quiz 0).

• Press the [Commit and Push] button.

4. Check if the above files are properly pushed to your GitHub repository.

5. Submit the address of your repository to Canvas.