В этой статье вы узнаете, как пользоваться разделом сайта Блоги и создавать опросы, квизы и тесты теста вручную, а также генерацию черновика через AI с базой знаний (RAG) и редактирование существующего теста. Примеры URL приведены для языка ru; вместо ru может стоять другой код языка.
Создание Квиза - хорошее подспорье в вашей работе с учениками, средстов контроля и усвоения материала в процессе обучение. Наличие квизов в вашей базе поможет упростить вашу работу и переложить часть контроля на нашу систему. Тесты у нас бесплатны и доступны пользователям, в зависимости от того - как вы настроили его. Они могут быть публичными или только для вашей группы учеников. Для зарегистрированного пользователя сохраняется вся статистика по квизу - количество прохождений, ошибки, прогресс. Все это доступно в личном кабинете пользователя.
Кто может создавать тесты: администраторы и менторы. Остальным страница создания показывает заголовок «Доступ Запрещен».
Содержание:
- 1. Где находится создание теста
- 2. Поля формы создания
- 3. Ручное добавление вопросов
- 4. AI-генерация черновика через базу знаний (RAG)
- 4.1. Подготовить базу знаний
- 4.2. Закрепить блоки
- 4.3. Заполнить параметры генерации
- 4.4. Настройки поиска RAG
- 4.5. Как написать хороший промпт
- 4.6. Сгенерировать черновик
- 5. Перенести черновик в форму создания
- 6. Редактировать существующий тест
- 7. Частые вопросы
1. Где находится создание теста
| Страница | Путь | Что здесь |
|---|---|---|
| Список тестов | /ru/quizzes |
Общий список тестов |
| Мои тесты | /ru/quizzes/my-quizzes |
Заголовок «Мои тесты». Кнопка «Создать тест» (только для администраторов и менторов) и иконка карандаша у каждого теста |
| Создание | /ru/quizzes/create |
Заголовок «Создать Новый Тест» |
| Редактирование | /ru/quizzes/<id>/edit |
Заголовок «Редактировать тест». <id> — номер теста |
Путь: откройте «Мои тесты», нажмите «Создать тест».
На странице создания справа вверху есть кнопка «AI-помощник». Она открывает боковую панель «AI-помощник квиза». Ручное создание работает без неё.
2. Поля формы создания
Блок «Информация о Тесте»
| Поле | Обязательно | Что вводить |
|---|---|---|
| Название Теста * | Да | Название, которое увидят ученики. На сервере от 1 до 255 символов |
| Описание | Нет | Краткое пояснение, что проверяет тест |
| Статус | Нет | Черновик, Опубликован, Архив. По умолчанию выбран «Опубликован». Если тест ещё не готов, выберите «Черновик» |
| Тип Доступа | Нет | Публичный (по умолчанию), Только зарегистрированные, Платный, По подписке, Приватный |
| Привязка к предмету (опционально) | Нет | Список ваших предметов. По умолчанию «Без привязки к предмету». Если предмет выбран, результат теста записывается в дневник ученика |
| Автоматически рекомендовать этот квиз после подтверждённого бронирования | Нет | Галочка. Тест будет предлагаться ученику после подтверждённого занятия |
Языка в форме создания нет. Язык теста берётся из языка страницы (/ru/... — ru).
Блок «Режим Анти-Чит»
- Галочка «Включить анти-чит для этого квиза» открывает настройки.
- Два метода включены всегда и отмечены как обязательные: «Контроль фокуса окна» и «Блокировка dev tools».
- Лимит предупреждений — число от 1 до 10, по умолчанию 3.
Параметры, которых нет в форме
Эти значения на странице создания задаются автоматически и изменить их нельзя: результат показывается в режиме итоговой сводки, проходной балл 70, попыток 3, правильные ответы показываются, порядок вопросов не перемешивается.
Кнопки внизу
- «Создать Тест» сохраняет тест. После успеха появляется сообщение «Тест успешно создан!», затем открывается список тестов.
- «Отмена» возвращает к списку без сохранения.
При ошибке сервера появляется окно с текстом ошибки.
3. Ручное добавление вопросов
На странице сразу есть один пустой вопрос. Новые вопросы добавляются кнопкой «Добавить Вопрос». Вопросы нумеруются автоматически: «Вопрос 1», «Вопрос 2» и так далее.
Для каждого вопроса заполните:
- Текст Вопроса * — обязательное поле. Над полем есть вкладки с символами: «Математика», «Программирование», «Химия» и «Аб Формат». Вкладка «Аб Формат» добавляет надстрочные и подстрочные символы к выделенному тексту.
- Ссылка на Изображение (опционально) — вставьте ссылку или нажмите «Загрузить изображение» и выберите файл. Под полем появится превью.
- Тип Вопроса * — два варианта:
- «Один Правильный Ответ»: варианты выбираются переключателями, верный один;
- «Несколько Правильных Ответов»: варианты выбираются флажками, верных может быть несколько.
- Варианты Ответов * — по умолчанию создаются два варианта. Добавляйте новые кнопкой «Добавить Ответ». Текст каждого варианта обязателен. Отметьте чекбокс «Правильный» у верных вариантов.
Удалить вопрос можно кнопкой «Удалить» в заголовке вопроса.
Хотя бы один вопрос обязателен. Без вопросов форма выдаст сообщение «Пожалуйста, добавьте хотя бы один вопрос».
Импорт и экспорт вопросов
- «Экспорт» скачивает вопросы в файл
quiz-questions-ГГГГ-ММ-ДД.json. Если вопросов нет, появится сообщение «Нет вопросов для экспорта». - «Импорт» загружает JSON-файл с массивом вопросов. Если файл не массив, появится сообщение «Неверный формат файла. Ожидается массив вопросов.»
- Импорт заменяет все вопросы в форме. Сохраните нужные вопросы через «Экспорт» перед импортом.
Импорт и экспорт затрагивают только вопросы. Название, описание и настройки теста не меняются.
4. AI-генерация черновика через базу знаний (RAG)
AI-помощник создаёт черновик: название, описание и вопросы с вариантами ответов. Черновик не сохраняется сам. Его нужно проверить и перенести в форму.
4.1. Подготовить базу знаний
Модель опирается на ваши материалы: конспекты, учебные пособия, задания. Из панели AI-помощника есть две ссылки, которые открываются в новой вкладке:
- «Загрузить базу знаний» — страница загрузки документов;
- «Мои документы» — список загруженных документов.
4.2. Закрепить блоки (источники из базы знаний)
Блок «Источники из базы знаний» работает так:
- Нажмите «Выбрать блоки». Откроется окно «Выберите блоки базы знаний».
- Внутри окна доступны:
- «Фильтр по теме» — фильтр по теме;
- «Поиск по содержимому» — поиск по тексту, теме или названию документа;
- «Обновить» — обновить список;
- «Показать ещё блоки» — подгрузить следующие блоки;
- «Снять все отметки» — очистить выбор;
- «Готово» — закрыть окно.
- Можно закрепить до 20 блоков. Счётчик показывает «Выбрано N из 20 блоков».
Пока блоки не выбраны, блок показывает «Пока источники не выбраны».
Закреплённые блоки передаются модели напрямую и не отсеиваются автоматическим поиском. Закрепляйте только материалы, на которых должны строиться вопросы и правильные ответы. Остальной контекст RAG подберёт сам.
4.3. Заполнить параметры генерации
| Поле | Значение по умолчанию | Что делает |
|---|---|---|
| Что нужно создать | пусто | Описание задачи. Обязательно: без текста появится сообщение «Опишите, какой тест нужно создать.» |
| LLM модель | «— системная по умолчанию —» | Модель для генерации. Список моделей берётся из системы |
| Язык | Русский | Язык вопросов: English, Русский, Беларуская, Polski, Українська |
| Сложность | beginner |
beginner, intermediate или advanced |
| Тема (подсказка) | пусто | Короткая подсказка о предмете. Необязательна |
| Вопросов | 5 | От 1 до 20 |
4.4. Настройки поиска RAG
Блок «Настройки поиска RAG»:
- RAG — использовать вашу базу знаний. Включено по умолчанию.
- Гибридный поиск — поиск по смыслу и по тексту вместе. Включено по умолчанию.
- Rerank — повторная сортировка найденных фрагментов по релевантности. Включено по умолчанию.
- Порог — минимальная степень совпадения фрагмента с запросом, от 0 до 1 с шагом 0.05. По умолчанию 0.50. Чем выше значение, тем строже отбор. В подсказке порог назван «минимальным cosine similarity».
- Фрагментов — сколько фрагментов передать модели, от 1 до 20. По умолчанию 5.
- Поиск в интернете — выключено по умолчанию. Поисковый backend: DuckDuckGo или LiteLLM web search (модель генерации). Вариант LiteLLM использует выбранную модель, которая должна поддерживать веб-поиск, и может тарифицироваться отдельно. Веб-источники показываются отдельным блоком.
4.5. Как написать хороший промпт
В промпте полезно указать:
- аудиторию — для кого тест (junior-разработчики, ученики 9 класса, студенты первого курса);
- цель — что проверяем (знание терминов, умение решать задачи, понимание причин ошибок);
- объём и формат — сколько вопросов и какого типа;
- источник — на какой материал опираться (закрепите блоки или назовите раздел);
- ограничения — чего не нужно (например, «без вопросов на запоминание дат»).
Примеры:
Создай тест для junior-разработчиков. Проверь понимание операций над Python-последовательностями: срезы, сортировка, работа со списками и кортежами. Опирайся на закреплённые блоки.
Тест для учеников 9 класса по теме «Линейные уравнения». Задания простые, с целыми числами в ответах. Вопросы с одним правильным ответом.
Тест по SQL для аналитиков среднего уровня: JOIN, GROUP BY, оконные функции. Варианты ответов должны быть похожи друг на друга, чтобы проверять понимание, а не угадывание.
Черновик от модели всегда проверяйте: ответы могут быть неточными.
4.6. Сгенерировать черновик
- Нажмите «Сгенерировать». Во время запроса кнопка блокируется, показывается индикатор загрузки.
- При успехе появится сообщение «Черновик готов. Нажмите «Применить».». В блоке «Предпросмотр черновика» будут название, описание и вопросы. Верные варианты помечены
[верный], остальные[вариант]. - Блок «Техническая диагностика RAG» свёрнут по умолчанию. Он показывает использованные фрагменты и нужен для отладки.
При ошибке показывается сообщение с текстом ошибки из ответа сервера.
5. Перенести черновик в форму создания
- Нажмите «Применить». Кнопка активна только после успешной генерации.
- Название, описание, статус и тип доступа из черновика записываются в форму.
- Если в черновике есть вопросы, все текущие вопросы в форме заменяются вопросами из черновика. Если вопросов в черновике нет, текущие вопросы остаются.
- Появится сообщение «Черновик применен. Проверьте данные и создайте тест.»
Черновик ещё не сохранён. Перед сохранением проверьте:
- правильно ли отмечены верные ответы;
- соответствуют ли формулировки и сложность аудитории;
- статус и тип доступа;
- при необходимости привязку к предмету и анти-чит.
Чтобы тест появился в системе, нажмите «Создать Тест».
«Очистить» сбрасывает промпт, выбор блоков, черновик и предпросмотр. Вопросы в форме не меняются.
6. Редактировать существующий тест
- Откройте «Мои тесты».
- Нажмите иконку карандаша «Редактировать» у нужного теста.
- Откроется страница «Редактировать тест» (
/ru/quizzes/<id>/edit).
Отличия от страницы создания:
- AI-помощника нет. Для нового черновика создайте новый тест;
- поле «Язык» есть и заполнено текущим значением теста;
- в поле «Статус» те же варианты: «Черновик», «Опубликован», «Архив». Текущий статус выбран;
- настройки проходного балла, попыток и порядка вопросов сохраняются из теста, их не сбрасывает значение по умолчанию;
- вопросы, анти-чит, импорт и экспорт работают так же, как при создании. Изображения к вопросам загружаются так же.
Кнопка «Сохранить изменения» отправляет данные. При успехе появится сообщение «Изменения сохранены.», и откроется список тестов. При ошибке появится сообщение «Не удалось сохранить изменения. Проверьте данные и попробуйте снова.». Кнопка «Отмена» возвращает без сохранения.
7. Частые вопросы
Ученики не видят тест. Проверьте статус. Тест в статусе «Черновик» или «Архив» по названию статуса не опубликован. Также проверьте тип доступа.
Кнопка «Создать тест» не видна. Кнопка доступна только администраторам и менторам.
После «Применить» пропали вопросы. Импорт и применение черновика заменяют вопросы в форме. Сохраняйте нужные вопросы через «Экспорт» заранее.
Вопросы не по теме. Закрепите нужные блоки из базы знаний, уточните промпт и тему либо включите RAG.