AiHummer
Русский
ВойтиЛичный кабинет
v1.3.x
{ }Swagger

Уведомления, вебхуки и расписания

v1.3.x · обновлено 2026-09-15

Эта страница описывает три экрана веб-интерфейса, отвечающих за исходящую автоматизацию и оповещения администратора: Уведомления, Вебхуки и Расписания.

Уведомления

Экран «Уведомления» состоит из трёх частей:

  • Инбокс — лента событий с фильтрами по категории, важности (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_modeisolated (каждый запуск в новом диалоге) или existing с conversation_id (продолжать указанный диалог);
  • timeout_seconds — срок одного запуска (по умолчанию 48 часов; 0 отключает таймер);
  • thinking — усилие рассуждения (offxhigh), light_context — облегчённый контекст, tools_allow — точные имена разрешённых инструментов;
  • failure_alert — оповещение в канал (channel, target_ref.chat_id) после after подряд неудачных запусков с паузой cooldown_ms;
  • delete_after_run — удалить определение после запуска (журнал запусков сохраняется); best_effort — не считать неподтверждённую доставку ошибкой.

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

Что дальше