Помощь
Learning Copilot помогает планировать подготовку, хранить материалы и отслеживать готовность к учебной цели. Основная навигация находится в верхней части экрана:
- Проекты — учебные цели, этапы, задачи и показатели готовности;
- Материалы — библиотеки, папки и файлы;
- API-ключи — ключи для интеграций;
- Документация — эта справка и описание REST API.
Вход
- На стартовой странице нажмите Продолжить.
- В окне Keycloak введите данные учётной записи.
- После входа выберите нужный раздел в верхнем меню.
- Для управления профилем нажмите значок профиля справа в шапке. Профиль открывается в новой вкладке.
Если срок сессии закончился, приложение попросит войти снова. Повторный вход не удаляет созданные проекты и материалы.
Проекты
Создание проекта
- Откройте Проекты.
- Нажмите Новый проект.
- Заполните обязательное поле Название. Максимальная длина — 40 символов.
- При необходимости добавьте Описание, Дедлайн, Приоритет и Направление.
- Нажмите Создать проект в открывшейся форме.
Доступные значения приоритета: Низкий, Обычный, Высокий. Дедлайн можно оставить пустым, но заполненная дата должна быть корректной.
В списке проектов нажмите Настройки политик, чтобы открыть общие правила агрегации, затухания, калибровки, рекомендаций и рисков. Карточка проекта открывается кнопкой Открыть.
Просмотр и настройка
- Выберите карточку проекта в списке.
- На странице проекта ознакомьтесь с показателями Охват, Текущая готовность, Риск проекта и Дедлайн.
- Чтобы изменить название, описание, дедлайн или приоритет, откройте Настройки проекта.
- Для изменения правил расчёта используйте раздел Политики. Сохраняйте каждый блок после изменения его порогов, весов или периода затухания.
В настройках также можно приостановить, активировать или архивировать проект. Удаление находится в зоне опасных действий и всегда требует подтверждения.
Метрики проекта
Показатели проекта помогают понять не только текущий результат, но и то, насколько он устойчив во времени:
| Показатель | Как считается | Зачем нужен |
|---|---|---|
| Охват | Среднее значение охвата активных этапов с учётом их срочности. Охват этапа — среднее значение охвата его активных задач. Охват задачи — сумма освоения блоков с их весами. | Показывает, какая часть учебного содержания уже освоена без учёта давности последней проверки. |
| Текущая готовность | Взвешенное среднее готовности активных этапов. Готовность этапа — взвешенное среднее готовности задач. Готовность задачи — сумма освоения каждого блока, умноженного на его вес и коэффициент актуальности. | Показывает, насколько результат можно считать актуальным прямо сейчас. |
| Риск проекта | Самый высокий уровень риска среди активных этапов. Риск этапа определяется самым высоким риском его задач. | Не маскирует критичную задачу средним значением и подсказывает, где требуется внимание. |
| Дедлайн | Дата, указанная при создании или редактировании проекта. | Ограничивает горизонт подготовки и влияет на вес срочных этапов и задач. |
Все процентные показатели находятся в диапазоне от 0 до 100. Если у задачи нет оценки блока, его готовность не получает актуального подтверждения, поэтому новые оценки особенно важны для достоверного результата.
Актуальность и затухание готовности
Готовность уменьшается со временем после последней оценки, даже если исходный уровень освоения не изменился. Это позволяет отличить давно выученный материал от результата, подтверждённого недавно. Используются следующие периоды полуснижения актуальности:
- Понимание — 120 часов;
- Практика — 96 часов;
- Запоминание — 72 часа.
Через такой период коэффициент актуальности становится примерно в два раза меньше. Поэтому Охват может оставаться высоким, а Текущая готовность снижаться: это сигнал повторить оценку или заняться материалом.
Периоды затухания можно изменить в блоке Затухание знаний в общих настройках политик или в настройках конкретного проекта. Значение задаётся в часах и должно быть больше нуля. Настройка проекта имеет приоритет над личной, а если она не задана, используется личная настройка. По умолчанию используются 120 часов для понимания, 72 часа для запоминания и 96 часов для практики.
Для интеграций доступны PATCH /projects/policies/decay и PATCH /projects/{id}/policies/decay с телом вида:
{
"policy": {
"comprehension_half_life_hours": 120,
"memorization_half_life_hours": 72,
"practice_half_life_hours": 96
}
}Правила агрегации
В разделе Настройки политик блок Агрегация определяет, какие элементы сильнее влияют на итог проекта:
- вес приоритета: низкий —
0,8, обычный —1,0, высокий —1,2; - вес срочности: дедлайн в пределах 7 дней —
1,1, 72 часов —1,2, 24 часов —1,3; - для этапов и задач без близкого дедлайна используется базовый вес
1,0.
Итоговые показатели являются взвешенными средними: задача или этап с высоким приоритетом и близким дедлайном сильнее влияет на результат, чем обычная задача без срочного срока. Это не меняет сами оценки, а помогает системе сфокусировать внимание на наиболее важных элементах.
Правила рисков
Блок Риски задаёт пороги, по которым система выделяет проблемы:
- для готовности задачи: ниже
35— критический, ниже55— высокий, ниже75— средний, от75— низкий; - для каждого блока дополнительно учитывается освоение: по умолчанию пороги составляют
40,55и70; - если блок ещё ни разу не оценивался, его риск считается критическим;
- большой разрыв между уверенностью пользователя и нормализованным результатом отмечается как возможная ложная уверенность. По умолчанию порог —
25баллов.
Пороговые значения должны идти от критического к среднему и могут быть изменены в допустимом диапазоне 0–100. При повышении порога система будет раньше предупреждать о риске; при снижении — предупреждений станет меньше.
Правила рекомендаций
Блок Рекомендации определяет, когда и сколько подсказок показывать:
- освоение ниже
60считается низким; - значение от
65считается приемлемым; - разрыв калибровки от
25баллов требует отдельного внимания; - количество рекомендаций можно установить от 1 до 10.
Рекомендации учитывают слабые блоки понимания, запоминания и практики, уровень риска и близость дедлайна. Например, для низкого запоминания система предложит повторение и проверку через 24 часа, а для низкой практики — последовательность практических задач и разбор ошибок.
Калибровка и влияние самооценки
Блок Калибровка сравнивает уверенность пользователя с фактическим результатом проверки. Если разрыв достигает установленного порога, система рекомендует калибровочную сессию. Множитель штрафа уменьшает влияние самооценки при таком расхождении; значение по умолчанию — 0,7.
Калибровка нужна, чтобы высокая субъективная уверенность не скрывала низкий результат проверки и не завышала итоговую готовность.
Как использовать метрики
- Начните с блока Риск проекта и списка Критично для дедлайна.
- Откройте задачи с высоким или критическим риском.
- Проверьте, какой блок слабее: понимание, запоминание или практика.
- Выполните рекомендацию и запишите новую оценку.
- Обновите статус или запустите пересчёт готовности.
- Сравните Охват и Текущую готовность: если охват выше готовности, материал освоен, но оценка устарела или близок дедлайн; если оба показателя низкие, требуется системная работа с задачами.
Этапы
- Откройте проект и перейдите в Этапы.
- Нажмите Новый этап.
- Укажите Название, Цель, Порядок и, если нужно, Дедлайн.
- Нажмите Создать этап в открывшейся форме.
- Откройте карточку этапа, чтобы увидеть его доску и список задач.
Порядок этапа начинается с 1. Этап можно изменить, приостановить, активировать, архивировать или удалить. Удаление выполняется только после явного подтверждения.
Чтобы быстро найти этап, введите часть названия или цели в поле поиска. Дополнительно можно отфильтровать этапы по статусу (Все статусы, Активные, Приостановленные, Архивные) и уровню риска.
Задачи
Создание и редактирование
- Откройте нужный этап.
- Нажмите Новая задача.
- Заполните Ожидаемый результат, Сложность от 1 до 10, Приоритет, при необходимости Дедлайн.
- Распределите задачу по полям Части понимания, Части запоминания и Части практики. Укажите хотя бы одну часть.
- Нажмите Создать задачу.
Чтобы изменить задачу, откройте её карточку и выберите редактирование. В форме можно изменить ожидаемый результат, сложность, приоритет, дедлайн и веса контекстов, затем нажмите Сохранить изменения. Для закрытия формы без сохранения нажмите Отмена.
Из карточки задачи доступны просмотр деталей, редактирование, удаление, изменение статуса и отметка Готова к экзамену. Архивные задачи не исчезают безвозвратно: их статус можно увидеть в данных проекта.
Статусы задачи
Статус показывает текущий этап работы:
В очереди → Изучение → Базовый уровень пройден → Стабильная → Готова к экзамену.
Статус В зоне риска используется для задачи с повышенным риском, а Архивные — для архивированных задач. Переход выполняется из карточки задачи; выбирайте следующий статус, соответствующий фактическому состоянию подготовки.
В списке задач доступны поиск по ожидаемому результату и фильтры по статусу, уровню риска и приоритету. Если задача не отображается, сначала сбросьте фильтры через вариант Все.
Оценка готовности
- Откройте задачу и нажмите Записать оценку.
- В поле Ограниченный контекст выберите Понимание, Запоминание или Практика.
- Укажите источник оценки: диалог, мини-кейс, внешняя система или ручное подтверждение.
- Заполните значения оценки и уверенности в диапазоне от 0 до 100.
- Сохраните оценку.
В окне Изменить веса контекстов можно настроить Части понимания, Части запоминания и Части практики. Под полями сразу отображаются рассчитанные проценты. Общая сумма частей должна быть больше нуля; отрицательные и нечисловые значения недопустимы. Нажмите Сохранить веса или Отмена. После изменения оценки или весов используйте Обновить статус, если показатель не обновился автоматически.
Дашборд проекта показывает Охват, Текущую готовность, Риск проекта, дедлайн и блок Критично для дедлайна. Внутри блока отображаются критичные элементы, которые сильнее всего влияют на достижение цели.
На странице задачи также доступны Рекомендации, прогноз снижения готовности и последние оценки. После изменения исходных данных повторите генерацию рекомендаций или пересчёт готовности.
Материалы
Библиотеки
- Откройте Материалы.
- На вкладке Мои библиотеки нажмите Новая библиотека.
- Укажите название и описание, затем выберите видимость библиотеки.
- Для приватной библиотеки настройте доступ пользователей с ролями Чтение или Запись.
- Нажмите Создать библиотеку в открывшейся форме и откройте карточку через Открыть.
Публичную библиотеку можно добавить в свои материалы, поставить или убрать звезду и отменить подписку. Собственную библиотеку можно изменить или удалить. Удаление библиотеки требует подтверждения.
На вкладке Мои библиотеки можно отфильтровать библиотеки по видимости (Все, Публичные, Приватные), периоду изменения и сортировке. На вкладке Глобальные доступны поиск по названию, описанию или владельцу, сортировка по новым библиотекам или популярности, кнопки Добавить к себе и звезда. Каталог загружается постранично при прокрутке.
Файлы и папки
- Откройте библиотеку и перейдите в Дерево файлов.
- Нажмите Создать папку, чтобы добавить каталог.
- Нажмите Загрузить файл и выберите файл. Для загрузки нужен доступ Запись.
- Выберите файл или папку, чтобы открыть информацию и доступные действия.
- Используйте кнопки Переименовать, Копировать, Вырезать, Вставить, Удалить или Скачать.
Для перехода по структуре используйте цепочку root и названия папок. Кнопка Информация показывает тип, дату изменения, размер и MIME-тип файла. Скачать доступна только для выбранного файла; для папки сначала откройте её содержимое.
Хранилище не ограничивает загрузку заранее заданным списком типов файлов: MIME-тип сохраняется как техническая информация о файле и не используется для функций RAG. Имя файла может содержать до 255 символов, включая Unicode, пробелы, точки, скобки и распространённые специальные символы. Нельзя использовать только пустое имя, имена . и .., управляющие символы или разделители пути / и \. Это нужно только для корректного хранения файла, а не для ограничения учебных форматов.
Размер одного файла не должен превышать 500 МБ.
Операции с большими файлами выполняются по частям. В баннере отображается процент и имя файла. До завершения можно нажать Отменить загрузку; после завершения или ошибки баннер закрывается кнопкой Закрыть. Не закрывайте страницу, пока не увидите результат загрузки.
Чтобы удалить несколько элементов, выделите их в таблице содержимого, нажмите действие удаления и подтвердите операцию. Если объект уже удалён или у вас нет права удаления, приложение оставит его в списке и покажет причину ошибки.
API-ключи
- Откройте API-ключи.
- В блоке Создать API-ключ укажите имя.
- Выберите хотя бы одну область доступа.
- При необходимости укажите срок действия или оставьте поле пустым для бессрочного ключа.
- Нажмите Создать ключ и скопируйте секрет в окне Сохраните секрет: повторно он не показывается.
- Для скомпрометированного ключа используйте Отозвать. Отозванный ключ можно удалить навсегда. Для безопасной замены используйте Обновить; новый секрет также показывается только один раз.
В списке отображается состояние каждого ключа: Активен, Истёк или Отозван. Отозванный ключ сначала нужно подтвердить при удалении; после удаления восстановить его нельзя.
Области доступа имеют формат домен:операция: например, projects:read, projects:write, storage:read, storage:write. Не передавайте секрет в репозиторий, отчёт, скриншот или URL.
Подробное описание REST API находится в разделе Использование REST API.
Ошибки и восстановление
- Сообщение под формой означает, что нужно исправить конкретное поле и повторить сохранение.
- При ошибке прав проверьте, что у вас есть доступ к проекту или роль Запись для библиотеки.
- При временной ошибке сервиса повторите операцию через несколько секунд.
- Если данные изменялись в другой вкладке, обновите страницу и повторите действие.
- При ошибке авторизации войдите снова.
Формы не закрываются после ошибки, поэтому введённые значения можно исправить без повторного заполнения. Секреты, токены и внутренние пути приложения пользователю не показываются.