Vissza az irányítópultra

Dokumentáció

Ismerd meg az Asyntai használatát

Wagtail integráció

MI asszisztens, amely megválaszolja a kérdéseket a Wagtail webhelyén

Ugrás az irányítópultra

Áttekintés

A Wagtail csomag MI asszisztenst tesz a webhelyére. Egy csevegőgomb ül minden oldal sarkában, a látogatók a saját szavaikkal kérdeznek, a válasz pedig a saját tartalmából jön: a webhelyéről, a feltöltött dokumentumaiból és a súgócikkeiből.

MI-figyelmeztetés: A webhelyén adott válaszokat MI állítja elő. Néha pontatlanok vagy hiányosak lehetnek. Ellenőrizze őket, mielőtt rájuk hagyatkozik, különösen fontos döntéseknél.

Hogyan működik

A csomag egy köztes réteget ad hozzá, amely egy kis szkriptet tesz minden oldal záró body címkéje elé. A szkript megvárja, amíg az oldal betölt, és csak utána hozza el a csevegőelemet az Asyntaitól, így a webhelye rajzolódik ki elsőként, és az oldal sebessége nem változik. A kiszolgálója soha nem beszél az Asyntaival, csak a látogató böngészője.

A sablonjaiban semmit nem módosít. A köztes réteg békén hagyja a Wagtail vezérlőpultját, és békén hagy mindent, ami nem HTML oldal.

Követelmények

  • Egy Asyntai fiók. Az ingyenes csomag elég a kezdéshez.
  • Wagtail webhely 5.2-es vagy újabb változatban, Django 4.2-es vagy újabb és Python 3.9-es vagy újabb verzión.
  • Hozzáférés a webhely kódjához, mert egy Python csomagot telepít.

Telepítés

Kövesse ezeket a lépéseket, hogy hozzáadja az Asyntait a Wagtail webhelyéhez:

1

Telepítse a csomagot

Telepítse a Python Package Indexből, ugyanabba a környezetbe, ahol a webhelye fut:

pip install wagtail-ai-chatbot
2

Vegye fel a beállításokba

Vegye fel az alkalmazást és a Wagtail beállításmodult az INSTALLED_APPS listába, a köztes réteget pedig a MIDDLEWARE elejére:

INSTALLED_APPS = ["wagtail_asyntai", "wagtail.contrib.settings", ...]
MIDDLEWARE = ["wagtail_asyntai.middleware.AsyntaiWidgetMiddleware", ...]
3

Futtassa a migrációt

Ez létrehozza a táblát, amely a beállításait tartja:

python manage.py migrate wagtail_asyntai
4

Illessze be a widget ID értékét

A Wagtail vezérlőpultján nyissa meg a Settings, majd az Asyntai chat assistant pontot. Illessze be a widget azonosítóját, és válassza a Save lehetőséget. Az azonosítót az Asyntai vezérlőpultján találja a Setup & Integration résznél. Beillesztheti a teljes kódrészletet is, a csomag csak az azonosítót tartja meg.

Tipp: Közzététel előtt add hozzá dokumentumaidat, kérdéseidet és válaszaidat, valamint utasításaidat az Asyntai vezérlőpultján, hogy a segéd már az első látogatónak is jól válaszoljon.

Beállítások

  • Widget azonosító: a csevegés addig működik, amíg ebben a mezőben érvényes azonosító áll, és ki van kapcsolva, ha a mező üres.
  • A csevegés csak kijelentkezett látogatóknak: a bejelentkezett felhasználók soha nem látják a csevegést. Hasznos, ha az asszisztens azoknak szól, akik még nem regisztráltak.
  • A widget szkript címe: hagyja ezt az értéket úgy, ahogy van, hacsak az Asyntai támogatása nem kéri a módosítását.

A beállítások webhelyenként külön élnek, így egy projekt, amely egy Wagtail telepítésből több webhelyet szolgál ki, mindegyiknek saját asszisztenst adhat.

Beállítások a beállításfájlban

Az a projekt, amely a beállításait környezeti változókban tartja, kihagyhatja a vezérlőpultot, és az értékeket kódban adhatja meg. Ha mindkettő ki van töltve, a vezérlőpult nyer.

ASYNTAI_WIDGET_ID = "asyntai_ab12cd34"

Három további érték nem kötelező: ASYNTAI_SHOW_TO_ANONYMOUS_ONLY, ASYNTAI_SCRIPT_URL és ASYNTAI_SKIP_PREFIXES. Az utolsó azokat az útvonalakat sorolja fel, amelyekhez a widget soha nem nyúl, és akkor kell, ha a vezérlőpultja nem az /admin/ címen van.

A widget kézi elhelyezése

Ha inkább maga választja ki a helyet, hagyja ki a köztes réteget, és tegye a címkét az alapsablonjába. A címke és a köztes réteg soha nem fut le mindkettő, ezért mindkettőt megtarthatja.

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

Mire képes az asszisztens

  • Azonnal megválaszolja a látogatók kérdéseit, éjjel-nappal, minden oldalon
  • Több mint 80 nyelven válaszol, a nyelvet a kérdésből automatikusan felismerve
  • Nyitva marad, miközben a látogató oldalról oldalra lép
  • A saját feltöltött dokumentumait, gyakori kérdéseit és utasításait használja a pontos válaszokhoz

Adatvédelem

A csomag pontosan két értéket tesz ki az oldalra: a widget azonosítóját és a szkript címét. Az oldalairól és a felhasználóiról semmi nem jut el az Asyntaihoz. Az Asyntaival csak a látogató böngészője beszél, és csak akkor, ha a látogató megnyitja a csevegést.

Csomagok és árak

A Wagtail integráció minden Asyntai csomagban elérhető, az ingyenesben is. Minden csomag havi üzenetkeretet tartalmaz, amelyen az összes csatornája és integrációja osztozik. Árak megtekintése.

Eltávolítás

Törölje a widget azonosító mezőjét a csevegés kikapcsolásához. A csomag eltávolításához vegye ki a köztes réteget és az alkalmazást a beállításokból, majd távolítsa el a pip paranccsal.

Forráskód

A csomag szabad és nyílt forráskódú, MIT licenc alatt. Minden sorát elolvashatja a GitHubon.

Segítségre van szükséged?

Ha bármilyen kérdésed van vagy problémába ütközöl, lépj kapcsolatba velünk a [email protected] e-mail-címen.