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
In the Wagtail admin, open Settings and then Asyntai chat assistant. Paste your widget ID and select Save. You find the ID in your Asyntai Dashboard under Setup & Integration. You can paste the whole snippet; the package keeps only the 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
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
The package is free and open source, under the MIT licence. You can read every line on GitHub.
Hai bisogno di aiuto?
If you have any questions or run into issues, contact us at [email protected].