System event

System event (системное событие) — сигнал от инфраструктуры, вбрасываемый в сессию ИИ вне потока сообщений от пользователя.

Общее

Сессия ИИ работает в режиме запрос-ответ. System event — это механизм прервать режим ожидания и передать агенту задачу: «сделай X сейчас».

Событие приходит не от пользователя, а от системы. Агент получает его как специальный вход — текстовое сообщение или структурированный инъект — и обрабатывает в своём контексте.

Типы событий

• Cron — срабатывание по расписанию (точное время, изолированная сессия).
• Heartbeat — периодический опрос (неточное время, main session).
• Внешний триггер — webhook, изменение файла, срабатывание датчика.
• Wake event — отложенный вызов (напоминание через N минут).

В сессии =

Системное событие вставляется в сессию через механизм payload.kind=systemEvent. Текст события становится частью контекста — агент видит его как сообщение и реагирует.

Отличие от обычного сообщения

| | Пользовательское сообщение | System event | |---|---|---| | Источник | Пользователь | Система | | Триггер | Действие пользователя | Расписание / условие | | Контекст | Зависит от сессии | Всегда доступен |

Связанные понятия

• Heartbeat — периодическое событие в main session.
• Cron — событие по расписанию в isolated session.
• Сессия ИИ — событие вбрасывается в рамках сессии.