Практикумы и рабочие шаблоны
В этом разделе собраны файлы, на которые ссылаются уроки. Начните с одного шаблона под свою задачу; весь комплект сразу изучать не нужно.
Практикумы
Скачать практикумы и шаблоны одним архивом.
В архиве — учебные модули Python и SQLite, готовые примеры, рабочие шаблоны и инструкция по запуску. Все данные вымышлены. Сетевых вызовов, настоящих платежей и отправки сообщений нет.
После распаковки откройте папку в терминале. Для примеров нужен Python 3.10 или новее; внешние пакеты устанавливать не требуется.
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 может потребовать платного доступа при самостоятельном запуске.
