> ## Documentation Index
> Fetch the complete documentation index at: https://docs.heyquiz.pro/llms.txt
> Use this file to discover all available pages before exploring further.

# Generator AI

> Automatyczne tworzenie quizów za pomocą sztucznej inteligencji

## Co to jest Generator AI?

**Generator AI** pozwala automatycznie tworzyć quizy na podstawie:

* Tematu podanego tekstem
* Przesłanego dokumentu (PDF, DOC, PPT)
* Istniejących materiałów edukacyjnych

<Info>
  AI generuje pytania, odpowiedzi i oznacza poprawne opcje - Ty tylko przeglądasz i dostosowujesz.
</Info>

## Jak używać generatora

<Steps>
  <Step title="Otwórz generator">
    Przejdź do **Moje quizy** → **Utwórz quiz** → **Generator AI**.
  </Step>

  <Step title="Wybierz źródło">
    * **Temat** - wpisz temat quizu
    * **Dokument** - prześlij plik
  </Step>

  <Step title="Skonfiguruj parametry">
    Liczba pytań, typy pytań, poziom trudności.
  </Step>

  <Step title="Wygeneruj">
    Kliknij **"Generuj"** i poczekaj na wyniki.
  </Step>

  <Step title="Przejrzyj i edytuj">
    Sprawdź wygenerowane pytania, popraw jeśli trzeba.
  </Step>
</Steps>

## Generowanie z tematu

Wpisz temat, np.:

* "Historia Polski XX wieku"
* "Podstawy programowania w Python"
* "Marketing w mediach społecznościowych"

### Parametry

| Parametr             | Opis                                         |
| -------------------- | -------------------------------------------- |
| **Liczba pytań**     | 5-50 pytań                                   |
| **Typy pytań**       | Jednokrotny, wielokrotny, prawda/fałsz, etc. |
| **Poziom trudności** | Łatwy, średni, trudny                        |
| **Język**            | Polski lub angielski                         |

<Tip>
  Im bardziej szczegółowy temat, tym lepsze pytania. Zamiast "historia" napisz "przyczyny II wojny światowej".
</Tip>

## Generowanie z dokumentu

Prześlij dokument, a AI wyciągnie z niego pytania:

### Obsługiwane formaty

| Format       | Opis               |
| ------------ | ------------------ |
| **PDF**      | Dokumenty tekstowe |
| **DOC/DOCX** | Microsoft Word     |
| **PPT/PPTX** | PowerPoint         |

### Limity plików

* Maksymalny rozmiar: **10 MB**
* Maksymalna liczba stron: **50**

<Info>
  AI analizuje tekst z dokumentu - zdjęcia i wykresy nie są przetwarzane.
</Info>

## Obsługiwane typy pytań

Generator może tworzyć:

<Check>
  * Jednokrotny wybór
  * Wielokrotny wybór
  * Prawda/Fałsz
  * Uzupełnij lukę
  * Dopasuj
  * Uporządkuj
</Check>

<Warning>
  Pytania typu "Zgłoś się", "Ankieta" i "Pytanie otwarte" nie są generowane automatycznie.
</Warning>

## Jakość generowanych pytań

### Co AI robi dobrze

* Tworzenie pytań faktograficznych
* Różnicowanie odpowiedzi
* Zachowanie spójności językowej

### Co wymaga sprawdzenia

* Poprawność merytoryczna (szczególnie daty, liczby)
* Jednoznaczność odpowiedzi
* Poziom trudności

<Warning>
  **Zawsze sprawdzaj wygenerowane pytania!** AI może popełniać błędy merytoryczne.
</Warning>

## Edycja po generowaniu

Po wygenerowaniu możesz:

* ✏️ Edytować treść pytań
* ➕ Dodawać/usuwać odpowiedzi
* ✅ Zmieniać poprawne odpowiedzi
* ⏱️ Dostosować czas i punkty
* 🗑️ Usuwać niepotrzebne pytania

## Koszty i limity

Generowanie AI zużywa tokeny. Sprawdź swoje limity w **Ustawienia** → **AI**.

| Element          | Opis                                 |
| ---------------- | ------------------------------------ |
| Zużycie tokenów  | Zależne od długości tekstu/dokumentu |
| Miesięczny limit | Ustawiony przez administratora       |
| Własny klucz API | Możliwość użycia własnego budżetu    |

## Następne kroki

<CardGroup cols={2}>
  <Card title="Z dokumentu" icon="file-import" href="/pl/ai/z-dokumentu">
    Szczegóły generowania z plików
  </Card>

  <Card title="Ustawienia AI" icon="gear" href="/pl/ai/ustawienia">
    Konfiguracja AI i limity
  </Card>
</CardGroup>
