MODULE_07 · УРОК 7.4

Уроки прода

Дальше пять грабель, на которые уже наступили другие. Каждая из них у кого-то жгла деньги, рвала сессии посреди работы или тихо плодила лишние виртуалки. Написать про них в теории легко, а вот заметить в живом проекте до первого счёта - совсем другое дело: прочитанная ловушка кажется очевидной, незамеченная повторяется из проекта в проект.

Код сегодня писать не нужно, но истории настоящие, и защиты стоят буквально нескольких строк.

ЧТО ПОЛУЧИТСЯ Вы будете знать пять классических граблей жизненного цикла: как каждая ломается и каким простым приёмом закрывается. Урок чисто теоретический - код писать не нужно.

Слова, которые встретятся

  • Ручка (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 провайдера, а базу и клиента - кэшем. Сомневаетесь - сходите за свежим статусом, это дешевле, чем объясняться потом.

КОМБИНАЦИИ ХУЖЕ ОДИНОЧЕК По отдельности каждая грабля неприятна, а вот в паре они дают эффект, который не сразу и диагностируешь. Мёртвый handle вместе с опросом, засчитанным за активность, - это оплата песочницы, с которой невозможно поговорить. Кривой кэш плюс петля resume - три виртуалки на одного пользователя. Так что закрывать стоит все пять, даже если кажется, что «у нас такого точно не будет».
КУДА ВЕШАТЬ В HARNESS Probe ставится сразу после reconnect, перед первой настоящей работой. Свежий expires запрашивается перед stop и hibernate. Фильтр активности живёт рядом с таймером простоя из урока 7.1, а правила автоподъёма - там же, где restore из 7.2. Статус для интерфейса всегда берётся у провайдера. Ну а хуки after_start и before_stop из урока 4.5 станут удобными точками входа, когда вы доберётесь до живого облака.

Проверьте (без кода)

  1. Назовите пять граблей без подглядывания.
  2. Какая из них первой ударит по вашему окружению - и почему.
  3. Для одной грабли: где «ворота» проверки, которые поймали бы сбой.

Готово, если:

  • Называете все пять граблей
  • Для каждой можете сказать приём защиты
  • Связываете защиты с хуками 4.5 / идеями 7.1-7.3
ДАЛЬШЕ МОДУЛЬ 8 С жизненным циклом как с идеей мы закончили. Следующий модуль про человека в цикле: агент научится задавать структурированные вопросы, а проверка перед опасным действием перестанет быть сухим «заблокировано» и превратится в разговор.