# Команда вчителів на базі ШІ: генеруємо цілий курс із одного промпту

> Повний посібник із генерації інтерактивних навчальних курсів в OpenMAIC: мультиагентні класи, цифрові симуляції, експорт у PPTX/HTML та автоматизація через Codex.

Створення повноцінного навчального курсу традиційно вимагає координованої роботи команди фахівців: методолога для побудови програми, копірайтера для текстів, дизайнера для слайдів, розробника для інтерактивних вправ і викладача для начитки матеріалу. Платформа **OpenMAIC (Open Multi-Agent Interactive Classroom)** об'єднує весь цей виробничий цикл в єдиній мультиагентній системі.

Достатньо сформулювати базову тему або завантажити наявні матеріали (документи, презентації, відео), і команда ШІ-агентів самостійно спроєктує педагогічний сценарій, синтезує мультимедійні лекції, налаштує перевірочні тести та створить інтерактивні симуляції прямо в браузері.

---

## 1. Що таке OpenMAIC: концепція та ключові можливості

OpenMAIC — це відкрита платформа для генерації та проведення інтерактивних занять, що використовує синергію автономних агентів штучного інтелекту.

### 1.1. Відмінність від класичних генераторів презентацій

На відміну від сервісів, які просто створюють статичні слайди або довгі текстові конспекти, OpenMAIC генерує повноцінний цифровий клас:
- **Мультиагентне середовище:** навчальний процес ведуть декілька ШІ-персон (викладач, асистент, віртуальні однокласники).
- **Синхронний голосовий супровід:** вбудовані алгоритми TTS коментують слайди, акцентуючи увагу на важливих формулах і графіках за допомогою віртуального вказівника.
- **Діалогова взаємодія:** користувач може в будь-який момент зупинити лекцію, поставити питання голосом або текстом і взяти участь у дискусії.
- **Виконання коду та симуляцій:** практичні модулі працюють прямо в інтерфейсі без необхідності встановлювати сторонній софт.

### 1.2. Доступні архітектурні режими створення курсу

Система пропонує два робочих підходи залежно від ваших задач:
1. **Classic Mode (Швидка генерація):** автоматичне створення курсу за 1–3 хвилини на основі одного промпту або пакета файлів.
2. **Agent Workbench (Pro Mode):** ітеративне проєктування в діалозі з агентом-методологом, де кожну сцену, тест чи ілюстрацію можна доопрацьовувати точковими командами.

---

## 2. Двоетапна архітектура генерації курсу з одного промпту

OpenMAIC використовує двоетапний конвеєр обробки запиту, що гарантує цілісність педагогічного задуму.

### 2.1. Етап 1: Формування структури та педагогічного плану

Спочатку нейромережа аналізує тему або первинні файли, розбиваючи предметну область на логічні модулі за принципом «від простого до складного».

Приклад вихідного промпту:
```text
Створи вступний курс із фінансової грамотності для новачків.
Вимоги: 5 уроків від базових термінів до складання сімейного бюджету.
Додай перевірочні тести та практичні завдання до кожного модуля.
```

На першому етапі система формує дорожню карту:
1. Основи особистих фінансів та грошового мислення.
2. Облік доходів, витрат і прихованих витоків капіталу.
3. Побудова персонального місячного бюджету.
4. Формування фінансової подушки безпеки та захист заощаджень.
5. Підсумковий інтерактивний практикум зі стрес-тестування бюджету.

### 2.2. Етап 2: Синтез навчальних сцен та інтерактивного змісту

Після затвердження плану система запускає паралельні агенти для кожної сцени. Один модуль не обмежується простим текстом — він декомпозується на кадри лекції, блоки запитань, програмні скрипти та практичні вправи.

---

## 3. Модульні формати навчального контенту

OpenMAIC підтримує багату палітру форматів, які поєднуються в єдиний послідовний навчальний трек.

