Автоматизация и планирование
Cron-задания
Планируйте пробуждения агентов с точным управлением временем. Cron-задания сохраняются при перезапусках Gateway и поддерживают гибкие шаблоны расписания.
Типы расписаний
| Тип | Описание | Пример |
|---|---|---|
| Cron-выражение | Стандартный синтаксис cron с временной зоной | 0 7 * * * (ежедневно в 7 утра) |
| Интервал | Повтор с фиксированными интервалами | 30m, 2h, 1d |
| Однократный запуск | Выполнить один раз в определённое время | 2026-03-15T16:00:00Z |
Цели сессий
- Основная сессия, поставить в очередь как системное событие в основном разговоре агента
- Изолированная сессия, выполнить в выделенной сессии (
cron:<jobId>), чтобы не загрязнять основные разговоры
Режимы доставки
| Режим | Описание |
|---|---|
| Нет | Тихое выполнение (вывод не публикуется) |
| Объявление | Опубликовать результат обратно в конкретный канал |
| Вебхук | HTTP POST результата на внешний URL |
Однократные напоминания
Установите напоминание на определённое время. Агент просыпается, обрабатывает напоминание и при необходимости удаляет задание после выполнения.
Повторяющиеся задания
Планируйте повторяющиеся задачи с помощью cron-выражений и поддержки временных зон. Задания отслеживают историю выполнения (успех, сбой, время).
Вебхуки
Получайте события от внешних сервисов и направляйте их к агентам.
Gmail Pub/Sub
Интегрируйтесь с системой push-уведомлений Gmail для запуска действий агента при получении электронных писем:
- Настройте тему и подписку GCP Pub/Sub
- Настройте фильтрацию меток Gmail
- Направьте push-доставку на ваш URL-адрес вебхука
- Neotask получает сообщения и ставит события агента в очередь
Пользовательские вебхуки
Регистрируйте HTTP-эндпоинты, которые запускают ходы агента при вызове. Полезно для интеграции с CI/CD-конвейерами, системами мониторинга или любым сервисом, способным отправлять HTTP-запросы.
Системные события
Системные события, это сигналы, пробуждающие агента для обработки:
- Немедленно, обработать при следующем цикле heartbeat
- Следующий heartbeat, поставить в очередь для следующей плановой проверки
Используйте системные события для реактивных рабочих процессов, агенты просыпаются, когда что-то происходит, а не по фиксированному расписанию.
Heartbeat
Heartbeat, это периодический сигнал (по умолчанию ~15 секунд), дающий агентам возможность обработать ожидающую работу:
- Проверить новые системные события
- Обработать сообщения в очереди
- Запустить ожидающие автоматизации
Heartbeat можно включить, отключить или настроить для каждого агента.
Хуки
Управляемая событиями автоматизация, запускающая команды оболочки или скрипты в ответ на события Gateway:
- При получении сообщения, выполнить при получении сообщения
- При ходе агента, выполнить до или после обработки сообщения агентом
- При событии канала, выполнить при специфических событиях канала (присоединение, выход, реакция)
Хуки выполняются на хосте Gateway и имеют доступ к данным контекста событий.
Варианты использования
| Сценарий | Решение |
|---|---|
| Ежедневный утренний брифинг | Cron-задание в 7 утра → агент суммирует ночные обновления |
| Еженедельная генерация отчётов | Cron-задание каждый понедельник → агент генерирует и отправляет отчёт по email |
| Мониторинг электронной почты | Вебхук Gmail → агент обрабатывает входящие письма |
| Уведомления о сборках | Вебхук CI/CD → агент объявляет результаты сборки в Discord |
| Ежечасная проверка данных | Interval-based cron → агент проверяет дашборд и оповещает об аномалиях |
| Запланированные посты в соцсетях | Cron-задание → агент составляет и публикует контент в оптимальное время |