Интеграция с Wagtail

ИИ-ассистент, который отвечает на вопросы на вашем сайте Wagtail

Обзор

Пакет для Wagtail ставит на ваш сайт ИИ-ассистента. Кнопка чата находится в углу каждой страницы, посетители задают вопрос своими словами, а ответ берётся из вашего собственного содержимого: вашего сайта, загруженных документов и статей справки.

Предупреждение об ИИ: Ответы на вашем сайте создаёт ИИ. Иногда они бывают неточными или неполными. Проверяйте их, прежде чем на них полагаться, особенно в важных решениях.

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

Пакет добавляет middleware, который ставит один небольшой скрипт прямо перед закрывающим тегом body на каждой странице. Скрипт ждёт, пока страница загрузится, и только потом забирает виджет чата у Asyntai, поэтому ваш сайт отрисовывается первым и скорость страницы не меняется. Ваш сервер никогда не обращается к Asyntai, это делает только браузер посетителя.

В шаблонах вы не меняете ничего. Middleware не трогает административную панель Wagtail и не трогает всё, что не является HTML-страницей.

Требования

Аккаунт Asyntai. Для начала достаточно бесплатного тарифа.
Сайт на Wagtail версии 5.2 или новее, на Django 4.2 или новее и Python 3.9 или новее.
Доступ к коду этого сайта, потому что вы устанавливаете пакет Python.

Установка

Выполните эти шаги, чтобы добавить Asyntai на ваш сайт Wagtail:

Установите пакет

Установите его из Python Package Index, в том же окружении, где работает ваш сайт:

pip install wagtail-ai-chatbot

Добавьте его в настройки

Добавьте приложение и модуль настроек Wagtail в INSTALLED_APPS, а middleware в начало MIDDLEWARE:

INSTALLED_APPS = ["wagtail_asyntai", "wagtail.contrib.settings", ...]

MIDDLEWARE = ["wagtail_asyntai.middleware.AsyntaiWidgetMiddleware", ...]

Выполните миграцию

Она создаёт таблицу, в которой хранятся ваши настройки:

python manage.py migrate wagtail_asyntai

Вставьте идентификатор виджета

В панели Wagtail откройте Settings, затем Asyntai chat assistant. Вставьте свой ID виджета и нажмите Save. ID вы найдёте в своей панели Asyntai в разделе Setup & Integration. Можно вставить весь фрагмент кода, пакет оставит только ID.

Совет: Добавьте свои документы, вопросы и ответы и указания в панели Asyntai до публикации, чтобы помощник правильно ответил уже первому посетителю.

Настройки

ID виджета: чат работает, пока в этом поле стоит правильный ID, и выключен, когда поле пустое.
Показывать чат только вышедшим посетителям: вошедшие пользователи чат никогда не увидят. Это удобно, когда ассистент нужен для тех, кто ещё не зарегистрировался.
Адрес скрипта виджета: оставьте это значение как есть, если поддержка Asyntai не попросит его изменить.

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

Настройки в файле настроек

Проект, который держит настройки в переменных окружения, может обойтись без панели и задать значения в коде. Если заполнено и то и другое, побеждает панель.

ASYNTAI_WIDGET_ID = "asyntai_ab12cd34"

Ещё три значения необязательны: ASYNTAI_SHOW_TO_ANONYMOUS_ONLY, ASYNTAI_SCRIPT_URL и ASYNTAI_SKIP_PREFIXES. Последнее перечисляет пути, которые виджет никогда не трогает, и нужно, когда ваша панель находится не на /admin/.

Как поставить виджет вручную

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

{% load asyntai %} ... {% asyntai_widget %}

Что умеет ассистент

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

Конфиденциальность

Пакет публикует на странице ровно два значения: ID виджета и адрес скрипта. Ничего о ваших страницах и о ваших пользователях в Asyntai не передаётся. С Asyntai общается только браузер посетителя и только тогда, когда посетитель откроет чат.

Тарифы и цены

Интеграция с Wagtail доступна на всех тарифах Asyntai, включая бесплатный. Каждый тариф включает месячный объём сообщений, общий для всех ваших каналов и интеграций. Посмотреть цены.

Удаление

Очистите поле с ID виджета, чтобы выключить чат. Чтобы убрать пакет, уберите middleware и приложение из настроек и удалите его командой pip.

Исходный код

Пакет свободный и с открытым кодом, под лицензией MIT. Вы можете прочитать каждую строку на GitHub.

Нужна помощь?

Если у вас есть вопросы или возникли проблемы, свяжитесь с нами по адресу [email protected].

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