Состояния сессий и запусков
| Состояние запуска | Значение | Действие интеграции |
|---|---|---|
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: состояние может измениться до запроса.