Integrace s Wagtailem

Asistent s umělou inteligencí, který odpovídá na dotazy na vašem webu Wagtail

Přehled

Balíček pro Wagtail přidá na váš web asistenta s umělou inteligencí. Tlačítko chatu sedí v rohu každé stránky, návštěvníci se zeptají vlastními slovy a odpověď vychází z vašeho vlastního obsahu: z vašeho webu, z nahraných dokumentů a z článků nápovědy.

Upozornění k AI: Odpovědi na vašem webu tvoří umělá inteligence. Někdy mohou být nepřesné nebo neúplné. Ověřte si je, než se na ně spolehnete, hlavně u důležitých rozhodnutí.

Jak to funguje

Balíček přidá middleware, který vloží jeden malý skript těsně před uzavírací značku body na každé stránce. Skript počká, až se stránka načte, a teprve pak stáhne widget chatu z Asyntai. Váš web se tak vykreslí první a rychlost stránky se nemění. Váš server s Asyntai nikdy nekomunikuje, dělá to jen prohlížeč návštěvníka.

V šablonách neměníte nic. Middleware nechává administraci Wagtailu být a nechává být vše, co není HTML stránka.

Požadavky

Účet Asyntai. Na začátek stačí bezplatný tarif.
Web na Wagtailu verze 5.2 nebo novější, na Djangu 4.2 nebo novějším a Pythonu 3.9 nebo novějším.
Přístup ke kódu toho webu, protože instalujete balíček pro Python.

Instalace

Podle těchto kroků přidáte Asyntai na svůj web Wagtail:

Nainstalujte balíček

Nainstalujte ho z Python Package Indexu, ve stejném prostředí jako váš web:

pip install wagtail-ai-chatbot

Přidejte ho do nastavení

Přidejte aplikaci a modul nastavení Wagtailu do INSTALLED_APPS a middleware na začátek MIDDLEWARE:

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

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

Spusťte migraci

Ta vytvoří tabulku, která drží vaše nastavení:

python manage.py migrate wagtail_asyntai

Vložte své widget ID

V administraci Wagtailu otevřete Settings a pak Asyntai chat assistant. Vložte své ID widgetu a zvolte Save. ID najdete ve svém panelu Asyntai v sekci Setup & Integration. Můžete vložit celý úryvek kódu, balíček si vezme jen ID.

Tip: Před publikováním přidejte své dokumenty, otázky a odpovědi a pokyny v přehledu Asyntai, aby asistent správně odpověděl už prvnímu návštěvníkovi.

Nastavení

ID widgetu: chat běží, dokud je v tomto poli platné ID, a je vypnutý, když je pole prázdné.
Zobrazit chat jen odhlášeným návštěvníkům: přihlášení uživatelé chat nikdy neuvidí. Hodí se, když má asistent odpovídat lidem, kteří se ještě nezaregistrovali.
Adresa skriptu widgetu: tuto hodnotu nechte tak, jak je, pokud vás podpora Asyntai nepožádá o změnu.

Nastavení je zvlášť pro každý web, takže projekt, který z jedné instalace Wagtailu obsluhuje více webů, může dát každému webu vlastního asistenta.

Nastavení v souboru nastavení

Projekt, který drží konfiguraci v proměnných prostředí, může administraci vynechat a nastavit hodnoty v kódu. Když jsou vyplněná obě místa, vyhrává administrace.

ASYNTAI_WIDGET_ID = "asyntai_ab12cd34"

Další tři hodnoty jsou nepovinné: ASYNTAI_SHOW_TO_ANONYMOUS_ONLY, ASYNTAI_SCRIPT_URL a ASYNTAI_SKIP_PREFIXES. Poslední jmenuje cesty, kterých se widget nikdy nedotkne, a potřebujete ji, když vaše administrace neběží na /admin/.

Umístění widgetu ručně

Pokud si chcete místo vybrat sami, middleware vynechte a vložte značku do své základní šablony. Značka a middleware nikdy nezaberou obě, takže si můžete nechat obojí.

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

Co asistent umí

Odpovídat na dotazy návštěvníků okamžitě, nepřetržitě, na každé stránce
Odpovídat ve více než 80 jazycích, které rozpozná automaticky z dotazu
Zůstat otevřený, když návštěvník přechází ze stránky na stránku
Používat vaše nahrané dokumenty, časté dotazy a pokyny pro přesné odpovědi

Ochrana osobních údajů

Balíček zveřejní na stránce přesně dvě hodnoty: ID widgetu a adresu skriptu. Nic o vašich stránkách ani o vašich uživatelích se do Asyntai neposílá. S Asyntai mluví jen prohlížeč návštěvníka, a to až když návštěvník chat otevře.

Tarify a ceny

Integrace s Wagtailem je dostupná ve všech tarifech Asyntai včetně bezplatného. Každý tarif obsahuje měsíční počet zpráv, který sdílíte napříč všemi kanály a integracemi. Zobrazit ceník.

Odinstalování

Vymažte pole s ID widgetu, tím chat vypnete. Balíček odstraníte tak, že vyjmete middleware a aplikaci z nastavení a odinstalujete ho příkazem pip.

Zdrojový kód

Balíček je svobodný a s otevřeným kódem, pod licencí MIT. Každý řádek si můžete přečíst na GitHubu.

Potřebujete pomoc?

Máte-li jakékoli dotazy nebo narazíte na problémy, kontaktujte nás na [email protected].

Dokumentace