Skip to content

Помощь ​

Learning Copilot помогает планировать подготовку, хранить материалы и отслеживать готовность к учебной цели. Основная навигация находится в верхней части экрана:

  • Проекты — учебные цели, этапы, задачи и показатели готовности;
  • Материалы — библиотеки, папки и файлы;
  • API-ключи — ключи для интеграций;
  • Документация — эта справка и описание REST API.

Вход ​

  1. На стартовой странице нажмите Продолжить.
  2. В окне Keycloak введите данные учётной записи.
  3. После входа выберите нужный раздел в верхнем меню.
  4. Для управления профилем нажмите значок профиля справа в шапке. Профиль открывается в новой вкладке.

Если срок сессии закончился, приложение попросит войти снова. Повторный вход не удаляет созданные проекты и материалы.

Проекты ​

Создание проекта ​

  1. Откройте Проекты.
  2. Нажмите Новый проект.
  3. Заполните обязательное поле Название. Максимальная длина — 40 символов.
  4. При необходимости добавьте Описание, Дедлайн, Приоритет и Направление.
  5. Нажмите Создать проект в открывшейся форме.

Доступные значения приоритета: Низкий, Обычный, Высокий. Дедлайн можно оставить пустым, но заполненная дата должна быть корректной.

В списке проектов нажмите Настройки политик, чтобы открыть общие правила агрегации, затухания, калибровки, рекомендаций и рисков. Карточка проекта открывается кнопкой Открыть.

Просмотр и настройка ​

  1. Выберите карточку проекта в списке.
  2. На странице проекта ознакомьтесь с показателями Охват, Текущая готовность, Риск проекта и Дедлайн.
  3. Чтобы изменить название, описание, дедлайн или приоритет, откройте Настройки проекта.
  4. Для изменения правил расчёта используйте раздел Политики. Сохраняйте каждый блок после изменения его порогов, весов или периода затухания.

В настройках также можно приостановить, активировать или архивировать проект. Удаление находится в зоне опасных действий и всегда требует подтверждения.

Метрики проекта ​

Показатели проекта помогают понять не только текущий результат, но и то, насколько он устойчив во времени:

ПоказательКак считаетсяЗачем нужен
ОхватСреднее значение охвата активных этапов с учётом их срочности. Охват этапа — среднее значение охвата его активных задач. Охват задачи — сумма освоения блоков с их весами.Показывает, какая часть учебного содержания уже освоена без учёта давности последней проверки.
Текущая готовностьВзвешенное среднее готовности активных этапов. Готовность этапа — взвешенное среднее готовности задач. Готовность задачи — сумма освоения каждого блока, умноженного на его вес и коэффициент актуальности.Показывает, насколько результат можно считать актуальным прямо сейчас.
Риск проектаСамый высокий уровень риска среди активных этапов. Риск этапа определяется самым высоким риском его задач.Не маскирует критичную задачу средним значением и подсказывает, где требуется внимание.
ДедлайнДата, указанная при создании или редактировании проекта.Ограничивает горизонт подготовки и влияет на вес срочных этапов и задач.

Все процентные показатели находятся в диапазоне от 0 до 100. Если у задачи нет оценки блока, его готовность не получает актуального подтверждения, поэтому новые оценки особенно важны для достоверного результата.

Актуальность и затухание готовности ​

Готовность уменьшается со временем после последней оценки, даже если исходный уровень освоения не изменился. Это позволяет отличить давно выученный материал от результата, подтверждённого недавно. Используются следующие периоды полуснижения актуальности:

  • Понимание — 120 часов;
  • Практика — 96 часов;
  • Запоминание — 72 часа.

Через такой период коэффициент актуальности становится примерно в два раза меньше. Поэтому Охват может оставаться высоким, а Текущая готовность снижаться: это сигнал повторить оценку или заняться материалом.

Периоды затухания можно изменить в блоке Затухание знаний в общих настройках политик или в настройках конкретного проекта. Значение задаётся в часах и должно быть больше нуля. Настройка проекта имеет приоритет над личной, а если она не задана, используется личная настройка. По умолчанию используются 120 часов для понимания, 72 часа для запоминания и 96 часов для практики.

