Integrazione Wagtail
Un assistente IA che risponde alle domande sul tuo sito Wagtail
Panoramica
Il pacchetto Wagtail mette un assistente IA sul tuo sito. Un pulsante di chat sta nell'angolo di ogni pagina, i visitatori fanno la domanda con parole loro, e la risposta arriva dai tuoi contenuti: il tuo sito web, i documenti che hai caricato e i tuoi articoli di aiuto.
Avviso sull'IA: Le risposte sul tuo sito web sono generate da un'IA. A volte possono essere imprecise o incomplete. Controllale prima di fidarti, soprattutto per decisioni importanti.
Come funziona
Il pacchetto aggiunge un middleware che mette un piccolo script subito prima del tag di chiusura body di ogni pagina. Lo script aspetta che la pagina finisca di caricare, poi prende il widget di chat da Asyntai, così il tuo sito viene disegnato per primo e la velocità della pagina non cambia. Il tuo server non parla mai con Asyntai; lo fa solo il browser del visitatore.
Non cambi nulla nei tuoi template. Il middleware lascia stare l'amministrazione di Wagtail, e lascia stare tutto ciò che non è una pagina HTML.
Requisiti
- Un account Asyntai. Il piano gratuito è sufficiente per iniziare.
- Un sito Wagtail, versione 5.2 o più recente, con Django 4.2 o più recente e Python 3.9 o più recente.
- L'accesso al codice di quel sito, perché installi un pacchetto Python.
Installazione
Segui questi passaggi per aggiungere Asyntai al tuo sito Wagtail:
Installa il pacchetto
Installalo dal Python Package Index, nello stesso ambiente del tuo sito:
pip install wagtail-ai-chatbot
Aggiungilo alle impostazioni
Aggiungi l'applicazione e il modulo delle impostazioni di Wagtail a INSTALLED_APPS, e il middleware in cima a MIDDLEWARE:
INSTALLED_APPS = ["wagtail_asyntai", "wagtail.contrib.settings", ...]
MIDDLEWARE = ["wagtail_asyntai.middleware.AsyntaiWidgetMiddleware", ...]
Esegui la migrazione
Questo crea la tabella che tiene le tue impostazioni:
python manage.py migrate wagtail_asyntai
Incolla l'ID del tuo widget
Nell'amministrazione di Wagtail apri Settings e poi Asyntai chat assistant. Incolla il tuo ID del widget e scegli Save. Trovi l'ID nella tua dashboard Asyntai sotto Setup & Integration. Puoi incollare tutto lo snippet; il pacchetto tiene solo l'ID.
Suggerimento: Aggiungi i tuoi documenti, le tue domande e risposte e le tue istruzioni nella dashboard Asyntai prima di pubblicare, così l'assistente risponde bene già al primo visitatore.
Impostazioni
- ID del widget: la chat è attiva finché questo campo contiene un ID valido, e spenta quando è vuoto.
- Mostra la chat solo ai visitatori non collegati: gli utenti che hanno fatto l'accesso non vedono mai la chat. Utile quando l'assistente serve a rispondere a chi non si è ancora iscritto.
- Indirizzo dello script del widget: lascia questo valore com'è, a meno che il supporto Asyntai ti chieda di cambiarlo.
Le impostazioni sono per sito, quindi un progetto che serve più siti da una sola installazione Wagtail può dare a ogni sito il proprio assistente.
Impostazioni nel tuo file di impostazioni
Un progetto che tiene la configurazione nelle variabili d'ambiente può saltare l'amministrazione e mettere i valori nel codice. Se sono pieni entrambi, vince l'amministrazione.
ASYNTAI_WIDGET_ID = "asyntai_ab12cd34"
Altri tre valori sono facoltativi: ASYNTAI_SHOW_TO_ANONYMOUS_ONLY, ASYNTAI_SCRIPT_URL e ASYNTAI_SKIP_PREFIXES. L'ultimo elenca i percorsi che il widget non tocca mai, e serve quando la tua amministrazione non sta su /admin/.
Mettere il widget a mano
Se preferisci scegliere tu il punto, lascia fuori il middleware e metti il tag nel tuo template di base. Il tag e il middleware non scattano mai insieme, quindi puoi tenere entrambi.
{% load asyntai %} ... {% asyntai_widget %}
Che cosa sa fare l'assistente
- Rispondere subito alle domande dei visitatori, 24 ore su 24, su ogni pagina
- Rispondere in più di 80 lingue, riconosciute automaticamente dalla domanda
- Restare aperto mentre il visitatore passa da una pagina all'altra
- Usare i vostri documenti, le FAQ e le istruzioni per dare risposte precise
Privacy
Il pacchetto pubblica esattamente due valori sulla pagina: l'ID del widget e l'indirizzo dello script. Niente sulle tue pagine o sui tuoi utenti viene inviato ad Asyntai. Solo il browser del visitatore parla con Asyntai, e solo quando il visitatore apre la chat.
Piani e prezzi
L'integrazione Wagtail è disponibile su tutti i piani Asyntai, anche su quello gratuito. Ogni piano include un numero mensile di messaggi condiviso fra tutti i tuoi canali e tutte le tue integrazioni. Visualizza i prezzi.
Disinstallazione
Svuota il campo dell'ID del widget per spegnere la chat. Per togliere il pacchetto, leva il middleware e l'applicazione dalle impostazioni e disinstallalo con pip.
Codice sorgente
Il pacchetto è libero e open source, con licenza MIT. Puoi leggere ogni riga su GitHub.
Hai bisogno di aiuto?
Se hai domande o riscontri problemi, contattaci a [email protected].