Как собрать курс#

Курс на платформе собирает куратор вместе со своим агентом: вы объясняете агенту, чему учим и на каком материале, агент вызывает инструменты платформы. Писать код не нужно — нужен подготовленный материал и решения о том, как учить.

Страница описывает устройство платформы и порядок работы. Чему и как учить, платформа не предписывает: методика ваша.

Что подготовить до подключения агента#

Материал уроков. Готовый текст каждого урока. Платформа его не переписывает и не сокращает — что передали, то ученик и получит.

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

Представление об ученике. Кого учим, что человек уже знает, каким языком с ним разговаривать. Это уйдёт в указания агенту и заметно влияет на занятие.

Доступ. Роль куратора выдаёт команда платформы. Подключаться нужно к кураторскому адресу сервиса — у ученического набор инструментов другой, курс там не собрать.

Подключившись, попросите агента показать гайд по сборке: он получит порядок работы и ограничения платформы одним вызовом.

Порядок сборки#

Сначала список курсов, потом курс, главы и уроки, потом указания, проверка знаний и документы, и в конце публикация.

1. Список курсов — list_courses. С него начинается любая сессия: идентификатор курса нужен всем остальным вызовам, а между сессиями агент его не помнит.
2. Курс — create_course. Создаётся черновиком: ученикам он не виден, пока вы не опубликуете.
3. Главы и уроки — add_chapter, add_lesson. Урок ложится в конец главы сразу, отдельной привязки нет.
4. Указания агенту — set_directive на урок и set_course_directive на курс целиком.
5. Проверка знаний — add_quiz, по одному квизу на урок.
6. Документ курса — set_course_artifact, если курс предполагает документ.
7. Сверка и публикация — course_draft и publish_course.

Перед публикацией прочитайте собранное глазами. Материал уезжает на платформу параметром вызова, и опечатка или обрезанный текст ничем себя не проявят: курс будет выглядеть готовым. Черновик курса содержимое уроков не показывает — только признак наличия, — поэтому сверять нужно поурочно через get_lesson.

Директива урока и директива курса#

Директива — это указания агенту, который будет вести занятие. Ученик их не видит; они про то, как учить, а не что показать.

Директива курса — сквозное: роль и тон преподавателя, формат занятия, кого учим, термины курса, что стоит запоминать об ученике. Пишется один раз на курс.

Директива урока — про этот урок: цели, чем проверять понимание по ходу, типичные заблуждения, что считать усвоенным. Цели здесь несут двойную роль — по ним агент отчитывается, что разобрано, и незакрытая цель закрывает проверку знаний.

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

Каждый вызов создаёт новую версию, прежняя перестаёт действовать. Занятия, которые уже прошли, переписанная директива задним числом не меняет.

Проверка знаний#

Проверку знаний ведёт и оценивает сервер. Агент получает вопрос без верных вариантов, передаёт ответ ученика как есть и получает вердикт — подсказать он не может, даже если захочет.

Отсюда ограничение: открытых вопросов со свободной формулировкой платформа не принимает. Такой вопрос сервер проверить не может. Если тема требует рассуждения, разложите её на проверяемые вопросы, а само рассуждение оставьте занятию — агент разберёт его в разговоре, для этого и нужны наводящие вопросы в директиве.

Вопрос с вариантами: минимум два варианта, хотя бы один верный, без повторов. Пояснение к варианту приходит ученику вместе с вердиктом — это место для разбора ошибки, а не для подсказки.

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

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

Документы курса#

Документ курса — то, что ученик собирает по ходу обучения: резюме проекта, канвас, реестр рисков. Вы задаёте блоки: ключ, заголовок, подсказку и к какому уроку блок относится.

Подсказка адресована агенту ученика: что должно оказаться в блоке и когда он готов. По ней агент понимает, о чём спросить на занятии.

Заполняет блоки ученик — его словами, его проектом. На зачёт документ не влияет.

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

Проверка готовности и публикация#

Публикация открывает курс ученикам и проверяет готовность. Она возвращает две вещи: что мешает публикации и что стоит знать.

Мешают публикации пустые места: курс без краткого описания — карточка в каталоге окажется пустой, — курс без уроков, урок без материала, вопрос без текста, квиз без вопросов.

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

Черновик курса — course_draft — показывает собранное целиком, вместе с верными ответами, и содержит поле готовности. Смотрите его после перерыва в работе и перед публикацией.

Снять курс с публикации можно — unpublish_course. Прогресс учеников при этом сохраняется.

Что можно менять после занятий#

Правится свободно: материал урока, директивы, состав квиза, схема документа. Новая версия директивы действует со следующего занятия.

Не удаляется: урок, по которому уже занимались. Платформа откажет — иначе у прошедшего его ученика прогресс указывал бы в пустоту. Переписывайте такой урок вместо удаления.

Удаления курсов нет вовсе. Курс убирается из каталога снятием с публикации.

До первого ученика правится и удаляется всё.