# Zespół nauczycieli oparty na AI: generowanie całego kursu z jednego promptu

> Kompletny przewodnik po generowaniu interaktywnych kursów edukacyjnych w OpenMAIC: wieloagentowe klasy, symulacje cyfrowe, eksport do PPTX/HTML oraz automatyzacja za pomocą Codex.

Stworzenie pełnoprawnego kursu edukacyjnego tradycyjnie wymaga skoordynowanej pracy zespołu specjalistów: metodyka do budowy programu, copywritera do tekstów, designera do slajdów, developera do interaktywnych ćwiczeń oraz wykładowcy do prowadzenia materiału. Platforma **OpenMAIC (Open Multi-Agent Interactive Classroom)** łączy cały ten cykl produkcyjny w jednym systemie wieloagentowym.

Wystarczy sformułować podstawowy temat lub załadować istniejące materiały (dokumenty, prezentacje, wideo), a zespół agentów AI samodzielnie zaprojektuje scenariusz pedagogiczny, wygeneruje multimedialne wykłady, skonfiguruje testy sprawdzające i stworzy interaktywne symulacje bezpośrednio w przeglądarce.

---

## 1. Czym jest OpenMAIC: koncepcja i kluczowe możliwości

OpenMAIC to otwarta platforma służąca do generowania i prowadzenia interaktywnych zajęć, wykorzystująca synergię autonomicznych agentów sztucznej inteligencji.

### 1.1. Różnica względem klasycznych generatorów prezentacji

W przeciwieństwie do serwisów tworzących jedynie statyczne slajdy lub długie konspekty tekstowe, OpenMAIC generuje pełnoprawną cyfrową klasę:
- **Środowisko wieloagentowe:** proces uczenia prowadzi kilka osobowości AI (wykładowca, asystent, wirtualni koledzy z klasy).
- **Synchroniczne wsparcie głosowe:** wbudowane algorytmy TTS komentują slajdy, zwracając uwagę na ważne wzory i wykresy za pomocą wirtualnego wskaźnika.
- **Interakcja dialogowa:** użytkownik może w dowolnym momencie zatrzymać wykład, zadać pytanie głosem lub tekstem i wziąć udział w dyskusji.
- **Wykonywanie kodu i symulacji:** moduły praktyczne działają bezpośrednio w interfejsie bez konieczności instalowania zewnętrznego oprogramowania.

### 1.2. Dostępne tryby architektoniczne tworzenia kursu

System oferuje dwa podejścia robocze w zależności od Twoich zadań:
1. **Classic Mode (Szybka generacja):** automatyczne tworzenie kursu w ciągu 1–3 minut na podstawie jednego promptu lub pakietu plików.
2. **Agent Workbench (Pro Mode):** iteracyjne projektowanie w dialogu z agentem-metodykiem, gdzie każdą scenę, test czy ilustrację można dopracowywać punktowo komendami.

---

## 2. Dwuetapowa architektura generowania kursu z jednego promptu

OpenMAIC wykorzystuje dwuetapowy potok przetwarzania zapytań, co gwarantuje spójność zamysłu pedagogicznego.

### 2.1. Etap 1: Formowanie struktury i planu pedagogicznego

Na początku sieć neuronowa analizuje temat lub pliki źródłowe, dzieląc dziedzinę przedmiotową na logiczne moduły zgodnie z zasadą „od prostego do złożonego”.

Przykład wyjściowego promptu:
```text
Stwórz kurs wprowadzający z zakresu edukacji finansowej dla początkujących.
Wymagania: 5 lekcji, od podstawowych terminów po tworzenie budżetu domowego.
Dodaj testy sprawdzające oraz zadania praktyczne do każdego modułu.
```

Na pierwszym etapie system tworzy mapę drogową:
1. Podstawy finansów osobistych i myślenia o pieniądzach.
2. Ewidencja dochodów, wydatków i ukrytych wycieków kapitału.
3. Budowanie osobistego budżetu miesięcznego.
4. Tworzenie poduszki bezpieczeństwa finansowego i ochrona oszczędności.
5. Końcowe interaktywne laboratorium ze stress-testowaniem budżetu.

### 2.2. Etap 2: Synteza scen edukacyjnych i treści interaktywnych

