К содержимому

Хранение песочниц на паузе ​

Между запусками переиспользуемая сессия сохраняет песочницу на паузе. Orpheus удаляет старые песочницы, чтобы освободить их снимки. История запусков, сообщения, результаты и расход токенов остаются доступны. Файлы, процессы и контекст агента, которые хранились только в удалённой песочнице, восстановить нельзя.

Настройка worker ​

НастройкаПо умолчаниюДопустимые значения
SANDBOX_PAUSED_RETENTION_DAYS14 днейЦелое число от 1 до 100 включительно
SANDBOX_CLEANUP_BATCH_SIZE1000 сессий за проходПоложительное целое число

Выберите срок хранения до запуска worker

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

Задайте переменные в окружении worker. В Compose после изменения пересоздайте контейнер worker. Обычный restart не подхватывает новые ENV. Некорректные значения не позволят процессу запуститься. Изменение срока применяется и к существующим сессиям на паузе.

Срок отсчитывается от finished_at последнего запуска, включая ошибку и отмену. День — 24 часа. Это время после завершения запуска, а не точная длительность физической паузы. Следующий завершённый запуск начинает отсчёт заново. Чтение истории и повтор уже принятого запроса срок не продлевают.

Например, при настройке по умолчанию сессия подходит для удаления, когда с завершения её последнего запуска прошло больше 14 дней. Проверка выполняется при старте worker и каждые четыре часа. За проход выбирается не больше настроенного лимита сессий, включая повторы. Одновременно удаляются не больше трёх песочниц. Очередь или ошибка провайдера могут задержать удаление. Шесть проходов с интервалом четыре часа выбирают за сутки до шести размеров пачки, включая повторы.

Активные сессии исключаются. Уборка не занимает слоты исполнения и не возобновляет песочницы. Неудачные удаления повторяются в следующих проходах, в том числе после перезапуска worker.

Продолжение после удаления ​

Состояние песочницы меняется с paused через deleting на deleted. Ошибка песочницы sandbox_expired объясняет причину удаления. При неудачной попытке появляется sandbox_delete_failed до успешного повтора. Результат последнего запуска не меняется.

Создание запуска в переиспользуемой сессии с состоянием песочницы deleting, deleted или unavailable возвращает 409 session_unavailable. Создайте новую сессию с контекстом, необходимым для новой задачи. Orpheus не создаёт окружение заново внутри старой сессии.

Если песочницу удалили извне и Orpheus ещё не обнаружил потерю, API может вернуть 202. После подтверждения потери worker завершит запуск с sandbox_lost. Не повторяйте автоматически задание, которое уже могло выполнить действия. Повтор ранее принятого запроса с тем же ключом идемпотентности по-прежнему возвращает исходное подтверждение.

Продолжение в Mattermost и сброс контекста в Space описывают обработку следующего запроса в коннекторах. Режим сессии allow_multiple_runs не гарантирует доступность её песочницы.