Для AI-агентов: markdown этой страницы — /docs-content/infra/jobs.md индекс документации — /llms.txt
Вызов по расписанию
Задача вызывает ваш HTTP-обработчик на сервере Black Hole в заданные моменты. Если функция недоступна вашему порталу, создать, включить или запустить задачу нельзя. Настройка доступна через API и MCP, экрана управления задачами пока нет. Это отдельный механизм от окон пробуждения.
Возможности через Вайбкод API
Ключ с правом vibe:infra может читать задачи и историю. Для изменения нужны существующие права управления сервером: управляющий ключ или соответствующая роль участника команды разработки. Задача принадлежит серверу, а не ключу, который её создал. Перепривязка управляющего ключа сервера переносит управление задачами без пересоздания. Инструмент MCP manage_server_jobs принимает serverId, jobId для адресных действий, body для create/update и cursor/limit для runs. Он выполняет те же вызовы V1 с теми же отказами. Смешанные действия инструмента изменяют данные, вызывают обработчик и заменяют секрет.
Расписание и ограничения
Не более 20 неудалённых задач на сервер; выключенные тоже учитываются. Cron содержит пять полей, timezone — поддерживаемый часовой пояс IANA. Минимальный интервал задаётся платформой, по умолчанию 5 минут. path — относительный путь с необязательной query-строкой, до 512 символов: /tasks/digest?mode=daily. Абсолютный URL, путь с начальным //, обход .., управляющие символы и сырой # запрещены. Можно задать только POST-адрес обработчика: произвольные host, method, headers и body не настраиваются.
Создание, изменение cron/timezone и повторное включение начинают расписание строго в будущем. Изменение только label/path не сдвигает следующее вхождение. Запуск хранит свой снимок пути и портала; последующий PATCH не перенаправляет его. После простоя возвращается не вся очередь пропущенных вхождений, а максимум одно последнее. Если функция или допуск к расписаниям были временно недоступны, после восстановления также возможен один последний запуск, в том числе за этот период.
Пробуждение и доставка
Задачи разрешены и на сервере в эффективном режиме ALWAYS: дополнительное окно пробуждения ему не нужно. В IDLE/SCHEDULE платформа подготавливает сервер к сроку вызова. Хост галактики не поддерживается; приложение в галактике требует отдельного допуска. Перед пробуждением и отправкой проверяются текущие доступ портала, оплата, привязка сервера, запрет пробуждения и доступность расписаний. Задача не обходит запреты и не требует внешнего API-ключа приложения.
Каждый запуск, включая ручной на выключенной задаче, ждёт готовности не дольше 30 минут от создания; ожидание не расходует попытки. На одну задачу выполняется один запуск за раз. Уже отправленный RUNNING завершает свою попытку даже после выключения или удаления задачи. Новое плановое вхождение вытесняет только старый SCHEDULE PENDING без попыток; MANUAL и уже начатые запуски не вытесняются.
До четырёх попыток доставки с одним runId; приложение обязано проверять подпись и долговечную дедупликацию. HTTP 2xx означает приём, а не завершение фоновой работы. PENDING живёт не дольше 96 часов. Фоновая работа в приложении защищена лишь обычным таймером бездействия сервера, а не до своего окончания. Не рассчитывайте на гарантированное выполнение бизнес-операции ровно один раз.
Наблюдение и остановка
Журнал хранит завершённые запуски по настройке платформы: по умолчанию 90 дней, минимум 7 дней. PENDING/RUNNING по возрасту не удаляются. Секрет показывается только при создании и замене — сохраните его на стороне обработчика. Список и история его не возвращают.
При недоступности функции или утрате допуска авторизованный владелец может читать список и историю, удалить задачу или полностью заменить настройки только для выключения без иных изменений. Обычный PATCH с иными изменениями требует допуска. Отдельных уведомлений о FAILED нет; отказ доступа или оплаты использует существующее суточное уведомление. После удаления задача исчезает из списка и её журнал по адресному API отвечает 404; сохраните нужные записи заранее.