Інтеграція з 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.

Потрібна допомога?

Якщо у вас є запитання або виникли проблеми, зв'яжiться з нами за адресою [email protected].

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