bulgakov

Практикумы и рабочие шаблоны

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

Практикумы

Скачать практикумы и шаблоны одним архивом.

В архиве — учебные модули Python и SQLite, готовые примеры, рабочие шаблоны и инструкция по запуску. Все данные вымышлены. Сетевых вызовов, настоящих платежей и отправки сообщений нет.

После распаковки откройте папку в терминале. Для примеров нужен Python 3.10 или новее; внешние пакеты устанавливать не требуется.

Shell
python3 labs/sql_lab.py
python3 labs/etl_lab.py
python3 labs/retrieval_lab.py
python3 labs/eval_lab.py

В Windows команда Python может называться py.

Шаблоны для работы

Постановка задачи

# Контракт задачи

Дата и владелец:

Цель и пользователь результата:

Входные данные, версии и разрешённые источники:

Обязательные правила и определения:

Область текущего изменения:

Формат результата:

Критерии приёмки:

| Сценарий | Вход | Ожидаемое поведение | Основание |
|---|---|---|---|
| Обычный | | | |
| Граница | | | |
| Недостаточно данных | | | |
| Ошибка / повтор | | | |

Что можно предположить и что нужно уточнить:

Разрешённые действия и требуемые подтверждения:

Доказательства завершения:

Исследовательская записка

# Исследовательская записка

Вопрос, дата среза, аудитория и решение:

Краткий вывод:

| Утверждение | Источник / URL | Подтверждающий фрагмент или раздел | Дата проверки | Ограничение |
|---|---|---|---|---|
| | | | | |

Противоречия источников и способ их разрешения:

Отдельно: наблюдения / выводы / гипотезы.

Непроверенные сведения:

Собственный эксперимент и результаты:

Что заставит изменить решение:

Передача контекста

# Передача задачи

Цель:

Текущее состояние файлов, ветка и версия:

Сделано:

Принятые решения и причины:

Выполненные проверки: команда, результат, среда.

Не проверено:

Выполненные внешние операции и их идентификаторы:

Что нельзя повторять без сверки:

Оставшиеся вопросы и риски:

Следующий конкретный шаг:

Определение метрики

# Контракт метрики

Название, владелец, бизнес-вопрос:

Единица строки (grain):

Числитель и знаменатель:

Статусы, фильтры и исключения:

Период, event_time / ingested_at, временная зона:

Валюта и минимальная единица:

Возвраты, отмены, дубли и поздние изменения:

Источники и ключи соединений:

Проверка на маленьком вручную рассчитанном примере:

Контрольные итоги и ограничения интерпретации:

Сравнение моделей

# Сравнение инструментов

Дата; задача; обязательные ограничения; набор входов:

Кандидат A: продукт, модель, версия/алиас, параметры, инструменты.

Кандидат B: продукт, модель, версия/алиас, параметры, инструменты.

| case_id | Тип случая | Эталон / основание | Оценка A | Оценка B | Критическое нарушение |
|---|---|---|---|---|---|
| 001 | обычный | | | | |
| 002 | сложный | | | | |
| 003 | нет данных | | | | |
| 004 | доступ / injection | | | | |

Рубрика: 0 — неверно; 1 — существенная доработка; 2 — принято.

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

Слепой порядок оценки:

Что измерено:

Личные предпочтения интерфейса:

Ограничения сравнения и следующий эксперимент:

Решение и условие пересмотра:

Бриф для изображения, звука или видео

# Бриф мультимодального материала

Назначение и аудитория:

Тип работы: точное извлечение / редактирование / творческая генерация.

Исходники, происхождение и разрешение на использование:

Формат, размер, длительность, соотношение сторон:

Что обязательно сохранить:

Что можно менять:

Для изображения: объект, композиция, свет, стиль, место под текст.

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

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

Для OCR: схема полей, проверка сумм, сомнительные участки.

Критерии проверки и ручной просмотр:

Карточка запуска

# Карточка запуска ИИ-функции

Назначение, пользователи и владелец решения:

Модель, версия промпта, код, корпус:

Данные и разрешённые направления передачи:

Инструменты: чтение / черновик / внешнее действие.

Обязательные условия и критические нарушения:

Набор оценки, результаты и непокрытые случаи:

Лимиты: шаги, время, бюджет, параллельность.

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

Идемпотентность и сверка неизвестного результата:

Журналы, маскирование, срок хранения и доступ:

Сигналы деградации:

Остановка, ручной резерв и откат:

Условия расширения пилота:

Журнал обновлений

# Журнал обновлений

| Дата | Компонент | Изменение | Первичный источник | Влияние | Проверка | Решение |
|---|---|---|---|---|---|---|
| | Модель / API / цена / клиент / документ | | | | | |

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

Дополнительные файлы

В архиве также есть пример инструкций проекта, матрица проверок, JSON Schema и пример запроса API. Инструкции в шаблонах — учебные образцы: адаптируйте их к своему проекту. Пример запроса API может потребовать платного доступа при самостоятельном запуске.