### 3.1. Мультимедійні слайди та голосовий супровід

Лекційні слайди включають розмічений текст, типографіку, векторні діаграми, математичні формули у форматі LaTeX та ілюстрації. Викладач ШІ супроводжує показ живою мовою, виділяючи відповідні блоки маркером у реальному часі.

### 3.2. Адаптивні тести та автоматична перевірка знань

Для контролю засвоєння матеріалу вбудовані тестові механізми:
- Питання з вибором однієї правильної відповіді;
- Завдання з множинним вибором варіантів;
- Відкриті питання з перевіркою смислової відповідності відповіді через LLM.

### 3.3. Інтерактивні HTML-сцени та цифрові симуляції

Замість пасивного читання учень взаємодіє з міні-застосунками на HTML5/JavaScript: динамічними графіками, фізичними моделями та симуляторами бізнес-рішень.

### 3.4. Проєктне навчання (Project-Based Learning)

У режимі PBL студент бере на себе роль фахівця (наприклад, фінансового директора стартапу або дата-аналітика) і крок за кроком вирішує комплексну прикладну проблему разом зі штучними колегами.

Типовий маршрут проходження уроку в OpenMAIC:

```mermaid
flowchart TD
    Intro["1. Теоретичний вступ"] --> Slides["2. Мультимедійні слайди з ШІ-голосом"]
    Slides --> Quiz["3. Контрольний квіз / Тест"]
    Quiz --> Sim["4. Інтерактивна симуляція / HTML-практика"]
    Sim --> Debate["5. Групове обговорення з ШІ-студентами"]
    Debate --> Project["6. Підсумковий практичний проєкт"]
```

---

## 4. Мультиагентна взаємодія: команда ШІ-викладачів та однокласників

Ключова перевага платформи — імітація живого соціального середовища всередині віртуального класу.

### 4.1. Рольові формати спілкування агентів у віртуальному класі

У занятті беруть участь кілька автономних агентів із різними темпераментами та рівнем знань:

| Роль агента | Функціонал у класі | Поведінковий патерн |
| :--- | :--- | :--- |
| **Головний лектор (Primary Instructor)** | Пояснення теми, коментування слайдів голосом | Викладає структуровано, адаптує темп мовлення |
| **ШІ-однокласники (AI Peers / Classmates)** | Участь у дебатах, моделювання типових помилок | Задають навідні питання, полегшують розуміння новачкам |
| **Експерт-опонент (Debate Opponent)** | Генерація альтернативних точок зору | Пропонує критичні контраргументи для дискусії |
| **Тьютор-асистент (Teaching Assistant)** | Підтримка у практичних блоках | Надає персоналізовані підказки та розбирає код |

Формати занять включають **Classroom Discussion** (вільна бесіда групи), **Roundtable Debate** (дискусія експертів навколо спірної проблеми) та **Q&A Mode** (індивідуальні консультації під час паузи).

### 4.2. Спільна інтерактивна дошка (Whiteboard)

Агенти мають доступ до спільної інтерактивної дошки: вони можуть креслити діаграми зв'язків, розписувати складні математичні рівняння або складати блок-схеми прямо під час лекції, наочно ілюструючи тези своєї розповіді.

---

## 5. Режим глибокої інтерактивності (Deep Interactive Mode)

Для складних технічних і природничих дисциплін розроблено спеціальний режим Deep Interactive Mode.

### 5.1. 5 типів прикладного інтерактивного контенту

Режим активує генерацію п'яти категорій прикладних об'єктів:
1. **3D-візуалізації:** дослідження просторових моделей, молекулярних сполук та інженерних вузлів.
2. **Фізичні та економічні симуляції:** зміна вхідних змінних повзунками з миттєвим перерахунком результату.
3. **Освітні міні-ігри:** гейміфіковані механіки для закріплення пройдених правил чи формул.
4. **Інтелект-карти (Mind Maps):** візуалізація зв'язків між поняттями для структурування пам'яті.
5. **Вбудована пісочниця коду:** виконання та дебагінг Python, JavaScript або SQL прямо в браузері.

