Уроки прода
Дальше пять грабель, на которые уже наступили другие. Каждая из них у кого-то жгла деньги, рвала сессии посреди работы или тихо плодила лишние виртуалки. Написать про них в теории легко, а вот заметить в живом проекте до первого счёта - совсем другое дело: прочитанная ловушка кажется очевидной, незамеченная повторяется из проекта в проект.
Код сегодня писать не нужно, но истории настоящие, и защиты стоят буквально нескольких строк.
Слова, которые встретятся
- Ручка (handle) - объект песочницы у вас в коде. Живой объект в памяти ничего не говорит о том, отвечает ли ещё виртуалка на том конце провода.
-
Probe - короткая проверка на признаки жизни
вроде
echo probe, которую делают перед настоящей работой. Дешёвая страховка от долгих разбирательств. - Auto-resume - автоматический подъём песочницы из снимка после паузы. Удобно до тех пор, пока не выясняется, что без внятных правил это легко зацикливается.
Какие файлы трогаем
| Файл | Что делать |
|---|---|
| проект ученика | Не трогать. Урок чисто теоретический - код писать не нужно. Защиты потом вешают на хуки 4.5. |
1. Протухший handle после reconnect
Вы переподключились к старой песочнице, объект получен, код радостно едет дальше. А сессия внутри давно мертва: команды висят до таймаута или возвращают невнятный мусор, и следующие полчаса вы ищете баг в логике агента, которого там нет.
Приём: перед настоящей работой сделать короткий probe.
sandbox = await reconnect(sandbox_id)
probe = await sandbox.exec("echo probe")
if probe["exit_code"] != 0 or probe["stdout"].strip() != "probe":
sandbox = await create_from_snapshot(last_snapshot_id)
2. Протухшие данные про expires_at
При создании виртуалки провайдер честно сообщил время её смерти. Вы это число закэшировали и через час принимаете по нему решения, как по свежему. Или считаете, сколько осталось секунд, от давно устаревшего момента, и поднимаете машину, которой уже нет.
Приём: перед любым решением о жизни и смерти спрашивать свежий статус у провайдера. Кэш годится для интерфейса, но не для выбора «гасить или не гасить».
3. Опрос статуса сбрасывает простой
Ваш же workflow каждые тридцать секунд вежливо интересуется, жива ли песочница. Если такой опрос засчитывается за активность, окно простоя не закроется никогда: машина доживёт до жёсткого срока, ни разу не поработав, а счёт придёт как за полноценную сессию.
Приём: в счётчик активности писать только настоящую работу - сообщения пользователя, вызовы инструментов, изменения файлов. Опрос статуса, health-check и чтение биллинга активностью не считаются.
def record_activity(event: str) -> None:
if event in ("user_message", "tool_call", "fs_change"):
sandbox.last_activity_at = now()
4. Петля auto-resume
Самая красивая из пяти. Reconnect поднимает песочницу из снимка, lifecycle смотрит на неё и честно видит, что активности пока не было, поэтому делает снимок и усыпляет. Следующий reconnect будит заново. И так по кругу, пока кто-нибудь не посмотрит в биллинг. Оба куска кода по отдельности абсолютно правильные, а вместе дают вечный двигатель.
Приём: поднимать автоматически только при первом входе в состояние hibernated. Повторный reconnect должен цепляться к уже активной песочнице, а не запускать новую цепочку переходов.
5. Расхождение состояния
Состояние живёт сразу в трёх местах: в API провайдера, в вашей базе и в кэше на клиенте. Рано или поздно они разъедутся, это вопрос времени, а не вероятности. И тогда всё зависит от того, кому вы верите в момент показа пользователю.
Приём: считать единственным источником правды API провайдера, а базу и клиента - кэшем. Сомневаетесь - сходите за свежим статусом, это дешевле, чем объясняться потом.
expires запрашивается перед stop и
hibernate. Фильтр активности живёт рядом с таймером простоя из
урока 7.1, а правила автоподъёма - там же, где restore из 7.2.
Статус для интерфейса всегда берётся у провайдера. Ну а хуки
after_start и before_stop из урока 4.5
станут удобными точками входа, когда вы доберётесь до живого
облака.
Проверьте (без кода)
- Назовите пять граблей без подглядывания.
- Какая из них первой ударит по вашему окружению - и почему.
- Для одной грабли: где «ворота» проверки, которые поймали бы сбой.
Готово, если:
- Называете все пять граблей
- Для каждой можете сказать приём защиты
- Связываете защиты с хуками 4.5 / идеями 7.1-7.3