Po zatwierdzeniu planu system uruchamia równoległych agentów dla każdej sceny. Jeden moduł nie ogranicza się do zwykłego tekstu – jest dekomponowany na kadry wykładu, bloki pytań, skrypty programowe i ćwiczenia praktyczne.

---

## 3. Modułowe formaty treści edukacyjnej

OpenMAIC wspiera bogatą paletę formatów, które łączą się w jeden spójny tor nauki.

### 3.1. Slajdy multimedialne i wsparcie głosowe

Slajdy wykładowe zawierają sformatowany tekst, typografię, diagramy wektorowe, wzory matematyczne w formacie LaTeX oraz ilustracje. Wykładowca AI towarzyszy prezentacji żywym słowem, wyróżniając odpowiednie bloki markerem w czasie rzeczywistym.

### 3.2. Testy adaptacyjne i automatyczna weryfikacja wiedzy

Do kontroli przyswojenia materiału wbudowane są mechanizmy testowe:
- Pytania z wyborem jednej poprawnej odpowiedzi;
- Zadania z wielokrotnym wyborem opcji;
- Pytania otwarte z weryfikacją zgodności znaczeniowej odpowiedzi przez LLM.

### 3.3. Interaktywne sceny HTML i symulacje cyfrowe

Zamiast pasywnego czytania, uczeń wchodzi w interakcję z mini-aplikacjami opartymi na HTML5/JavaScript: dynamicznymi wykresami, modelami fizycznymi i symulatorami decyzji biznesowych.

### 3.4. Nauczanie projektowe (Project-Based Learning)

W trybie PBL student przyjmuje rolę specjalisty (np. dyrektora finansowego startupu lub analityka danych) i krok po kroku rozwiązuje kompleksowy problem aplikacyjny wraz z kolegami AI.

Typowa ścieżka przejścia lekcji w OpenMAIC:

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

---

## 4. Interakcja wieloagentowa: zespół wykładowców AI i kolegów z klasy

Kluczową przewagą platformy jest symulacja żywego środowiska społecznego wewnątrz wirtualnej klasy.

### 4.1. Formaty ról komunikacyjnych agentów w wirtualnej klasie

W zajęciach uczestniczy kilku autonomicznych agentów o różnych temperamentach i poziomach wiedzy:

| Rola agenta | Funkcjonalność w klasie | Wzorzec zachowania |
| :--- | :--- | :--- |
| **Główny wykładowca (Primary Instructor)** | Wyjaśnianie tematu, komentowanie slajdów głosem | Prowadzi zajęcia strukturalnie, dostosowuje tempo mowy |
| **Koledzy z klasy AI (AI Peers / Classmates)** | Udział w debatach, symulacja typowych błędów | Zadają pytania naprowadzające, ułatwiają zrozumienie nowicjuszom |
| **Ekspert-oponent (Debate Opponent)** | Generowanie alternatywnych punktów widzenia | Proponuje krytyczne kontrargumenty do dyskusji |
| **Asystent-tutor (Teaching Assistant)** | Wsparcie w blokach praktycznych | Udostępnia spersonalizowane wskazówki i analizuje kod |

Formaty zajęć obejmują **Classroom Discussion** (swobodna rozmowa grupy), **Roundtable Debate** (dyskusja ekspertów wokół kontrowersyjnego problemu) oraz **Q&A Mode** (indywidualne konsultacje podczas przerwy).

### 4.2. Wspólna interaktywna tablica (Whiteboard)

Agenci mają dostęp do wspólnej interaktywnej tablicy: mogą rysować diagramy powiązań, rozpisywać złożone równania matematyczne lub tworzyć schematy blokowe bezpośrednio podczas wykładu, wizualnie ilustrując tezy swojej narracji.

---

## 5. Tryb głębokiej interaktywności (Deep Interactive Mode)

Dla złożonych dyscyplin technicznych i przyrodniczych opracowano specjalny tryb Deep Interactive Mode.

### 5.1. 5 typów aplikacji interaktywnych

Tryb aktywuje generację pięciu kategorii obiektów aplikacyjnych:
1. **Wizualizacje 3D:** eksploracja modeli przestrzennych, związków molekularnych i węzłów inżynierskich.
2. **Symulacje fizyczne i ekonomiczne:** zmiana zmiennych wejściowych suwakami z natychmiastowym przeliczeniem wyniku.
3. **Minigry edukacyjne:** zgamifikowane mechaniki utrwalające poznane zasady lub wzory.
4. **Mapy myśli (Mind Maps):** wizualizacja powiązań między pojęciami w celu strukturyzacji pamięci.
5. **Wbudowana piaskownica kodu:** wykonywanie i debugowanie Python, JavaScript lub SQL bezpośrednio w przeglądarce.

