Инструмент «Данные страницы» показывает ИИ то, что открыто у клиента на странице, — номер заказа, суммы, статус или время на оплату. Чат-виджет на вашем сайте читает выбранные вами элементы и передаёт их текст ИИ, когда клиент о них спрашивает. API не нужен.
Он нужен для страниц, которые наш сервер открыть не может. Страница заказа, которая загружается только у самого клиента, для парсера и скрейпера пустая: они заходят на неё как посторонние. Чат-виджет работает на странице самого клиента и видит то же, что и он.
Когда использовать «Данные страницы»
- Нужные сведения есть на странице, которая загружается только у клиента, — его заказ, бронь или личный кабинет, — и нет API, который мог бы вызвать ИИ.
- Клиент пишет в чат на сайте. В диалогах из Telegram, WhatsApp, Viber и почты данные страницы недоступны.
- Чат-виджет установлен на этих страницах.
Если страница публичная, проще подойдёт Webparser или Webscraper. Если у вас есть API, надёжнее всего API-интеграция.
Шаг 1 — Добавьте инструмент «Данные страницы»
Откройте Проекты → ваш проект → Интеграции. Создайте интеграцию для своего сайта: в базовом URL укажите адрес сайта, авторизация не нужна. Затем нажмите + Добавить инструмент и выберите Данные страницы.
- Название функции — имя, по которому ИИ вызывает инструмент, например
read_order_page. - Описание (показывается AI) — что возвращает инструмент и когда его использовать. Укажите, что он ничего не принимает на вход и что ИИ должен вызывать его, прежде чем просить у клиента номер заказа.
Шаг 2 — Выберите страницы и поля
Страницы — по одному шаблону на строку. Шаблон, который начинается с /, сравнивается с путём страницы, а шаблон с https:// — с полным адресом. * заменяет одну часть пути, ** — что угодно: /orders/** подходит для /orders/ORD-12345. Если адреса начинаются с языка, например /ru/orders/…, используйте /*/orders/**.
Поля для чтения — у каждого поля есть Название (под каким именем ИИ увидит текст), Ключ (заполняется сам) и CSS-селектор элемента. Чтобы найти селектор, нажмите на элемент на своей странице правой кнопкой и выберите «Просмотреть код». Выбирайте устойчивое имя класса или элемента, а не длинный сгенерированный путь. Можно добавить до 20 полей.
Для начала хорошо подходит одно поле на весь блок заказа. ИИ хорошо понимает текст вида «название — значение», а широкое поле продолжает работать, когда страница меняет состояние: оплачен, просрочен, выполнен.
Шаг 3 — Проверьте на копии страницы
Наш сервер не может открыть такие страницы, поэтому проверка идёт на копии. Откройте страницу в браузере так, как её видит клиент, нажмите на неё правой кнопкой и выберите «Просмотреть код», затем нажмите правой кнопкой на элемент <html> и выберите «Копировать» → «Копировать outerHTML». Вставьте код в поле Вставьте HTML страницы и нажмите Прочитать поля. Вставленный HTML остаётся в вашем браузере.
Для каждого поля видно, сколько элементов совпало и какой именно текст получит ИИ. Можно также указать URL страницы и проверить, что он подходит под ваши шаблоны.
Под проверкой, в поле Указания по обработке результата, объясните ИИ, как читать результат, — например: «Это страница заказа самого клиента. Если он спрашивает, куда платить, направьте его к реквизитам на странице заказа». Затем нажмите Сохранить.
Реквизиты для оплаты всегда удаляются
Адреса криптокошельков, номера карт и IBAN заменяются заглушкой вроде [crypto address hidden] ещё до того, как что-либо покинет браузер клиента, и ещё раз на нашем сервере. ИИ никогда не видит и не повторяет адрес для оплаты: если клиент спрашивает, куда отправить деньги, ИИ направляет его к реквизитам на его собственной странице заказа.
Это сделано намеренно. Известны вредоносные расширения браузера, которые подменяют адреса для оплаты на странице, и ИИ не должен подтверждать такой адрес.
Что вы видите в диалоге
В информационной панели диалога, в разделе Веб-сессия, блок Данные страницы показывает последний текст, прочитанный со страницы клиента, — тот же, что получает ИИ.
Как это работает
- Страница читается, когда она загрузилась, и ещё раз перед каждым сообщением клиента, поэтому ИИ отвечает по тому, что у клиента на экране.
- Свёрнутые разделы, например закрытая панель «Подробности», тоже читаются. Поля форм, в которые клиент вводит текст, не читаются никогда.
- Ограничения: 20 полей, до 2 000 символов в поле и до 8 000 символов всего. Каждое прочтение хранится 24 часа.
- Если клиент не находится на подходящей странице в том браузере, из которого пишет, ИИ получает сообщение, что данных страницы нет, и спрашивает сведения у клиента.
- Если на подходящей странице не найдено ни одного вашего поля — обычно после редизайна сайта, — в журнале аудита проекта (в настройках безопасности) появится событие «Интеграция ничего не вернула», чтобы вы обновили селекторы.
Какую интеграцию выбрать
- Данные есть в исходном коде страницы → Webparser.
- Публичная страница, которая заполняется через JavaScript → Webscraper.
- Страница загружается только у вошедшего клиента → Данные страницы.
- У вас есть API → API-интеграция.