### 5.2. Адаптивність та підтримка пристроїв

Усі згенеровані інтерактивні сцени автоматично адаптуються під керування сенсорним екраном на планшетах і смартфонах або мишею та клавіатурою на десктопах.

---

## 6. Генерація курсів на базі власних матеріалів

OpenMAIC здатний працювати не лише з абстрактними текстовими промптами, але й трансформувати корпоративну базу знань у захопливий курс.

### 6.1. Підтримувані формати: документи, аудіо та відео

Платформа приймає широкий перелік вхідних файлів:
- Документи: `PDF`, `DOCX`, `TXT`, `Markdown`.
- Табличні дані: `XLSX`, `CSV`.
- Презентації: `PPTX`.
- Мультимедіа: аудіозаписи лекцій (`MP3`, `WAV`) та відеофайли (`MP4`).

Для відео- та аудіоматеріалів система виконує автоматичну транскрипцію мовлення та вилучення ключових візуальних кадрів.

### 6.2. Робота з вилученим текстом в Agent Workbench

В інтерфейсі Workbench вилучені з документів дані зберігаються у вигляді семантичного індексу. Агент може посилатися на точні цитати з підручника, витягувати оригінальні схеми та формувати посилання на сторінки першоджерела.

---

## 7. Порівняння режимів роботи: Classic Mode проти Agent Workbench

Вибір режиму роботи залежить від вимог до глибини опрацювання та швидкості створення матеріалів:

| Критерій | Classic Mode (Швидкий) | Agent Workbench (Pro Mode) |
| :--- | :--- | :--- |
| **Швидкість генерації** | 1–3 хвилини (повний автопілот) | Покроково в режимі живого діалогу |
| **Глибина кастомізації** | Базові налаштування тем і рівнів | Повна зміна кожної сцени, тексту та озвучки |
| **Підтримка скілів** | Автоматичний універсальний пайплайн | 20 спеціалізованих Skills (Research, Code, Slides) |
| **Імпорт медіа та PPTX** | Стандартні статичні файли | Інтерактивний пошук, перестановка та перемальовка |
| **Збереження сесій** | Одноразовий результат експорту | Персистентні сесії на сервері з історією правок |

### 7.1. Швидкий автоматичний пайплайн (Classic Mode)

Підходить для створення оглядових уроків або швидкого тестування гіпотез: користувач задає один промпт або завантажує методичку, а система відразу створює готовий для проходження клас.

### 7.2. Діалогове середовище з 20 скілами (Agent Workbench / Pro Mode)

У Pro Mode користувач спілкується з агентом як із професійним продюсером освітніх програм:
```text
Додай додатковий практичний урок перед фінальним тестом.
Спрости формулювання закону Ома у третьому розділі.
Заміни статичний слайд на інтерактивну схему електричного кола.
```

---

## 8. Варіанти розгортання та запуск платформи

OpenMAIC можна запустити як у хмарному середовищі, так і повністю на локальній інфраструктурі.

### 8.1. Хмарне використання (Hosted Mode)

Найпростіший варіант, що не потребує серверних ресурсів: користувач отримує персональний Access Code на офіційному сервісі та підключає його в клієнтському застосунку.

### 8.2. Локальне розгортання на власному сервері (Self-Hosted)

Для повного контролю за конфіденційністю даних платформу можна розгорнути на власному сервері.

Системні вимоги:
- **Node.js:** версія 22.19 або вище;
- **Менеджер пакетів:** `pnpm` 10+;
- Ключ API хоча б одного підтримуваного провайдера ШІ.

Кроки встановлення:

```bash
# Клонування репозиторію та перехід у каталог проєкту
git clone https://github.com/THU-MAIC/OpenMAIC.git
cd OpenMAIC

# Встановлення залежностей
pnpm install

# Налаштування конфігурації оточення
cp .env.example .env.local
```

