mirror of https://github.com/MODSetter/SurfSense.git synced 2026-07-20 23:21:06 +02:00

google-labs-jules[bot] f5ea337b75 feat: Implement Alison AI Classroom IT Support Assistant

This commit introduces Alison, an AI-powered classroom IT support assistant, as a new module within the SurfSense application.

Key features of this implementation include:

- A new LangGraph-based agent for conversational troubleshooting.
- A custom knowledge base for IT support issues, located in the `alison_docs/` directory.
- An extension of the RAG pipeline to use Alison's knowledge base.
- Role-aware responses for professors and proctors.
- A configuration toggle to enable or disable the Alison module.
- Documentation for setting up and using Alison.

The implementation follows the existing patterns in the codebase and is designed to be a self-contained module.

Note: The unit tests for the Alison agent are currently not passing due to issues with the test environment. Further work is needed to get the tests to run correctly.

2025-09-09 20:55:21 +00:00

2.6 KiB

Raw Blame History

Alison - AI Classroom IT Support Assistant

Alison is an AI-powered classroom IT support assistant that helps professors and proctors troubleshoot common technology issues in the classroom. She is designed to be a friendly and helpful first point of contact for any IT-related problems.

Key Features

Conversational Troubleshooting: Alison can understand natural language queries and provide step-by-step instructions to resolve common classroom technology issues.
Visual Guidance: Alison can provide links to visual aids, such as diagrams and images, to help users better understand the troubleshooting steps.
Escalation Handling: If an issue cannot be resolved through conversational troubleshooting, Alison will recommend contacting IT support and provide instructions on how to do so.
Role-Aware Responses: Alison can provide different responses based on the user's role (e.g., professor or proctor).

Enabling and Disabling Alison

Alison can be enabled or disabled through a configuration toggle in the NU Chatbot interface. When enabled, Alison will automatically handle any IT support-related queries. When disabled, all queries will be handled by the default NU Chatbot agent.

Example Conversation Flows

Example 1: Projector Not Working (Resolved)

User (Professor): "My projector is not working. I can't get it to turn on."

Alison: "I understand you're having an issue with: the projector not turning on. Here are some steps you can try:

Check Power Cable: Ensure the projector's power cable is securely plugged into both the projector and a working power outlet.
Test Outlet: Plug another device into the same outlet to confirm it's receiving power.
Use PowerButton: Try turning on the projector using the physical power button on the unit itself, in case the remote's batteries are dead.

Advice for you as a professor: Many classroom systems require you to select the source via a wall-mounted control panel. Please check for a control panel and select the correct input.

You can also refer to this visual guide: Image: Diagram of projector ports and cable connections"

Example 2: Zoom Not Starting (Escalated)

User (Proctor): "Zoom is not starting on the classroom computer."

Alison: "I understand you're having an issue with: Zoom not starting. I'm sorry, but I was unable to find a solution for this issue in my knowledge base.

Please contact IT support for further assistance. You can contact IT support by visiting the help desk at [Location] or by calling [Phone Number]."

2.6 KiB Raw Blame History