Для интеграций доступны PATCH /projects/policies/decay и PATCH /projects/{id}/policies/decay с телом вида:

json
{
   "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. Начните с блока Риск проекта и списка Критично для дедлайна.
  2. Откройте задачи с высоким или критическим риском.
  3. Проверьте, какой блок слабее: понимание, запоминание или практика.
  4. Выполните рекомендацию и запишите новую оценку.
  5. Обновите статус или запустите пересчёт готовности.
  6. Сравните Охват и Текущую готовность: если охват выше готовности, материал освоен, но оценка устарела или близок дедлайн; если оба показателя низкие, требуется системная работа с задачами.

Этапы ​

  1. Откройте проект и перейдите в Этапы.
  2. Нажмите Новый этап.
  3. Укажите Название, Цель, Порядок и, если нужно, Дедлайн.
  4. Нажмите Создать этап в открывшейся форме.
  5. Откройте карточку этапа, чтобы увидеть его доску и список задач.

Порядок этапа начинается с 1. Этап можно изменить, приостановить, активировать, архивировать или удалить. Удаление выполняется только после явного подтверждения.

Чтобы быстро найти этап, введите часть названия или цели в поле поиска. Дополнительно можно отфильтровать этапы по статусу (Все статусы, Активные, Приостановленные, Архивные) и уровню риска.

Задачи ​

Создание и редактирование ​

  1. Откройте нужный этап.
  2. Нажмите Новая задача.
  3. Заполните Ожидаемый результат, Сложность от 1 до 10, Приоритет, при необходимости Дедлайн.
  4. Распределите задачу по полям Части понимания, Части запоминания и Части практики. Укажите хотя бы одну часть.
  5. Нажмите Создать задачу.

Чтобы изменить задачу, откройте её карточку и выберите редактирование. В форме можно изменить ожидаемый результат, сложность, приоритет, дедлайн и веса контекстов, затем нажмите Сохранить изменения. Для закрытия формы без сохранения нажмите Отмена.

Из карточки задачи доступны просмотр деталей, редактирование, удаление, изменение статуса и отметка Готова к экзамену. Архивные задачи не исчезают безвозвратно: их статус можно увидеть в данных проекта.

Статусы задачи ​

Статус показывает текущий этап работы:

В очереди → Изучение → Базовый уровень пройден → Стабильная → Готова к экзамену.

Статус В зоне риска используется для задачи с повышенным риском, а Архивные — для архивированных задач. Переход выполняется из карточки задачи; выбирайте следующий статус, соответствующий фактическому состоянию подготовки.

В списке задач доступны поиск по ожидаемому результату и фильтры по статусу, уровню риска и приоритету. Если задача не отображается, сначала сбросьте фильтры через вариант Все.

Оценка готовности ​

  1. Откройте задачу и нажмите Записать оценку.
  2. В поле Ограниченный контекст выберите Понимание, Запоминание или Практика.
  3. Укажите источник оценки: диалог, мини-кейс, внешняя система или ручное подтверждение.
  4. Заполните значения оценки и уверенности в диапазоне от 0 до 100.
  5. Сохраните оценку.

В окне Изменить веса контекстов можно настроить Части понимания, Части запоминания и Части практики. Под полями сразу отображаются рассчитанные проценты. Общая сумма частей должна быть больше нуля; отрицательные и нечисловые значения недопустимы. Нажмите Сохранить веса или Отмена. После изменения оценки или весов используйте Обновить статус, если показатель не обновился автоматически.

Дашборд проекта показывает Охват, Текущую готовность, Риск проекта, дедлайн и блок Критично для дедлайна. Внутри блока отображаются критичные элементы, которые сильнее всего влияют на достижение цели.

На странице задачи также доступны Рекомендации, прогноз снижения готовности и последние оценки. После изменения исходных данных повторите генерацию рекомендаций или пересчёт готовности.

Материалы ​

Библиотеки ​

  1. Откройте Материалы.
  2. На вкладке Мои библиотеки нажмите Новая библиотека.
  3. Укажите название и описание, затем выберите видимость библиотеки.
  4. Для приватной библиотеки настройте доступ пользователей с ролями Чтение или Запись.
  5. Нажмите Создать библиотеку в открывшейся форме и откройте карточку через Открыть.

Публичную библиотеку можно добавить в свои материалы, поставить или убрать звезду и отменить подписку. Собственную библиотеку можно изменить или удалить. Удаление библиотеки требует подтверждения.

На вкладке Мои библиотеки можно отфильтровать библиотеки по видимости (Все, Публичные, Приватные), периоду изменения и сортировке. На вкладке Глобальные доступны поиск по названию, описанию или владельцу, сортировка по новым библиотекам или популярности, кнопки Добавить к себе и звезда. Каталог загружается постранично при прокрутке.

Файлы и папки ​

  1. Откройте библиотеку и перейдите в Дерево файлов.
  2. Нажмите Создать папку, чтобы добавить каталог.
  3. Нажмите Загрузить файл и выберите файл. Для загрузки нужен доступ Запись.
  4. Выберите файл или папку, чтобы открыть информацию и доступные действия.
  5. Используйте кнопки Переименовать, Копировать, Вырезать, Вставить, Удалить или Скачать.

Для перехода по структуре используйте цепочку root и названия папок. Кнопка Информация показывает тип, дату изменения, размер и MIME-тип файла. Скачать доступна только для выбранного файла; для папки сначала откройте её содержимое.

Хранилище не ограничивает загрузку заранее заданным списком типов файлов: MIME-тип сохраняется как техническая информация о файле и не используется для функций RAG. Имя файла может содержать до 255 символов, включая Unicode, пробелы, точки, скобки и распространённые специальные символы. Нельзя использовать только пустое имя, имена . и .., управляющие символы или разделители пути / и \. Это нужно только для корректного хранения файла, а не для ограничения учебных форматов.

Размер одного файла не должен превышать 500 МБ.

Операции с большими файлами выполняются по частям. В баннере отображается процент и имя файла. До завершения можно нажать Отменить загрузку; после завершения или ошибки баннер закрывается кнопкой Закрыть. Не закрывайте страницу, пока не увидите результат загрузки.

Чтобы удалить несколько элементов, выделите их в таблице содержимого, нажмите действие удаления и подтвердите операцию. Если объект уже удалён или у вас нет права удаления, приложение оставит его в списке и покажет причину ошибки.

API-ключи ​

  1. Откройте API-ключи.
  2. В блоке Создать API-ключ укажите имя.
  3. Выберите хотя бы одну область доступа.
  4. При необходимости укажите срок действия или оставьте поле пустым для бессрочного ключа.
  5. Нажмите Создать ключ и скопируйте секрет в окне Сохраните секрет: повторно он не показывается.
  6. Для скомпрометированного ключа используйте Отозвать. Отозванный ключ можно удалить навсегда. Для безопасной замены используйте Обновить; новый секрет также показывается только один раз.

В списке отображается состояние каждого ключа: Активен, Истёк или Отозван. Отозванный ключ сначала нужно подтвердить при удалении; после удаления восстановить его нельзя.

Области доступа имеют формат домен:операция: например, projects:read, projects:write, storage:read, storage:write. Не передавайте секрет в репозиторий, отчёт, скриншот или URL.

Подробное описание REST API находится в разделе Использование REST API.

Ошибки и восстановление ​

  • Сообщение под формой означает, что нужно исправить конкретное поле и повторить сохранение.
  • При ошибке прав проверьте, что у вас есть доступ к проекту или роль Запись для библиотеки.
  • При временной ошибке сервиса повторите операцию через несколько секунд.
  • Если данные изменялись в другой вкладке, обновите страницу и повторите действие.
  • При ошибке авторизации войдите снова.

Формы не закрываются после ошибки, поэтому введённые значения можно исправить без повторного заполнения. Секреты, токены и внутренние пути приложения пользователю не показываются.