Відкрийте файл `.env.local` та додайте валідний API-ключ:

```bash
OPENAI_API_KEY="sk-proj-your-secret-key"
```

Запустіть сервер розробки:

```bash
pnpm dev
```

Після успішного старту вебінтерфейс OpenMAIC доступний за локальною адресою `http://localhost:3000`.

---

## 9. Інтеграція OpenMAIC через Codex, OpenClaw та автономних агентів

OpenMAIC підтримує відкритий стандарт **SKILL.md**, що дозволяє керувати процесом створення курсів прямо через AI-агентів розробника.

### 9.1. Використання стандарту SKILL.md у Codex та DeepSeek

Для роботи в середовищі Codex достатньо імпортувати теку `skills/openmaic/` з репозиторію платформи. Агент автоматично навчиться оркеструвати OpenMAIC, розгортати локальний сервер і генерувати уроки за короткими підказками в чаті:

```text
Teach me quantum physics in an interactive OpenMAIC classroom
```

### 9.2. Розгортання в месенджерах через OpenClaw (Slack, Discord, Telegram)

В екосистемі OpenClaw скіл інсталюється однією термінальною командою:

```bash
clawhub install openmaic
```

Це дозволяє створювати навчальні курси, генерувати інтерактиви та ділитися готовими посиланнями прямо в робочих чатах команди Slack, Discord чи Telegram.

---

## 10. Підтримувані моделі та розподіл навантаження

OpenMAIC забезпечує повну свободу вибору моделей та провайдерів штучного інтелекту, підтримуючи як закриті API, так і локальні відкриті ваги.

### 10.1. Вибір оптимальних LLM для генерації контенту

| Завдання в OpenMAIC | Рекомендована модель | Переваги та особливості |
| :--- | :--- | :--- |
| **Планування та педагогічний дизайн** | Gemini 2.5 Pro / Claude 3.7 Sonnet | Високий рівень логічного структурування складних тем |
| **Швидка генерація слайдів** | Gemini 2.0 Flash / GPT-4o-mini | Максимальна швидкість відгуку за мінімальної вартості API |
| **Інтерактивні симуляції та код** | Claude 3.7 Sonnet / DeepSeek-V3 | Висока точність синтаксису HTML5/JavaScript |
| **Синтез мовлення (TTS)** | ElevenLabs / OpenAI TTS / Lemonade | Природні інтонації та висока виразність викладача |

### 10.2. Мультимодельна архітектура: спеціалізація за сервісами

Платформа дозволяє одночасно задіяти різні провайдери: текстову основу може формувати DeepSeek або Qwen, генерацію ілюстрацій виконувати FLUX або DALL-E 3, озвучення — ElevenLabs, а пошук оновлених фактів — Perplexity або Tavily API.

---

## 11. Експорт та інтеграція готового курсу

Створені матеріали не залишаються замкненими всередині вебсервісу — OpenMAIC підтримує чотири універсальні способи експорту.

### 11.1. Редагований PowerPoint (.pptx)

Слайди експортуються у повноцінний файл презентації зі збереженням векторних геометричних фігур, текстових блоків, формул і зображень для подальшого ручного доопрацювання.

### 11.2. Автономні інтерактивні сторінки (Interactive HTML)

Складні комп'ютерні симуляції та 3D-моделі зберігаються як самостійні вебдокументи, які можна відкрити в будь-якому сучасному браузері без доступу до інтернету.

### 11.3. Повний архів курсу (Classroom ZIP)

Пакет містить структуру занять, мультимедійні файли, текстові конспекти та інтерактивні модулі. Такий архів можна передати іншому викладачеві або завантажити на інший сервер OpenMAIC.

### 11.4. Експорт навчального відео (MP4)

