Интеграция с 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

Поставете вашето widget ID

В администрацията на 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].

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