# Автоматизація та планування

## Cron-завдання

Плануйте пробудження агентів з точним розкладом. Cron-завдання зберігаються після перезапуску Gateway та підтримують гнучкі шаблони розкладу.

### Типи розкладу

| Тип | Опис | Приклад |
|------|-------------|---------|
| **Вираз cron** | Стандартний синтаксис cron з часовим поясом | `0 7 * * *` (щодня о 7 ранку) |
| **Інтервал** | Повтор через фіксовані інтервали | `30m`, `2h`, `1d` |
| **Одноразовий** | Виконати один раз у зазначений час | `2026-03-15T16:00:00Z` |

### Цілі сесій

- **Основна сесія**, Додати в чергу як системну подію в основну розмову агента
- **Ізольована сесія**, Виконати в окремій сесії (`cron:<jobId>`) щоб уникнути забруднення основних розмов

### Режими доставки

| Режим | Опис |
|------|-------------|
| **Без виводу** | Тихе виконання (результат не публікується) |
| **Оголошення** | Публікувати результат у конкретний канал |
| **Webhook** | HTTP POST результату на зовнішній URL |

### Одноразові нагадування

Встановіть нагадування на конкретний час. Агент прокидається, обробляє нагадування та за потреби видаляє завдання після виконання.

### Повторювані завдання

Плануйте повторювані задачі з виразами cron та підтримкою часових поясів. Завдання відстежують свою історію виконання (успіх, помилка, час).

---

## Вебхуки

Отримуйте події від зовнішніх сервісів та направляйте їх до агентів.

### Gmail Pub/Sub

Інтеграція з системою push-сповіщень Gmail для ініціювання дій агента при надходженні листів:

1. Налаштуйте тему та підписку GCP Pub/Sub
2. Налаштуйте фільтрацію міток Gmail
3. Направте push-доставку на ваш URL вебхука
4. Neotask отримує повідомлення та додає події агента до черги

### Власні вебхуки

Реєструйте HTTP-кінцеві точки, які запускають хід агента при виклику. Корисно для інтеграції з CI/CD-конвеєрами, системами моніторингу або будь-яким сервісом, здатним надсилати HTTP-запити.

---

## Системні події

Системні події, це сигнали, які пробуджують агента для обробки:

- **Негайно**, Обробити при наступному пульсі
- **Наступний пульс**, Поставити в чергу для наступного запланованого перевірочного заходу

Використовуйте системні події для реактивних робочих процесів, агенти прокидаються, коли щось відбувається, а не за фіксованим розкладом.

---

## Пульс

Пульс, це периодичний сигнал (за замовчуванням ~15 секунд), що дає агентам можливість обробляти відкладену роботу:

- Перевіряти нові системні події
- Обробляти повідомлення в черзі
- Виконувати відкладені автоматизації

Пульс можна увімкнути, вимкнути або налаштувати для кожного агента окремо.

---

## Хуки

Автоматизація, керована подіями, яка запускає команди оболонки або скрипти у відповідь на події Gateway:

- **При повідомленні**, Виконати при отриманні повідомлення
- **При ході агента**, Виконати до або після обробки повідомлення агентом
- **При події каналу**, Виконати на специфічні події каналу (вхід, вихід, реакція)

Хуки виконуються на хості Gateway та мають доступ до контекстних даних події.

---

## Сценарії використання

| Сценарій | Рішення |
|----------|----------|
| Щоденний ранковий брифінг | Cron-завдання о 7 ранку → агент підсумовує нічні оновлення |
| Щотижневе генерування звіту | Cron-завдання щопонеділка → агент генерує та надсилає звіт на пошту |
| Моніторинг електронної пошти | Вебхук Gmail → агент обробляє вхідні листи |
| Сповіщення про збірку | Вебхук CI/CD → агент оголошує результати збірки в Discord |
| Щогодинна перевірка даних | Cron на основі інтервалу → агент перевіряє панель та попереджає про аномалії |
| Заплановані публікації в соцмережах | Cron-завдання → агент складає та публікує контент у оптимальний час |