Автопилоты

Регулярная работа без человека: расписание, вебхук из внешней системы или кнопка запускают агента, команду или воркфлоу.

Автопилот — это постоянное поручение: он срабатывает сам и передаёт работу исполнителю. Ночная сортировка обращений, еженедельный отчёт, реакция на событие из внешней системы — всё, что должно происходить по расписанию или по событию, а не тогда, когда о задаче вспомнит сотрудник.

В рабочем пространстве есть готовые заготовки — ежедневный дайджест, сортировка багов, еженедельный отчёт о прогрессе, проверка документации и другие, — либо автопилот создаётся с нуля.

Кому уходит работа

Исполнитель обязателен, и он определяет, что произойдёт при срабатывании:

Агент или команда — создаётся задача и назначается им. Работа появляется на доске с обычной историей, комментариями и статусом.
Воркфлоу — запускается процесс, без задачи и без агента. Если задача нужна, воркфлоу заводит её своим шагом.

Для агента и команды можно задать промпт — текст поручения, с которым агент просыпается, — и проект, в котором появится задача. Заголовок задачи берётся из шаблона; в нём поддерживается подстановка текущей даты.

Команда автопилота это его дом: автопилот видят люди этой команды и админы, а запуски видны так же, как задачи команды. Выбрать можно команду, в которой вы состоите или которую можете править. Без команды автопилот принадлежит всему пространству, а задачи от него попадают в команду по умолчанию.

Чем запускается

Триггер	Когда срабатывает
Расписание	По cron-выражению в выбранном часовом поясе
Вебхук	Когда внешняя система отправляет запрос на его адрес
Вручную	Кнопкой «Запустить сейчас» — тот же путь, но с другим источником
API	Из программного вызова

Триггеров у одного автопилота может быть несколько. Расписание срабатывает в начале минуты в своём часовом поясе; новое расписание берёт часовой пояс из вашего профиля. Точность — до минуты, а не до секунды.

Срабатывание, которое приходится на ещё не закончившийся прошлый запуск, пропускается, а не ждёт очереди.
Срабатывание, пропущенное, пока Баунс не работал, потом не догоняется.
При переводе часов время, которого в этот день нет, пропускается, а время, которое наступает дважды, срабатывает один раз.

Вебхуки

У триггера-вебхука свой адрес, и этот адрес и есть ключ доступа.

Вебхук не подписывается. Запустить автопилот может любой, кто знает URL, — других проверок нет. Поэтому адрес хранят как секрет и меняют при утечке.
Повторы не задваивают работу. Доставки дедуплицируются по ключу, поэтому провайдер, который ретраит запрос, не запустит автопилот дважды.
Полезная нагрузка доезжает до исполнителя. Агенту она приходит в описании созданной задачи, воркфлоу — во входных данных запуска.
Каждая доставка видна: сырое тело, заголовки, число попыток и результат. Любую можно повторить вручную.

Адрес вебхука — это секрет: кто им владеет, тот запускает автопилот. Поэтому он показывается только тем, кто вправе менять настройки автопилота — срабатывает он с их правами. При утечке смените адрес: старый перестаёт работать немедленно, и все внешние системы нужно перенастроить.

История запусков

Каждое срабатывание записывается: источник (расписание, вручную, вебхук, API), статус и ссылка на созданную задачу.

Статус запуска	Что значит
Выполняется	Срабатывание идёт
Задача создана	Задача заведена и назначена исполнителю
Завершено	Срабатывание отработало
Пропущено	Условия не выполнены — работа не запускалась
Не удалось	Сбой, с указанием причины

Сам автопилот при этом находится в одном из трёх состояний: Активен, Приостановлен или В архиве.

Защита от сломанного автопилота

Ежедневная проверка сама ставит на паузу автопилот, у которого за последнюю неделю набралось не менее 50 запусков и 90% из них завершились ошибкой. Назначение защиты простое: неисправный автопилот не должен месяцами расходовать запуски агентов и токены. Создатель автопилота получает уведомление, а включить автопилот обратно можно сразу после устранения причины.

Каждый шаг срабатывания повторяется около минуты, если служба на время недоступна, и при этом не создаёт вторую задачу. Запуск, который всё равно завершился ошибкой, не повторяется — следующее срабатывание по расписанию просто начинает новый. Если автопилот критичен, предусмотрите собственную проверку: например, пусть агент оставляет комментарий об успехе, а вы следите за его отсутствием.

Кто может настраивать

Менять то, что запускает автопилот — исполнителя, промпт, триггеры, — могут его владелец и администраторы рабочего пространства. Остальные видят автопилот и историю его запусков.

Воркфлоу — что запускает автопилот с исполнителем-воркфлоу.
Вебхуки — приём событий из внешних систем целиком: коды ответа, доставки, безопасность.
Активы — актифлоу, автоматизации таблиц: похожий механизм, но на записях.
Задачи агентов — во что превращается срабатывание.