> ## 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.

# AI Analysis

> Automatic session results analysis by artificial intelligence

## What is AI Analysis?

**AI Analysis** automatically analyzes completed quiz session results and generates:

* Statistical summary
* Difficult question identification
* Answer pattern analysis
* Recommendations for the host

<Info>
  AI Analysis uses artificial intelligence to draw insights that are difficult to see in raw data.
</Info>

## How to run analysis

<Steps>
  <Step title="Go to reports">
    Open **Reports** in the navigation menu.
  </Step>

  <Step title="Select completed session">
    Find the session you want to analyze.
  </Step>

  <Step title="Click AI button">
    Click the robot icon next to the session.
  </Step>

  <Step title="Wait for analysis">
    Generation usually takes 10-30 seconds.
  </Step>

  <Step title="Review results">
    Analysis will display on the page. You can download PDF.
  </Step>
</Steps>

## What analysis contains

### Statistical summary

| Metric                    | Description                          |
| ------------------------- | ------------------------------------ |
| **Pass rate**             | % of participants with 50%+ score    |
| **Average score**         | Average points of all                |
| **Average response time** | Per question                         |
| **Score distribution**    | Excellent/Good/Average/Below average |

### Difficult question analysis

For each difficult question:

* Question content
* Success rate (% correct)
* Most common wrong answers
* Possible problems with question
* Improvement suggestions

### Easy question analysis

* Questions with high % correct
* Suggestions for increasing difficulty

### Time analysis

| Element                   | Description                        |
| ------------------------- | ---------------------------------- |
| Average time per question | In seconds                         |
| Fastest question          | Which and how many seconds         |
| Slowest question          | Which and how many seconds         |
| Time-score correlation    | Did faster responders score better |

### Pattern detection

AI identifies concerning patterns:

| Pattern             | What it means                      |
| ------------------- | ---------------------------------- |
| **Rushing**         | Very fast answers without thinking |
| **Guessing**        | Random answer patterns             |
| **Repeated errors** | Many people make the same mistake  |

### Participant analysis

* **Top performers** - their strengths
* **Participants needing support** - weaknesses and suggestions

### Recommendations

AI generates three categories of recommendations:

1. **Quiz improvements** - specific changes to questions
2. **Teaching tips** - topics requiring attention
3. **Next steps** - actions for the host

## Export to PDF

You can download the generated analysis as PDF:

1. Click **"Download PDF"** in the top right corner
2. File will be downloaded

Filename: `analysis-YYYY-MM-DD-{quiz_name}.pdf`

## Costs and limits

AI analysis consumes tokens. Check your limits in **Settings** → **AI**.

<Warning>
  Analysis is most valuable for sessions with **>10 participants**. For smaller groups, results may be less reliable.
</Warning>

## Best practices

<Tip>
  * Run analysis for larger groups (10+ people)
  * Implement recommendations in future quizzes
  * Pay attention to difficult questions
  * Compare analyses between sessions
</Tip>

<Warning>
  AI Analysis is a supporting tool. Always verify conclusions and adapt to your group's context.
</Warning>

## Next steps

<CardGroup cols={2}>
  <Card title="PDF Export" icon="file-pdf" href="/en/reports/pdf-export">
    Traditional PDF reports
  </Card>

  <Card title="Excel Export" icon="file-excel" href="/en/reports/excel-export">
    Data for your own analysis
  </Card>
</CardGroup>