# Guided Mode

<iframe width="560" height="315" src="https://www.youtube.com/embed/txmcwbxPsOs" 
title="YouTube video player" frameborder="0" allowfullscreen></iframe>

## Description

Guided Mode turns an agent chat into an interactive lesson engine that teaches, quizzes, and reinforces concepts automatically. Administrators link a course to an agent, choose a guide style—Spaced Repetition, Instruction Mode, or Socratic Mode—and Agentic OS takes over, presenting material, asking questions, and revisiting topics until mastery is reached. Meanwhile, administrators receive detailed analytics on every question‑and‑answer cycle to pinpoint learning gaps and celebrate user progress.



![](/images/guidedmode.png)

---

## Target Audience

**User**

---

## Features

#### Course‑to‑Agent Linking

Connect any course (e.g., Engineering Computations) to an existing agent with just a few clicks in the Admin Panel.

#### Three Guide Styles

- **Spaced Repetition** – repeats quiz questions until answered correctly, optimizing retention  
- **Instruction Mode** – teaches a concept, then immediately checks understanding with a follow‑up question  
- **Socratic Mode** – drives step‑by‑step dialogue, prompting deeper reflection and self‑explanation

#### Dynamic Learner Prompts

The agent adapts prompts on the fly—e.g.,  
> “Can you explain loops in Python?” → “Quiz me on loops.”  
—based on each learner’s performance.

#### Automated Mastery Tracking

Every attempt, repetition count, and review interval is logged, giving a precise picture of concept mastery over time.

#### Administrator Dashboards

View the exact questions asked, how many times they repeated, last/next review timestamps, and which student/agent/course they belong to.

---

## How to Use (step by step)

#### Connect a Course to an Agent

- In the **Admin Panel**, open **Memory Component Settings**  
- Choose the target course (e.g., **Engineering Computations**)  
- Link it to an existing agent (e.g., **Engineering Comp Agent**)  
- Select a **Catalog Guide**—typically the same course content

#### Pick a Guide Style

- Choose **Spaced Repetition**, **Instruction Mode**, or **Socratic Mode**  
- *(Demo‑ready setup: Spaced Repetition + Instruction Mode)*

#### Launch Learner Session

- Users open the agent chat and type **“Start lesson.”**  
- The agent explains a topic, then poses a question  
- Incorrect answers trigger future repetitions (**Spaced Repetition**) until the learner answers correctly

#### Observe Adaptive Prompts

Guided prompts evolve with learner progress, e.g.,

- “Can you explain loops in Python?”  
- “Quiz me on loops.”

#### Review Administrator Insights

In the Admin dashboard, inspect logs showing:

- Exact question text  
- Repetition count and interval spacing  
- Last/next review times  
- Linked user, agent, and course

#### Iterate & Refine

- Use analytics to **spot learning gaps**  
- Adjust guide style or content as needed for **better outcomes**

---

## Pedagogical Use Cases

#### Mastery‑Based Quizzing

Combine **Spaced Repetition** with course quizzes to ensure users answer correctly multiple times over increasing intervals—cementing long‑term retention.

#### Micro‑Lessons with Immediate Checks

Use **Instruction Mode** to present a short explanation (e.g., Python loops), then instantly ask a question to verify understanding.

#### Socratic Dialogues for Critical Thinking

Activate **Socratic Mode** in philosophy or ethics courses to guide users through reasoned arguments via probing questions.

#### Personalized Remediation

Learners who miss key questions get automatic repeats at spaced intervals, allowing struggling users to catch up without manual administrator intervention.

#### Data‑Driven Course Adjustments

Administrators analyze repetition logs to identify common pain points—then add resources or adjust lectures where many users falter.

---

By linking courses, selecting a guide style, and reviewing the built‑in analytics, **Guided Mode** empowers administrators to deliver **adaptive, evidence‑based instruction**—while learners enjoy an **engaging, feedback‑rich chat experience** that drives true concept mastery.