### 5.2. Adaptacyjność i obsługa urządzeń

Wszystkie wygenerowane sceny interaktywne automatycznie dostosowują się do sterowania ekranem dotykowym na tabletach i smartfonach lub myszką i klawiaturą na desktopach.

---

## 6. Generowanie kursów na bazie własnych materiałów

OpenMAIC potrafi pracować nie tylko z abstrakcyjnymi promptami tekstowymi, ale także transformować korporacyjną bazę wiedzy w angażujący kurs.

### 6.1. Obsługiwane formaty: dokumenty, audio i wideo

Platforma akceptuje szeroki zakres plików wejściowych:
- Dokumenty: `PDF`, `DOCX`, `TXT`, `Markdown`.
- Dane tabelaryczne: `XLSX`, `CSV`.
- Prezentacje: `PPTX`.
- Multimedia: nagrania audio wykładów (`MP3`, `WAV`) oraz pliki wideo (`MP4`).

Dla materiałów wideo i audio system wykonuje automatyczną transkrypcję mowy oraz ekstrakcję kluczowych klatek wizualnych.

### 6.2. Praca z wydobywanym tekstem w Agent Workbench

W interfejsie Workbench dane wydobyte z dokumentów są przechowywane jako indeks semantyczny. Agent może odwoływać się do dokładnych cytatów z podręcznika, wyciągać oryginalne schematy i generować linki do stron źródłowych.

---

## 7. Porównanie trybów pracy: Classic Mode vs Agent Workbench

Wybór trybu pracy zależy od wymagań dotyczących głębokości opracowania i szybkości tworzenia materiałów:

| Kryterium | Classic Mode (Szybki) | Agent Workbench (Pro Mode) |
| :--- | :--- | :--- |
| **Szybkość generacji** | 1–3 minuty (pełny autopilot) | Krok po kroku w trybie żywego dialogu |
| **Głębokość customizacji** | Podstawowe ustawienia tematów i poziomów | Pełna zmiana każdej sceny, tekstu i dubbingu |
| **Wsparcie dla Skills** | Automatyczny uniwersalny pipeline | 20 wyspecjalizowanych Skills (Research, Code, Slides) |
| **Import mediów i PPTX** | Standardowe pliki statyczne | Interaktywne wyszukiwanie, przestawianie i przeprojektowywanie |
| **Zapisywanie sesji** | Jednorazowy wynik eksportu | Trwałe sesje na serwerze z historią edycji |

### 7.1. Szybki automatyczny pipeline (Classic Mode)

Nadaje się do tworzenia przeglądowych lekcji lub szybkiego testowania hipotez: użytkownik zadaje jeden prompt lub ładuje poradnik metodyczny, a system natychmiast tworzy gotową do przejścia klasę.

### 7.2. Środowisko dialogowe z 20 skills (Agent Workbench / Pro Mode)

W Pro Mode użytkownik komunikuje się z agentem jak z profesjonalnym producentem programów edukacyjnych:
```text
Dodaj dodatkową praktyczną lekcję przed testem końcowym.
Uprość sformułowanie prawa Ohma w trzecim rozdziale.
Zamień statyczny slajd na interaktywny schemat obwodu elektrycznego.
```

---

## 8. Opcje wdrożenia i uruchomienia platformy

OpenMAIC można uruchomić zarówno w środowisku chmurowym, jak i całkowicie na lokalnej infrastrukturze.

### 8.1. Użycie w chmurze (Hosted Mode)

Najprostsza opcja niewymagająca zasobów serwerowych: użytkownik otrzymuje osobisty Access Code w oficjalnym serwisie i podłącza go w aplikacji klienckiej.

### 8.2. Lokalny deployment na własnym serwerze (Self-Hosted)

Dla pełnej kontroli nad poufnością danych platformę można wdrożyć na własnym serwerze.

Wymagania systemowe:
- **Node.js:** wersja 22.19 lub wyższa;
- **Menedżer pakietów:** `pnpm` 10+;
- Klucz API co najmniej jednego obsługiwanego providera AI.

