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

Состояния сессий и запусков ​

Состояние запускаЗначениеДействие интеграции
acceptedЗадача принятаСохранить ID и ждать
startingПодготовка окруженияСледить за подготовкой и хуками
runningАгент выполняет задачуМожно передать уточнение
cancellingВыполняется отменаЖдать завершения отмены
finalizingЗавершение и хукиДождаться результата доставки
completedЗапуск успешно завершёнПрочитать результат
failedЗапуск завершился с ошибкойПроверить error, фазу и хуки
cancelledЗапуск отменёнПроверить выполненные действия

active_run_id показывает незавершённый запуск, last_run_id последний. Проверяйте конкретный запуск перед публикацией результата. Финальный текст может появиться до завершения after_run.

Состояние песочницы отдельно: not_created, provisioning, ready, pausing, paused, resuming, deleting, deleted, unavailable. Сохранённый ID песочницы не гарантирует, что она доступна.

Ошибки содержат code, message, phase, details. Фазы ошибки: preparation, execution, finalization, recovery. Поле phase выполнения может указывать на after_create, before_run, agent или after_run.

При allow_multiple_runs: false песочница удаляется после завершения, ошибки или отмены единственного запуска. История сессии остаётся доступной. При true песочница ставится на паузу, и сессия может принять следующий запуск при доступном окружении и бюджете. При потере контекста создайте новую сессию с необходимой историей из своей системы.

Песочница, первоначальная подготовка которой отменена или превысила дедлайн, удаляется и для переиспользуемой сессии. Состояние песочницы остаётся unavailable, история доступна для чтения. Очистка ресурса может закончиться после завершения запуска. См. ограничения подготовки и диагностику.

Песочницы переиспользуемых сессий на паузе удаляются по правилам хранения, по умолчанию через 14 дней после завершения последнего запуска. Удаление не меняет результат запуска. Перед продолжением проверьте состояние песочницы и всё равно обработайте 409 session_unavailable: состояние может измениться до запроса.