---
title: AI Examiner Agent
emoji: 📝
colorFrom: blue
colorTo: green
sdk: gradio
sdk_version: "4.0.0"
app_file: app.py
pinned: false
---

# AI Examiner Agent

Міні-екзаменатор (LLM-агент з tools): питає ім’я та email, обирає 2–3 теми, веде короткий діалог по темах, виставляє оцінку (0..10) та зберігає історію іспиту у файли.

## Функціонал

- Збір **name + email**
- Tool `start_exam(email, name) -> list[str]`:
  - перевіряє, чи є студент у `data/students.json`
  - обирає 2–3 теми з `data/topics.json`
  - створює сесію у `data/sessions.json`
- Tool `get_next_topic() -> str`:
  - повертає наступну тему з черги сесії
- Tool `end_exam(email, score, history)`:
  - зберігає результат у `data/results.json`
  - `history` зберігається у форматі `{role, content, datetime}`

## Структура проєкту

```text
.
├── app.py
├── agent.py
├── llm.py
├── tools.py
├── requirements.txt
└── data
    ├── students.json
    ├── topics.json
    ├── sessions.json
    └── results.json
```