Веб-интерфейс (Web UI)/Уведомления, вебхуки и расписания
Уведомления, вебхуки и расписания
v1.3.x · обновлено 2026-09-15
Эта страница описывает три экрана веб-интерфейса, отвечающих за исходящую
автоматизацию и оповещения администратора: Уведомления, Вебхуки и
Расписания.
Уведомления
Экран «Уведомления» состоит из трёх частей:
Инбокс — лента событий с фильтрами по категории, важности (info / warning /
critical) и «только непрочитанные». Клик по элементу отмечает его прочитанным и
ведёт на соответствующую вкладку; есть «Прочитать всё».
Матрица доставки — строки: категории событий (группы и раскрывающиеся
события), столбцы: каналы (веб-интерфейс, электронная почта, Telegram, push).
В каждой ячейке — чекбокс; можно задавать правило на группу или на отдельное
событие. «Важные» группы всегда включены для веб-интерфейса. Неактивные
каналы отключены с подсказкой.
Примеры, чтобы оценить ожидаемую частоту каждой категории и канал доставки:
Категория
Пример события
Типичная частота
Куда обычно доставлять
Безопасность
вход администратора
несколько раз в день
веб-интерфейс + почта
Обновления
доступно обновление ядра
несколько раз в месяц
веб-интерфейс + Telegram
Работоспособность
упал/восстановился дополнительный сервис
редко, но срочно
все каналы
Биллинг/лицензия
лицензия обновлена
редко
веб-интерфейс
Привязка Telegram — список привязанных чатов (метка, значок блокировки,
«Отвязать») и кнопка «Привязать» по deep-link. Канал электронной почты
требует подтверждения адреса.
Вебхуки
Экран «Вебхуки» — исходящие HTTP-уведомления. «+ Создать»: URL и чекбоксы
событий (мультивыбор; пустой выбор не принимается, по умолчанию отмечен
turn.completed). В строках — URL и подписанные события, есть поиск и
сортировка. Тип события передаётся в заголовке X-AIHummer-Event.
Экран «Расписания» — планировщик задач: таблица (задача, агент, канал, cron,
следующий запуск, статус) с паузой/возобновлением, редактированием и удалением.
«+ Создать»:
Тип: repeating (cron-выражение, например 0 9 * * *), once (дата/время)
или reminder.
Целевой агент и промпт (что именно отправить), целевой канал (куда
уйдёт ответ). Расширенно — переопределение сырого JSON-payload.
Так вы делаете плановые действия: «каждый будний день в 9:00 агент X отправляет в
канал Y результат по промпту Z».
Расширенные параметры запуска
Помимо repeating, once и reminder, через админ-API (/v1/admin/schedules)
доступен тип interval — запуск каждые interval_ms миллисекунд от точки
отсчёта anchor_at. В поле «Дополнительно (JSON-нагрузка)» к обычному
prompt можно добавить блок runtime (обязательны "version": 1,
session_mode и "wake_mode": "now"), который задаёт условия выполнения:
session_mode — isolated (каждый запуск в новом диалоге) или existing
с conversation_id (продолжать указанный диалог);
timeout_seconds — срок одного запуска (по умолчанию 48 часов; 0
отключает таймер);
failure_alert — оповещение в канал (channel, target_ref.chat_id) после
after подряд неудачных запусков с паузой cooldown_ms;
delete_after_run — удалить определение после запуска (журнал запусков
сохраняется); best_effort — не считать неподтверждённую доставку ошибкой.
Такой запуск требует целевого агента и промпта. Расписания, импортированные из
другой системы, создаются на паузе и включаются отдельно владельцем; пока у них
есть неразрешённые зависимости, включить их нельзя.
Эта страница описывает три экрана веб-интерфейса, отвечающих за исходящую
автоматизацию и оповещения администратора: **Уведомления**, **Вебхуки** и
**Расписания**.
## Уведомления
Экран **«Уведомления»** состоит из трёх частей:
- **Инбокс** — лента событий с фильтрами по категории, важности (info / warning /
critical) и «только непрочитанные». Клик по элементу отмечает его прочитанным и
ведёт на соответствующую вкладку; есть «Прочитать всё».
- **Матрица доставки** — строки: категории событий (группы и раскрывающиеся
события), столбцы: каналы (веб-интерфейс, электронная почта, Telegram, push).
В каждой ячейке — чекбокс; можно задавать правило на группу или на отдельное
событие. «Важные» группы всегда включены для веб-интерфейса. Неактивные
каналы отключены с подсказкой.
Примеры, чтобы оценить ожидаемую частоту каждой категории и канал доставки:
| Категория | Пример события | Типичная частота | Куда обычно доставлять |
|---|---|---|---|
| Безопасность | вход администратора | несколько раз в день | веб-интерфейс + почта |
| Обновления | доступно обновление ядра | несколько раз в месяц | веб-интерфейс + Telegram |
| Работоспособность | упал/восстановился дополнительный сервис | редко, но срочно | все каналы |
| Биллинг/лицензия | лицензия обновлена | редко | веб-интерфейс |
- **Привязка Telegram** — список привязанных чатов (метка, значок блокировки,
«Отвязать») и кнопка **«Привязать»** по deep-link. Канал электронной почты
требует подтверждения адреса.
## Вебхуки
Экран **«Вебхуки»** — исходящие HTTP-уведомления. «+ Создать»: URL и **чекбоксы
событий** (мультивыбор; пустой выбор не принимается, по умолчанию отмечен
`turn.completed`). В строках — URL и подписанные события, есть поиск и
сортировка. Тип события передаётся в заголовке `X-AIHummer-Event`.
Доступны **20 типов событий**:
| Группа | События |
|---|---|
| Обработка и сообщения | `turn.completed`, `turn.failed`, `message.created`, `conversation.created` |
| Агенты | `agent.created`, `agent.updated`, `agent.deleted` |
| Плагины и каналы | `plugin.installed`, `plugin.removed`, `channel.added`, `channel.removed` |
| Пространства | `workspace.created` |
| Расписания | `schedule.created`, `schedule.updated`, `schedule.deleted`, `schedule.fired` |
| Одобрения | `approval.requested`, `approval.resolved` |
| Память | `memory.stored`, `memory.captured` |
## Расписания
Экран **«Расписания»** — планировщик задач: таблица (задача, агент, канал, cron,
следующий запуск, статус) с паузой/возобновлением, редактированием и удалением.
«+ Создать»:
- **Тип**: `repeating` (cron-выражение, например `0 9 * * *`), `once` (дата/время)
или `reminder`.
- **Целевой агент** и **промпт** (что именно отправить), **целевой канал** (куда
уйдёт ответ). Расширенно — переопределение сырого JSON-payload.
Так вы делаете плановые действия: «каждый будний день в 9:00 агент X отправляет в
канал Y результат по промпту Z».
### Расширенные параметры запуска
Помимо `repeating`, `once` и `reminder`, через админ-API (`/v1/admin/schedules`)
доступен тип **`interval`** — запуск каждые `interval_ms` миллисекунд от точки
отсчёта `anchor_at`. В поле **«Дополнительно (JSON-нагрузка)»** к обычному
`prompt` можно добавить блок `runtime` (обязательны `"version": 1`,
`session_mode` и `"wake_mode": "now"`), который задаёт условия выполнения:
- `session_mode` — `isolated` (каждый запуск в новом диалоге) или `existing`
с `conversation_id` (продолжать указанный диалог);
- `timeout_seconds` — срок одного запуска (по умолчанию 48 часов; `0`
отключает таймер);
- `thinking` — усилие рассуждения (`off` … `xhigh`), `light_context` —
облегчённый контекст, `tools_allow` — точные имена разрешённых инструментов;
- `failure_alert` — оповещение в канал (`channel`, `target_ref.chat_id`) после
`after` подряд неудачных запусков с паузой `cooldown_ms`;
- `delete_after_run` — удалить определение после запуска (журнал запусков
сохраняется); `best_effort` — не считать неподтверждённую доставку ошибкой.
Такой запуск требует целевого агента и промпта. Расписания, импортированные из
другой системы, создаются на паузе и включаются отдельно владельцем; пока у них
есть неразрешённые зависимости, включить их нельзя.
## Что дальше
- [Каналы](/v1.0/webui/channels) — куда уходят сообщения и уведомления.
- [Входящие и триггеры](/v1.0/api/inbound-triggers) — вебхуки в контексте API.
- [Наблюдаемость](/v1.0/operations/observability) — какие события важны.