L2 Открытый урок · Новичок
Уровень L2: проект PRJ-02 и экзамен
Итог уровня L2: CLI-скрипт, который вызывает LLM API и сохраняет JSON, критерии приёмки и формат 90-минутного экзамена.
- Объём
- ≈ 14 часов + экзамен 90 минут
- Компетенции
- PROG-01·A, PROG-03·F, PROG-05·F, API-01·F, PROG-04·F
Проект PRJ-02: AI API application
Задача. Автоматизировать задачу из своего PRJ-01 скриптом. Пример: папка с конспектами → для каждого файла пересказ и ключевые слова → один JSON-отчёт.
Требования.
- CLI-скрипт на Python:
python summarize.py notes/ --out summaries.json. - Читает файлы, вызывает LLM API, сохраняет JSON. Ответ модели запрашивается в JSON по схеме и разбирается парсером.
- Ключ — только в переменной окружения; без ключа — понятное сообщение, а не трассировка ошибки.
- Ошибки сети и API обрабатываются: сбой одного файла не останавливает остальные, в отчёте видно, какой файл не обработан и почему.
- В конце — расход токенов за прогон.
- Проверочный набор: 5 входных файлов и ожидаемые поля для каждого.
Документация. README: что делает, как установить (requirements.txt), как задать ключ, пример запуска и пример вывода.
Приёмка.
- Запускается по README на чистой машине.
- В истории Git нет ключей и секретов: проверяющий смотрит историю, а не только последний коммит (CE-01).
- 5 входов из проверочного набора обработаны; ожидаемые поля на месте.
- Сбой API на одном файле (проверяющий подставит неверный адрес или файл-ловушку) не роняет скрипт.
Экзамен уровня
90 минут, свой компьютер. Дан адрес учебного API (или фейковый сервер преподавателя) и описание полей. Написать скрипт, который:
- делает запрос с параметром из командной строки;
- обрабатывает минимум 3 ситуации: нет сети, 404, неожиданный формат ответа;
- сохраняет выбранные поля в JSON-файл;
- берёт ключ (если нужен) из переменной окружения.
Зачёт: работает на трёх проверочных входах преподавателя, включая сломанный; ключ не в коде; код читаемый (функции, понятные имена). Плюс квиз по теории ≥ 6 из 8.