Kroki instalacji:

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

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

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

Otwórz plik `.env.local` i dodaj ważny klucz API:

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

Uruchom serwer deweloperski:

```bash
pnpm dev
```

Po pomyślnym starcie interfejs webowy OpenMAIC jest dostępny pod adresem lokalnym `http://localhost:3000`.

---

## 9. Integracja OpenMAIC przez Codex, OpenClaw i autonomicznych agentów

OpenMAIC wspiera otwarty standard **SKILL.md**, który pozwala zarządzać procesem tworzenia kursów bezpośrednio przez agentów AI developerów.

### 9.1. Wykorzystanie standardu SKILL.md w Codex i DeepSeek

Aby pracować w środowisku Codex, wystarczy zaimportować folder `skills/openmaic/` z repozytorium platformy. Agent automatycznie nauczy się orkiestrować OpenMAIC, wdrażać lokalny serwer i generować lekcje na podstawie krótkich podpowiedzi w czacie:

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

### 9.2. Wdrożenie w messengerach przez OpenClaw (Slack, Discord, Telegram)

W ekosystemie OpenClaw skill instaluje się jedną komendą terminalową:

```bash
clawhub install openmaic
```

Umożliwia to tworzenie kursów edukacyjnych, generowanie interakcji i udostępnianie gotowych linków bezpośrednio w roboczych czatach zespołów Slack, Discord czy Telegram.

---

## 10. Obsługiwane modele i rozkład obciążenia

OpenMAIC zapewnia pełną swobodę wyboru modeli i providerów sztucznej inteligencji, wspierając zarówno zamknięte API, jak i lokalne otwarte wagi.

### 10.1. Wybór optymalnych LLM do generowania treści

| Zadanie w OpenMAIC | Rekomendowany model | Zalety i cechy charakterystyczne |
| :--- | :--- | :--- |
| **Planowanie i design pedagogiczny** | Gemini 2.5 Pro / Claude 3.7 Sonnet | Wysoki poziom logicznego strukturyzowania złożonych tematów |
| **Szybka generacja slajdów** | Gemini 2.0 Flash / GPT-4o-mini | Maksymalna szybkość odpowiedzi przy minimalnym koszcie API |
| **Symulacje interaktywne i kod** | Claude 3.7 Sonnet / DeepSeek-V3 | Wysoka precyzja składni HTML5/JavaScript |
| **Synteza mowy (TTS)** | ElevenLabs / OpenAI TTS / Lemonade | Naturalne intonacje i wysoka ekspresja wykładowcy |

### 10.2. Architektura multimodelowa: specjalizacja według usług

Platforma pozwala jednocześnie korzystać z różnych providerów: podstawę tekstową może tworzyć DeepSeek lub Qwen, generację ilustracji realizować FLUX lub DALL-E 3, dubbing – ElevenLabs, a wyszukiwanie aktualnych faktów – Perplexity lub Tavily API.

---

## 11. Eksport i integracja gotowego kursu

Tworzone materiały nie pozostają zamknięte wewnątrz serwisu webowego – OpenMAIC wspiera cztery uniwersalne sposoby eksportu.

### 11.1. Edytowalny PowerPoint (.pptx)

Slajdy eksportowane są do pełnoprawnego pliku prezentacji z zachowaniem figur geometrycznych wektorowych, bloków tekstowych, wzorów i obrazów do dalszej ręcznej obróbki.

### 11.2. Autonomiczne strony interaktywne (Interactive HTML)

Złożone symulacje komputerowe i modele 3D zapisywane są jako samodzielne dokumenty webowe, które można otworzyć w dowolnej nowoczesnej przeglądarce bez dostępu do internetu.

### 11.3. Pełny archiwum kursu (Classroom ZIP)

Pakiet zawiera strukturę zajęć, pliki multimedialne, konspekty tekstowe i moduły interaktywne. Takie archiwum można przekazać innemu wykładowcy lub wgrać na inny serwer OpenMAIC.

### 11.4. Eksport wideo edukacyjnego (MP4)

Do tworzenia wykładów wideo wykorzystywana jest usługa renderingu w tle oparta na Chromium i FFmpeg, która nagrywa slajdy, ścieżki dźwiękowe i ruch wirtualnego wskaźnika w wysokiej rozdzielczości.

---

