# Автоматизация и планирование

## 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 для запуска действий агента при получении электронных писем:

1. Настройте тему и подписку GCP Pub/Sub
2. Настройте фильтрацию меток Gmail
3. Направьте push-доставку на ваш URL-адрес вебхука
4. 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-задание → агент составляет и публикует контент в оптимальное время |