Деплой
Деплой агента отличается от деплоя обычного сервиса тем, что поведение зависит не только от кода, но и от промптов, модели и внешних инструментов. Значит, версия — это всё вместе.
Что версионируется
Заголовок раздела «Что версионируется»| Артефакт | Почему |
|---|---|
| Код | Обычная причина |
| Промпты | Меняют поведение сильнее кода |
| Конфигурация модели | Версия и параметры |
| Схемы инструментов | Меняют выбор действий |
| Набор eval | Определяет, что считается регрессией |
Промпт, лежащий в базе данных без версии, — главный источник «вчера работало иначе».
Режимы запуска
Заголовок раздела «Режимы запуска»- Синхронно в запросе. Простые задачи, ответ нужен сразу.
- Очередь. Долгие задачи; пользователь получает уведомление.
- Фоновый воркер. Пакетная обработка, расписания.
- Потоковый ответ. Когда важна первая реакция.
Режим определяет требования к состоянию: в очереди и воркере состояние обязано переживать перезапуск.
Деплой по шагам
Заголовок раздела «Деплой по шагам»- Прогнать eval на текущей базовой линии.
- Собрать артефакты: код, промпты, конфигурация.
- Выкатить на канареечную долю трафика.
- Сравнить метрики: качество, стоимость, ошибки, задержка.
- Расширить на весь трафик или откатить.
- Записать версию и результат в журнал изменений.
Шаг 4 — единственный, который отличает деплой от «залил и надеюсь».
Откат должен быть быстрым и однозначным:
- версия промпта и конфигурации переключается флагом, без сборки;
- предыдущая версия сохраняется;
- откат не требует миграции данных;
- решение об откате принимается по метрикам, а не по ощущению.
Если откат требует пересборки и миграции, он не будет выполнен вовремя.
Промпты как код
Заголовок раздела «Промпты как код»- Хранить в репозитории рядом с кодом.
- Ревьюить изменения как код.
- Тестировать eval-набором.
- Не редактировать в продакшене вручную.
Ручная правка промпта в продакшене — это изменение без ревью, без тестов и без истории.
Миграции
Заголовок раздела «Миграции»Изменение схемы состояния или формата результата требует совместимости:
- новая версия читает старые записи;
- старые задачи доигрываются старой версией;
- несовместимые записи явно отклоняются, а не интерпретируются наугад.
Материалы и источники
Заголовок раздела «Материалы и источники»- WPCraft KB: локальная разработка — контекст окружений WPCraft.