System event
System event (системное событие) — сигнал от инфраструктуры, вбрасываемый в сессию ИИ вне потока сообщений от пользователя.
Общее
Сессия ИИ работает в режиме запрос-ответ. System event — это механизм прервать режим ожидания и передать агенту задачу: «сделай X сейчас».
Событие приходит не от пользователя, а от системы. Агент получает его как специальный вход — текстовое сообщение или структурированный инъект — и обрабатывает в своём контексте.
Типы событий
- Cron — срабатывание по расписанию (точное время, изолированная сессия).
- Heartbeat — периодический опрос (неточное время, main session).
- Внешний триггер — webhook, изменение файла, срабатывание датчика.
- Wake event — отложенный вызов (напоминание через N минут).
В сессии =
Системное событие вставляется в сессию через механизм payload.kind=systemEvent. Текст события становится частью контекста — агент видит его как сообщение и реагирует.
Отличие от обычного сообщения
| | Пользовательское сообщение | System event | |---|---|---| | Источник | Пользователь | Система | | Триггер | Действие пользователя | Расписание / условие | | Контекст | Зависит от сессии | Всегда доступен |