---
title: CLAS Basic Interaction Exercise
emoji: 📚
colorFrom: red
colorTo: indigo
sdk: docker
app_file: app.py
pinned: false
license: lgpl-3.0
---

# *CLAS Basic Interaction Exercise*

The Basic Interaction Exercise is web-based Chat interface where students interact with the chatbot that has had the instructor-designed prompt given to it but they cannot see the prompt. At the end of the conversation, entire convo is made available as downloadable JSON such that students can download it and turn it in to Brightspace. Ideated by Jesse Blocher (Ph.D.).

# How to Run the App

1. To clone the space, toggle on the three dots at the top right of the interface and click "Duplicate this space."
2. In the pop-up, input secret values for PIPLOC, OPEN_AI_KEY, and SECRET_PROMPT. These values will not be visible after this step.

# How to Use the App

### Instructors

1. Navigate to the "Instructor Only" page.
2. Upload a .txt or .py file with prompt and verify prompt content OR type prompt content directly.
3. Press the "Submit" button to initialize tutor.

### Students

1. Navigate to the "For Students" page.
2. Type something into the user input box, and click the "Ask/answer model" button. The chatbot will respond to your message.
3. Repeat step 1 until interaction is complete.
4. Click the "View your chat history" button to view chat history of whole interaction.
5. Under "Export Your Chat History," click the "JSON," "TXT," or "CSV" button to export your chat history in the respective downloaded file type.

# How to Modify the App

1. To modify the app, navigate to the "Files" page.
2. Open the file named "app.py," and click the green "contribute" button above the code.
3. Make desired modifications.
4. Under "Propose changes", type a message to submit with your pull request.
5. Add extended description, if desired.
6. Click the "Open a Pull Request" button.