AI Tutor — Moodle Local Plugin

This plugin is part of the LearningOps suite by Highskills and more. https://www.highskills.co.il/

AI Tutor adds a per-course chat widget that answers student questions grounded only in that course's own content. Answers stream back in real time with inline citations to the exact page, chapter, forum post or file they came from, a "connects the dots" list of related material, and — when a student appears to be stuck — a set of practice problems.

Teachers additionally get an Insights page showing struggle patterns (which topics students get stuck on, and who) and content gaps (questions the course content couldn't answer).

To get your activation endpoint and API key, please complete the setup process here.

• Moodle 4.4 or later
• PHP 8.x with the extensions curl, zip, and mbstring.
• Access to the AI Private Tutor service (provided by Highskills and more).

1. Copy or clone this repository into your Moodle install, renaming the folder to drop the local_ prefix:

   <moodle_root>/local/ai_tutor/
   

   <clipboard-copy aria-label="Copy code to clipboard" class="ClipboardButton btn btn-invisible js-clipboard-copy m-2 p-0 d-flex flex-justify-center flex-items-center" data-copy-feedback="Copied!" data-tooltip-direction="w" value="<moodle_root>/local/ai_tutor/" tabindex="0" role="button"> </clipboard-copy>

2. Log in as a site administrator and go to Site administration → Notifications to run the install.

Go to Site administration → Plugins → Local plugins → AI Tutor.

Open a course's Settings page. Under the course custom fields there is an Enable AI Tutor checkbox (visible to teachers, unchecked by default). Checking it and saving:

• Makes the chat widget appear on that course's pages (for any user with the local/ai_tutor:use capability).
• Adds the course to the Rebuild AI Tutor course content cache scheduled task, which re-harvests enabled courses every 30 minutes (Site administration → Server → Scheduled tasks).
• The first chat message on a freshly enabled course triggers a one-off synchronous harvest, so the widget works immediately without waiting for the schedule.

Users who can view insights get an AI Tutor Insights link in the course administration navigation (/local/ai_tutor/insights.php?courseid=…). It shows, over a rolling 30-day window:

• Struggle patterns — topics where students got stuck, with the named students per topic.
• Content gaps — out-of-scope questions the course content couldn't answer, grouped by a simple text normalization.

Adjust access at Site administration → Users → Permissions → Define roles.

On the first message of a chat session the plugin sends a plain-text snapshot of the course. It harvests these module types:

• Pages, labels, book chapters, wiki pages
• File attachments in File and Folder resources (text pre-extracted — see below)
• Forum posts (subject + message)
• Assignment descriptions only
• Quiz question text and general feedback for fixed (non-random) slots only
• Glossary entries, database (mod_data) records, lesson pages
• SCORM and H5P activities — intro/description only in v1

Hard rules:

• Plain text only — HTML is stripped before sending.
• No student personal data, ever — no submissions, no grades, no individual quiz attempts.

Files in File/Folder resources are extracted to plain text before being sent:

Any other extension is skipped.

• Real-time streamed answers over Server-Sent Events, with a live "thinking" indicator
• Inline citations such as [C1:high] / [C1:medium] linking back to the source in Moodle, with a model-self-reported confidence hint
• Connects the dots — related course material for the current question
• Practice problems generated automatically when the student appears stuck
• Teacher Insights — struggle patterns and content gaps, built from local data
• Configurable widget corner (site-wide setting)
• Hebrew (RTL) language pack included

GNU General Public License v3 or later — see https://www.gnu.org/licenses/gpl-3.0.html.