## 12. Praktyczny workflow krok po kroku: tworzymy kurs od zera

Rozważmy praktyczny algorytm generowania korporacyjnego minikursu.

### 12.1. Krok 1. Formułowanie docelowego promptu

Sformułuj szczegółowe zapytanie z uwzględnieniem roli, odbiorców i oczekiwanego rezultatu:

```text
[Rola]: Działaj jako wiodący korporacyjny trener wydajności.
[Zadanie]: Stwórz praktyczny kurs „Podstawy pracy z ChatGPT dla menedżerów projektowych”.
[Odbiorcy]: Liderzy zespołów bez wcześniejszego technicznego doświadczenia w zakresie AI.
[Zakres]: 5 skoncentrowanych modułów, od tworzenia promptów po optymalizację raportowania.
[Format]: Slajdy multimedialne, blok testowy na końcu każdego rozdziału oraz 1 interaktywna symulacja.
```

### 12.2. Krok 2. Walidacja i korekta struktury

Przejrzyj plan wygenerowany przez agenta. Jeśli niektóre tematy zostały pominięte, dodaj komendę korekcyjną:

```text
Dodaj lekcję dotyczącą weryfikacji faktów w odpowiedziach AI oraz wykrywania halucynacji, umieszczając ją między modułami 2 a 3.
```

### 12.3. Krok 3. Integracja materiałów źródłowych

Wgraj wewnętrzne dokumenty, instrukcje stanowiskowe lub prezentacje Twojej firmy i wskaż dyrektywę:

```text
Wykorzystaj załadowane regulaminy firmowe jako podstawę do praktycznych przypadków kursu.
```

### 12.4. Krok 4. Dialogowa obróbka przez agenta

Wprowadź punktowe zmiany w scenach edukacyjnych za pomocą Workbench:
- „Spraw, by wyjaśnienie w czwartej lekcji było bardziej zwięzłe”.
- „Zamień listę tekstową na tabelę porównawczą z wnioskami”.
- „Dodaj zadanie praktyczne dotyczące obliczania rentowności projektu”.

### 12.5. Krok 5. Przejście nauki i finalny eksport

Przetestuj gotowy kurs w trybie wirtualnej klasy: odsłuchaj ścieżkę audio, odpowiedz na pytania kontrolne i pobierz finalny `.pptx` lub `Classroom ZIP` do dystrybucji wśród współpracowników.

---

## 13. Najczęściej zadawane pytania i rekomendacje (FAQ)

### 13.1. Praktyczne odpowiedzi na częste pytania dotyczące OpenMAIC

> [!NOTE]
> **Czy do lokalnego uruchomienia OpenMAIC potrzebna jest mocna dedykowana karta graficzna?**  
> Nie, pod warunkiem korzystania z chmurowych API (OpenAI, Gemini, Anthropic) do generowania tekstu i obrazów, lokalny serwer OpenMAIC wymaga jedynie standardowego środowiska Node.js i zużywa minimum pamięci RAM (do 512 MB).

> [!TIP]
> **Jak zminimalizować koszty tokenów przy projektowaniu dużych programów edukacyjnych?**  
> Stosuj schemat dwustopniowy: do pierwotnego planowania i strukturyzacji kursu podłączaj wysokointeligentny model flagowy (Gemini 2.5 Pro lub Claude 3.7 Sonnet), a generację poszczególnych slajdów i tekstów pomocniczych deleguj ekonomicznym szybkim modelom typu Gemini 2.0 Flash lub GPT-4o-mini.

> [!IMPORTANT]
> **Jakie ograniczenia obowiązują dla rozmiaru ładowanych materiałów wideo?**  
> Przy analizie długich nagrań wideo zaleca się wcześniejsze dzielenie wykładów na fragmenty tematyczne o długości do 20–30 minut. Zapobiega to przepełnieniu okna kontekstowego modeli językowych i istotnie zwiększa precyzję cytowania faktów.

> [!WARNING]
> **Wymagania zasobowe dla eksportu kursu do formatu wideo MP4**  
> W odróżnieniu od lekkiego eksportu do PowerPoint czy HTML, generacja pełnoprawnego pliku wideo wymaga wdrożenia usługi renderingu w tle z obsługą akceleracji sprzętowej Chromium i FFmpeg. Na tanich VPS bez dedykowanych rdzeni rendering wideo może zajmować znaczną ilość czasu.