Подготовка и завершение работы
Хуки выполняют повторяемые действия в песочнице до или после работы агента. Передавайте текст исполняемого скрипта с shebang в configuration.hooks.
| Хук | Когда выполняется | Пример |
|---|---|---|
after_create | После создания рабочего окружения | Подготовить каталоги |
before_run | Перед каждой задачей | Скачать данные и записать путь результата |
after_run | После подтверждённого завершения агента, до паузы или удаления песочницы | Отправить готовый файл |
{
"before_run": "#!/bin/sh\nset -eu\nmkdir -p replies\n",
"timeout_seconds": 120
}Проверьте статус агента перед публикацией: after_run может выполняться после неуспешного завершения. Используйте ORPHEUS_AGENT_STATUS и ORPHEUS_STOP_REASON. Хук не заменяет внешний контроль доставки, если песочница потеряна или выполнение не удалось подтвердить.
Для привязки результата используйте ORPHEUS_SESSION_ID, ORPHEUS_RUN_ID и ORPHEUS_HOOK_OPERATION_ID. Повторная попытка доставки должна проверять, не был ли результат уже опубликован.
timeout_seconds ограничивает каждый хук отдельно. Результат выполнения и ошибки видны в карточке запуска. Поле before_remove не выполняется: не используйте его для очистки.