# Команда ИИ-преподавателей: генерируем интерактивный курс из одного промпта

> Полное руководство по генерации интерактивных курсов в 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. Мультиагентное взаимодействие: команда ИИ-преподавателей и одноклассников

Главное преимущество OpenMAIC — моделирование живой социальной атмосферы внутри виртуального класса.

### 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**, позволяя ИИ-агентам разработчика напрямую управлять процессом создания курсов.

### 9.1. Использование стандарта SKILL.md в Codex и DeepSeek

В среде Codex достаточно импортировать папку `skills/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 | Высокая скорость инференса при минимальной стоимости токенов |
| **Интерактивные симуляции и код** | Claude 3.7 Sonnet / DeepSeek-V3 | Высокая точность генерации кода HTML5/JavaScript |
| **Синтез речи (TTS)** | ElevenLabs / OpenAI TTS / Lemonade | Естественная дикция и высокая выразительность речи |

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

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

---

## 11. Экспорт и распространение готового курса

Сгенерированные материалы можно экспортировать в четырех универсальных форматах.

### 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:
- «Сделай объяснение в четвертом уроке более лаконичным».
- «Замени текстовый список на сравнительную таблицу преимуществ и недостатков».
- «Добавь расчетную симуляцию рентабельности инвестиций (ROI)».

### 12.5. Шаг 5. Прохождение обучения и финальный экспорт

Протестируйте созданный класс: послушайте озвучку, ответьте на вопросы квизов и выгрузите презентацию `.pptx` или архив `Classroom ZIP` для распространения.

---

## 13. Часто задаваемые вопросы и рекомендации (FAQ)

### 13.1. Практические ответы на частые вопросы по работе с OpenMAIC

> [!NOTE]
> **Требуется ли мощная дискретная видеокарта для локального запуска OpenMAIC?**  
> Нет. При использовании облачных API (OpenAI, Gemini, Anthropic) для генерации текста и графики сервер OpenMAIC работает на стандартном Node.js и потребляет менее 512 МБ оперативной памяти.

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

> [!IMPORTANT]
> **Какие рекомендации действуют при загрузке длинных видеозаписей?**  
> Перед загрузкой часовых лекций разделите их на смысловые фрагменты по 20–30 минут. Это предотвратит перегрузку контекстного окна модели и повысит точность извлечения фактов.

> [!WARNING]
> **Требования к ресурсам при экспорте курса в видеоформат MP4**  
> В отличие от быстрого экспорта в PPTX или HTML, рендеринг видео требует запуска службы с Chromium и FFmpeg. На недорогих серверах без выделенных ядер процессора компиляция видео может потребовать значительного времени.