> ## Documentation Index
> Fetch the complete documentation index at: https://docs.hubtalk.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Наблюдатели

> Детекторы событий разговора, реакции агента на них и бэкенд решений.

# Наблюдатели

Наблюдатели непрерывно следят за разговором и реагируют на важные события, не замедляя работу агента. Один наблюдатель обнаруживает **одно** событие и запускает действия, когда оно происходит.

Наблюдатели — раздел карточки **«Качество и интеграции»** в настройках агента. В строке **«Наблюдатели»** видно число правил; щелчок по строке открывает окно **«Качество и интеграции»** на этом разделе. Навигация слева переключает разделы окна: рядом — [аналитика после звонка](https://docs.hubtalk.ai/ru/v4/platform/agent-settings/analytics.md), [задачи агента](https://docs.hubtalk.ai/ru/v4/platform/agent-settings/goals.md) и [вебхуки](https://docs.hubtalk.ai/ru/v4/platform/agent-settings/webhooks.md).

**Как сохраняются изменения.** Список наблюдателей агента помечен **«Применяется сразу»**: он сохраняется сразу, не входит в черновик и не требует публикации. Общие настройки проверок правятся в копии: их записывает в черновик кнопка **«Сохранить»** окна, а при закрытии окна с несохранёнными правками появляется вопрос **«Отменить изменения?»**.

## Наблюдатели агента

В шапке раздела две кнопки:

* **«Из библиотеки»** — подключает готовый детектор из библиотеки компании.
* **«Новый Observer»** — создаёт свой детектор для этого агента или для библиотеки. Кнопка в кабинете так и называется, по-английски, хотя сам раздел и форма детектора — по-русски.

Наблюдатели агента — карточки под заголовком **«Наблюдатели агента»**. На карточке: переключатель, который включает или выключает наблюдателя у этого агента, название и ключ события, бейджи с категорией, важностью, правилом срабатывания и уровнем и строка **«ТО»** с мягкими и жёсткими действиями. Справа — **«Тест»**, карандаш, который открывает наблюдателя, и меню **⋯** с пунктами **«Сделать локальную копию»** (для детектора из библиотеки) и **«Отвязать»**.

![Наблюдатели агента в «Качестве и интеграциях»: карточка наблюдателя с метками и реакциями](https://mintcdn.com/hubtalk/a331JpdbHdrN3bAm/images/v4_settings_observers_then.png?fit=max\&auto=format\&n=a331JpdbHdrN3bAm\&q=85\&s=af5fa8c73c187a19bf2b46b18828689e)

**«Evaluation: общие настройки проверок»** — параметры, общие для всех наблюдателей агента: **«Мин. интервал между проверками, с»**. Значение 0 проверяет каждый ход диалога. У realtime-агента на Gemini 3.1 Live, которому подсказку посреди сессии не передать, в блоке есть ещё **«Запасной путь для realtime (подсказку в сессию не вставить)»**.

## Бэкенд решений

Обычно каждую проверку наблюдателей оценивает LLM — на каждом ходе, хотя событие почти никогда не происходит. Блок **«Бэкенд решений»** под списком наблюдателей ставит перед LLM **модель решений** — модель System One (Jev). Она не пишет вердикт, а только оценивает, насколько вероятно каждое событие. Блок появляется, когда к агенту подключён хотя бы один наблюдатель.

**«Режим»** выбирается из четырёх вариантов:

* **«Как на сервере»** — по умолчанию. Агент следует умолчанию платформы; на платформе по умолчанию режим выключен.
* **«Выкл.»** — каждую проверку оценивает LLM, как раньше.
* **«Теневой»** — каждая проверка дополнительно уходит модели решений в фоне. Её вероятности и то, что каскад пропустил бы, попадают в события звонка; вердикты и подсказки не меняются. Режим нужен, чтобы проверить модель на своих звонках, ничего не меняя.
* **«Каскад»** — модель решений отсеивает проверки: если вероятность всех событий группы ниже порога, проверка считается чистой без вызова LLM. Иначе LLM оценивает её с тем же входом, что в выключенном режиме.

Вердикт, уверенность, цитата и подсказка агенту всегда остаются за LLM, поэтому правила срабатывания, реакции и инциденты работают как прежде. Если модель решений не ответила вовремя или ошиблась, проверку оценивает LLM.

Если режим не выключен, появляются остальные поля:

* **«Модель решений»** — запись справочника моделей с ролью «decision». Без выбранной записи публикация заблокирована. Запись замораживается в опубликованной версии.
* **«Порог уверенности»** — только для каскада: проверка уходит LLM, когда вероятность события любого наблюдателя достигает этого значения. Пустое поле — значение платформы (по умолчанию 0,02). Держите порог низким: выше 0,05 растут пропуски нарушений.
* **«Таймаут, мс»** — сколько может идти один вызов модели решений; ответ агента его не ждёт. Пустое поле — значение платформы (по умолчанию 1500 мс).

У realtime-агентов наблюдатели оцениваются без бэкенда решений — блок предупреждает, что режим там не действует.

> [!NOTE]
>
> **Включайте каскад только после теневого режима.** Сначала посмотрите на живых звонках, какая доля проверок обошлась бы без LLM и какие нарушения каскад пропустил бы — по каждому наблюдателю.

## Редактор наблюдателя

Редактор наблюдателя открывается поверх окна. Кнопка **«Назад к наблюдателям»** в его шапке возвращает к списку; рядом с заголовком — уровень: **«Агент · локальный»** (только этот агент) или **«Библиотека · общий»** (общий для компании); выбрать его можно только при создании. В редакторе две колонки — **«КОГДА»** и **«ТО»**.

### КОГДА — что обнаруживать

* **«Ключ события»** — уникальный идентификатор из строчных латинских букв, цифр и подчёркиваний, например `do_not_call`. Он задаёт тип инцидента и не переименовывается.
* **«Название»** — понятное имя события, которое видно в интерфейсе.
* **«Категория»** — **«Соответствие правилам»**, **«Безопасность»**, **«Продажи»**, **«Разговор»** или **«Другое»**.
* **«Важность»** — **«Информация»**, **«Предупреждение»** или **«Критично»**. Это те же три уровня, которые в Истории и Инцидентах показаны как низкая, средняя и высокая.
* **«Когда срабатывает»** — **«Один раз за звонок»** или **«Повторно»**.
* **«Описание события (бизнес-правила)»** — свободный текст: что искать и какие подсказки давать агенту. Роль аудитора и строгий формат ответа встроены в систему, описывать их не нужно.
* **«Контекст оценки»** — **«Последний ход диалога»**, **«Последние N ходов»** или **«Весь разговор»**. Поле **«N ходов диалога»** доступно только для «Последних N ходов».
* **«Область наблюдения»** — что слушает наблюдатель: **«только клиент»**, **«только агент»** или **«весь диалог»**. Она задаётся у каждого наблюдателя отдельно, поэтому два наблюдателя одного агента могут следить за разными сторонами.
* **«Модель детектора»** — модель, которая обнаруживает событие.

У детектора из библиотеки компании часть «КОГДА» редактирует владелец; у агента настраивается только реакция.

![Редактор наблюдателя: слева «Когда» — что обнаруживать, справа «То» — как реагирует агент](https://mintcdn.com/hubtalk/a331JpdbHdrN3bAm/images/v4_settings_observers_when.png?fit=max\&auto=format\&n=a331JpdbHdrN3bAm\&q=85\&s=b03755894210c406b057e8d67c5ce5c9)

### ТО — как реагировать

Реакция принадлежит **этому** агенту: другие агенты с тем же детектором могут реагировать иначе.

* **«Мягкие действия»** — реакции, не останавливающие сценарий: **«Коррекция агенту»**, **«Запись инцидента и лог»**, **«Флаг на ревью»**, **«Уведомление»** и **«Метки (через запятую)»** — непустой список меток включает простановку метки.
* **«Жёсткие действия (opt-in)»** — включаются вручную: **«Перевод на человека»** (с полем **«Куда переводить»**), **«Завершение звонка»** (с полем **«Прощальная фраза»**), **«Пауза агента»**.
* **«Порог уверенности»** — минимальная уверенность детектора, при которой реакция срабатывает.
* **«N детектов подряд»** — требует обнаружить событие указанное число раз подряд.
* **«Проверка человеком»** — переключатель: вместо автоматического действия событие уходит в очередь разбора с уведомлением.
* **«Проверить наблюдателя»** — прогон детектора на разговоре, чтобы убедиться, что обнаружение и реакция работают.
* **«Сохранить»** / **«Отмена»**.

> [!WARNING]
>
> **У жёсткого действия обязан быть порог.** Кабинет не даст сохранить перевод, завершение звонка или паузу агента без ограничителя — нужна важность **«Критично»**, порог уверенности, не меньше двух детектов подряд или проверка человеком. Это защита от ложных срабатываний: жёсткое действие по одному неуверенному вердикту обрывало бы живые разговоры.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.