Документация

Осведомлённость о странице

Осведомлённость о странице позволяет вашему ИИ-агенту знать, на какой странице сейчас находится посетитель. Это даёт более релевантные, контекстные ответы и предоставляет более богатый контекст при эскалации на живых операторов.

Осведомлённость о странице работает только с веб-виджетом. В Telegram и других мессенджер-каналах нет понятия «текущая страница».

Обзор#

Когда функция включена, виджет автоматически собирает URL текущей страницы посетителя, заголовок и описание. Этот контекст внедряется в системный промпт ИИ, позволяя ему адаптировать ответы в зависимости от того, где просматривает пользователь.

Контекст страницы

Агент видит URL, заголовок и meta-описание текущей страницы

Контекст эскалации

Живые операторы получают информацию о текущей странице посетителя при эскалации

Как это работает#

Виджет захватывает контекст страницы автоматически — никаких изменений кода на вашем сайте не требуется. Вот что собирается с каждым сообщением:

ДанныеИсточникПример
URL страницыwindow.location.hrefhttps://example.com/pricing
Заголовок страницыdocument.titleТарифы — Acme Corp
Путьwindow.location.pathname/pricing
Описаниеmeta[name=description]Сравните наши тарифы
Реферерdocument.referrerhttps://google.com

Пример: что видит агент#

Когда посетитель на странице /pricing спрашивает «Сколько это стоит?», системный промпт агента включает:

Внедряется в системный промптtext
PAGE CONTEXT (where the user is right now):
- Page: Pricing — Acme Corp
- Path: /pricing
- Description: Compare our plans and pricing

Use this page context to provide more relevant, page-specific answers.

Настройка#

Осведомлённость о странице — функция с явным включением (opt-in). Чтобы её включить:

  1. Перейдите в Каналы и выберите свой канал Виджет
  2. На панели настроек/внешнего вида канала включите переключатель Осведомлённость о странице («Виджет сообщает агенту, на какой странице находится посетитель»)
  3. Сохраните изменения
Изменения кода встраивания виджета не нужны. Виджет автоматически отправляет контекст страницы, как только функция включена для агента.

Контекст эскалации#

Когда диалог эскалируется на живого оператора, письмо-уведомление об эскалации автоматически включает контекст текущей страницы посетителя. Живой оператор видит, где именно просматривал посетитель, без необходимости спрашивать.

Письмо об эскалации включает:

Письмо об эскалации

Тема: [YourBrand] Conversation Escalated

Заголовок: «Case #123 needs a human» (или «A customer needs a human», когда номера кейса нет)

Тело: «A customer has been transferred to a human agent. Please review and respond.» — далее цитируемый блок с последним сообщением клиента и его именем

Таблица фактов: Channel: Widget · Page: Pricing — Acme Corp · Page URL: https://example.com/pricing

Open conversation — кнопка со ссылкой прямо на диалог в дашборде

Контекст страницы при эскалации включается автоматически, когда включена Осведомлённость о странице — отдельного переключателя нет.

Устранение неполадок#

Если Осведомлённость о странице не работает, проверьте следующее:

Агент даёт общие ответы, игнорируя текущую страницу

Убедитесь, что Осведомлённость о странице включена для вашего канала Виджет (Каналы → Виджет → панель настроек/внешнего вида) и что изменения сохранены. По умолчанию функция отключена.

В письме об эскалации нет раздела с контекстом страницы

Убедитесь, что Осведомлённость о странице включена на вашем канале Виджет и сохранена. Также проверьте, что переключатель Оповещения об эскалации включён в настройках агента (по умолчанию он выключен). Письма-оповещения приходят участникам вашего рабочего пространства — назначенному участнику или команде назначения — согласно настройкам уведомлений каждого участника; отдельного email-адреса для эскалации не существует.

Заголовок страницы показывает неверное значение

Виджет читает document.title в момент отправки пользователем сообщения. Если ваш сайт обновляет заголовок после первичной отрисовки (например, асинхронно), виджет захватывает то, что установлено на момент отправки.