Integracja z Wagtail
Asystent AI, który odpowiada na pytania na Twojej stronie Wagtail
Przegląd
Pakiet Wagtail umieszcza na Twojej stronie asystenta AI. Przycisk czatu siedzi w rogu każdej strony, odwiedzający zadają pytanie własnymi słowami, a odpowiedź pochodzi z Twoich własnych treści: Twojej strony, wgranych dokumentów i artykułów pomocy.
Zastrzeżenie dotyczące AI: Odpowiedzi na Twojej stronie tworzy AI. Czasem mogą być niedokładne lub niepełne. Sprawdź je, zanim na nich polegniesz, zwłaszcza przy ważnych decyzjach.
Jak to działa
Pakiet dodaje middleware, który umieszcza jeden mały skrypt tuż przed zamykającym znacznikiem body na każdej stronie. Skrypt czeka, aż strona się wczyta, a potem pobiera widżet czatu z Asyntai, więc Twoja strona rysuje się pierwsza, a szybkość strony się nie zmienia. Twój serwer nigdy nie rozmawia z Asyntai; robi to tylko przeglądarka odwiedzającego.
Nie zmieniasz nic w swoich szablonach. Middleware nie rusza panelu administracyjnego Wagtail i nie rusza niczego, co nie jest stroną HTML.
Wymagania
- Konto Asyntai. Darmowy plan wystarczy na początek.
- Strona Wagtail w wersji 5.2 lub nowszej, na Django 4.2 lub nowszym i Pythonie 3.9 lub nowszym.
- Dostęp do kodu tej strony, ponieważ instalujesz pakiet Pythona.
Instalacja
Wykonaj te kroki, aby dodać Asyntai do swojej strony Wagtail:
Zainstaluj pakiet
Zainstaluj go z Python Package Index, w tym samym środowisku co Twoja strona:
pip install wagtail-ai-chatbot
Dodaj go do ustawień
Dodaj aplikację i moduł ustawień Wagtail do INSTALLED_APPS, a middleware na początek MIDDLEWARE:
INSTALLED_APPS = ["wagtail_asyntai", "wagtail.contrib.settings", ...]
MIDDLEWARE = ["wagtail_asyntai.middleware.AsyntaiWidgetMiddleware", ...]
Uruchom migrację
To tworzy tabelę, która przechowuje Twoje ustawienia:
python manage.py migrate wagtail_asyntai
Wklej swoje widget ID
W panelu Wagtail otwórz Settings, a potem Asyntai chat assistant. Wklej swój identyfikator widżetu i wybierz Save. Identyfikator znajdziesz w swoim panelu Asyntai w sekcji Setup & Integration. Możesz wkleić cały fragment kodu; pakiet zachowa tylko identyfikator.
Wskazówka: Dodaj swoje dokumenty, pytania i odpowiedzi oraz instrukcje w panelu Asyntai przed publikacją, aby asystent dobrze odpowiedział już pierwszemu odwiedzającemu.
Ustawienia
- Identyfikator widżetu: czat działa, dopóki pole zawiera poprawny identyfikator, i jest wyłączony, gdy pole jest puste.
- Pokazuj czat tylko wylogowanym odwiedzającym: zalogowani użytkownicy nigdy nie widzą czatu. Przydatne, gdy asystent ma odpowiadać osobom, które jeszcze się nie zarejestrowały.
- Adres skryptu widżetu: zostaw tę wartość bez zmian, chyba że wsparcie Asyntai poprosi Cię o jej zmianę.
Ustawienia są osobne dla każdej witryny, więc projekt obsługujący kilka witryn z jednej instalacji Wagtail może dać każdej witrynie własnego asystenta.
Ustawienia w pliku ustawień
Projekt, który trzyma konfigurację w zmiennych środowiskowych, może pominąć panel i ustawić wartości w kodzie. Gdy wypełnione są oba miejsca, wygrywa panel.
ASYNTAI_WIDGET_ID = "asyntai_ab12cd34"
Trzy kolejne wartości są opcjonalne: ASYNTAI_SHOW_TO_ANONYMOUS_ONLY, ASYNTAI_SCRIPT_URL i ASYNTAI_SKIP_PREFIXES. Ostatnia wymienia ścieżki, których widżet nigdy nie dotyka, i jest potrzebna, gdy Twój panel nie stoi pod /admin/.
Ręczne umieszczenie widżetu
Jeśli wolisz sam wybrać miejsce, pomiń middleware i wstaw znacznik do szablonu bazowego. Znacznik i middleware nigdy nie działają razem, więc możesz zostawić oba.
{% load asyntai %} ... {% asyntai_widget %}
Co potrafi asystent
- Odpowiadać na pytania odwiedzających od razu, całą dobę, na każdej stronie
- Odpowiadać w ponad 80 językach, rozpoznawanych automatycznie na podstawie pytania
- Pozostawać otwartym, gdy odwiedzający przechodzi ze strony na stronę
- Korzystać z Twoich dokumentów, pytań i odpowiedzi oraz instrukcji, aby udzielać trafnych odpowiedzi
Prywatność
Pakiet publikuje na stronie dokładnie dwie wartości: identyfikator widżetu i adres skryptu. Nic o Twoich stronach ani o Twoich użytkownikach nie trafia do Asyntai. Tylko przeglądarka odwiedzającego rozmawia z Asyntai i tylko wtedy, gdy odwiedzający otworzy czat.
Plany i ceny
Integracja z Wagtail jest dostępna we wszystkich planach Asyntai, także w darmowym. Każdy plan zawiera miesięczny limit wiadomości wspólny dla wszystkich Twoich kanałów i integracji. Zobacz cennik.
Odinstalowanie
Wyczyść pole z identyfikatorem widżetu, aby wyłączyć czat. Aby usunąć pakiet, wyjmij middleware i aplikację z ustawień i odinstaluj go poleceniem pip.
Kod źródłowy
Pakiet jest wolny i otwarty, na licencji MIT. Każdą linię możesz przeczytać na GitHubie.
Potrzebujesz pomocy?
Jeśli masz pytania lub napotkasz problemy, skontaktuj się z nami pod adresem [email protected].