Для створення відеолекцій використовується фоновий сервіс рендерингу на базі Chromium та FFmpeg, який записує слайди, голосові доріжки та рух віртуального вказівника у високій роздільній здатності.

---

## 12. Покроковий практичний воркфлоу: створюємо курс із нуля

Розглянемо практичний алгоритм генерації корпоративного міні-курсу.

### 12.1. Крок 1. Формулювання цільового промпту

Сформулюйте детальний запит із зазначенням ролі, аудиторії та бажаного результату:

```text
[Role]: Діє як провідний корпоративний тренер з продуктивності.
[Task]: Створи практичний курс «Основи роботи з ChatGPT для проєктних менеджерів».
[Audience]: Керівники команд без попереднього технічного бекграунду в ШІ.
[Scope]: 5 концентрованих модулів від складання промптів до оптимізації звітності.
[Format]: Мультимедійні слайди, тестовий блок наприкінці кожного розділу та 1 інтерактивна симуляція.
```

### 12.2. Крок 2. Валідація та коригування структури

Перегляньте згенерований агентом план. Якщо деякі теми пропущені, додайте команду на корекцію:

```text
Додай між 2 і 3 модулями урок щодо фактчекінгу відповідей ШІ та виявлення галюцинацій.
```

### 12.3. Крок 3. Інтеграція первинних матеріалів

Завантажте внутрішні документи, посадові інструкції або презентації вашої компанії та вкажіть директиву:

```text
Використай завантажені регламенти компанії як основу для практичних кейсів курсу.
```

### 12.4. Крок 4. Діалогове доопрацювання через агента

Внесіть точкові правки в навчальні сцени за допомогою Workbench:
- «Зроби пояснення у четвертому уроці більш лаконічним».
- «Заміни текстовий перелік на порівняльну таблицю з висновками».
- «Додай практичну задачу на розрахунок рентабельності проєкту».

### 12.5. Крок 5. Проходження навчання та фінальний експорт

Протестуйте готовий курс у режимі віртуального класу: прослухайте аудіоряд, дайте відповіді на контрольні запитання та вивантажте фінальний `.pptx` або `Classroom ZIP` для дистрибуції серед колег.

---

## 13. Поширені запитання та рекомендації (FAQ)

### 13.1. Практичні відповіді на часті питання щодо OpenMAIC

> [!NOTE]
> **Чи потрібна потужна дискретна відеокарта для локального запуску OpenMAIC?**  
> Ні, за умови використання хмарних API (OpenAI, Gemini, Anthropic) для генерації тексту та зображень локальний сервер OpenMAIC вимагає лише стандартного середовища Node.js і споживає мінімум оперативної пам'яті (до 512 МБ RAM).

> [!TIP]
> **Як мінімізувати витрати токенів при проєктуванні великих навчальних програм?**  
> Використовуйте двоступеневу схему: для первинного планування та структури курсу підключайте високоінтелектуальну флагманську модель (Gemini 2.5 Pro або Claude 3.7 Sonnet), а генерацію окремих слайдів і допоміжних текстів делегуйте економічним швидким моделям на кшталт Gemini 2.0 Flash або GPT-4o-mini.

> [!IMPORTANT]
> **Які обмеження діють на розмір завантажуваних навчальних відеоматеріалів?**  
> При аналізі тривалих відеозаписів рекомендується попередньо розбивати лекції на тематичні фрагменти тривалістю до 20–30 хвилин. Це запобігає переповненню контекстного вікна мовних моделей і суттєво підвищує точність цитування фактів.

> [!WARNING]
> **Вимоги до ресурсів для експорту курсу у формат MP4-відео**  
> На відміну від легкого експорту у PowerPoint чи HTML, генерація повноцінного відеофайлу вимагає розгортання фонового render-service із підтримкою апаратного прискорення Chromium і FFmpeg. На бюджетних VPS без виділених ядер рендеринг відео може займати значний час.