Configurare l'estensione Chatbot

Il Chatbot aggiunge un assistente basato sull'intelligenza artificiale alla tua app.
Il suo scopo è rispondere alle domande dei tuoi utenti in base al contenuto e al contesto della tua app, oltre che ai file che aggiungi. Ogni risposta è costruita a partire dalle informazioni che selezioni, garantendo che sia accurata, pertinente e coerente con il tema della tua app. In questo modo, gli utenti ottengono sempre risposte chiare e utili che si adattano perfettamente all'universo della tua app.

Per ottimizzare la configurazione del tuo assistente, comprendere il sistema dei crediti o perfezionare il comportamento dell'IA, ti consigliamo di leggere il nostro articolo sul blog: Best practice per configurare il tuo chatbot RAG con GoodBarber .

Il chatbot costruisce la sua base di conoscenza a partire dai contenuti che scegli all'interno della tua app e dai file che carichi.

Supporta quattro tipi di contenuti della tua app: articoli, eventi, punti sulla mappa e podcast.
Le fonti possono includere:
- i contenuti che crei nel CMS GoodBarber,
- i feed esterni che hai collegato,
- i file (PDF, DOCX, TXT o MD) che carichi nella scheda File delle impostazioni del Chatbot.

Hai il pieno controllo su ciò a cui il chatbot può accedere.
Per ogni sezione, definisci quanti elementi devono essere indicizzati e quali categorie saranno incluse nella base di conoscenza del chatbot. Scegli anche quali file può utilizzare e se i tuoi utenti possono aprirli o scaricarli.

Esempi di come può essere utilizzato il Chatbot:
Università o scuole: consenti agli studenti di porre domande su programmi, eventi o informazioni pratiche.
Media e blog: aiuta i lettori a ottenere risposte rapide basate sugli articoli che pubblichi.
Aziende: assisti i dipendenti che usano l'app come strumento interno (comunicazione, documentazione o formazione).
Enti turistici e organizzazioni locali: guida gli utenti in modo interattivo alla scoperta di luoghi, attività ed eventi.

Il Chatbot è un'estensione a pagamento, disponibile con tutti i piani GoodBarber.
Puoi abbonarti per 540€ all'anno o 45€ al mese.

Il chatbot funziona con un sistema a crediti.
Ogni abbonamento GoodBarber include 5.000 crediti al mese, rinnovati automaticamente.

I crediti vengono utilizzati per ogni azione eseguita dal chatbot:
- Indicizzazione di nuovi contenuti
- Trascrizione dell’audio dei podcast, se attivi questa opzione
- Elaborazione delle domande degli utenti
- Generazione di risposte

Se esaurisci i crediti prima della fine del mese, puoi acquistare dei crediti extra in qualsiasi momento contattando il nostro team di assistenza .
I crediti aggiuntivi costano 20€ per 5.000 crediti.
Monitoraggio dei crediti: per assicurarci che il tuo assistente non smetta mai di funzionare, ti inviamo un'e-mail di avviso quando ti resta solo il 20% dei crediti mensili. Questo ti dà il tempo di controllare il tuo utilizzo o di acquistare un pacchetto di crediti extra se necessario.
Questi crediti extra vengono aggiunti al tuo saldo e rimangono validi fino a quando non vengono utilizzati, indipendentemente da quando avverrà il tuo prossimo rinnovo mensile.

1. Vai all'Extension Store nel back office.
2. Abilita l'estensione Chatbot (ex Chatbot RAG).
Puoi provarla gratuitamente per 15 giorni prima di sottoscrivere l'abbonamento.
Una volta attivata, verrai reindirizzato alla pagina delle impostazioni del Chatbot.
Da lì, vai alla scheda Sezioni per iniziare a selezionare i contenuti che alimenteranno il tuo chatbot.

1. Vai in Chatbot (pannello a sinistra) > scheda Sezioni.
2. Attiva le sezioni in cui desideri che il chatbot indicizzi i contenuti.
Puoi abilitare sezioni dalle seguenti categorie: Articoli, Eventi, Mappa o Podcast.
3. Clicca su Salva per confermare la selezione.

I contenuti pubblicati nelle sezioni che hai abilitato verranno automaticamente indicizzati e utilizzati dal chatbot per rispondere alle domande dei tuoi utenti.

Sezioni podcast: puoi indicizzare i podcast creati nel CMS GoodBarber e anche i feed di podcast esterni. Per impostazione predefinita, il chatbot indicizza solo la descrizione degli episodi. Per sfruttare anche ciò che viene detto nei tuoi episodi, attiva la trascrizione automatica dell’audio dei podcast nella scheda Impostazioni (passaggio 6 sotto).

Usa la scheda File per aggiungere documenti alla base di conoscenza del tuo chatbot. Il tuo assistente potrà così rispondere alle domande usando informazioni che non sono pubblicate nella tua app.

1. Vai in Chatbot (pannello a sinistra) > scheda File.
2. Trascina i tuoi file nell'area di caricamento, oppure clicca su Scegli file.
- Formati accettati: PDF, DOCX, TXT, MD (Markdown)
- Dimensione massima: 25 MB per file
- Limite: 100 file per app

3. Per ogni file, scegli come viene utilizzato con l'opzione Accessibile agli utenti:
- Disattivata: il chatbot usa il contenuto del file per scrivere le sue risposte, ma i tuoi utenti non possono accedere al file.
- Attivata: il chatbot usa il contenuto del file per scrivere le sue risposte e condivide anche il file, che i tuoi utenti possono aprire o scaricare. Chiunque abbia il link può accedere al file, quindi attiva questa opzione solo per i documenti che vuoi condividere.

Per eliminare un file, clicca sull'icona del cestino nella colonna Azioni.

1. Vai in Chatbot (pannello a sinistra) > scheda Impostazioni.
Nella parte superiore della pagina puoi vedere quanti crediti ti restano e quando verranno rinnovati i crediti inclusi.

2. Scegli le opzioni disponibili nella chat:
- Domande suggerite: attiva questa opzione e inserisci fino a tre domande di esempio. Appaiono come pulsanti cliccabili sotto il messaggio di benvenuto quando un utente apre una conversazione vuota. È un modo semplice per mostrare ai tuoi utenti cosa può fare il tuo assistente. Puoi personalizzare il titolo di questi suggerimenti nella scheda Design (campo Titolo delle domande suggerite).
- Schede interattive delle fonti: mostra delle schede sotto le risposte dell’assistente, così i tuoi utenti possono accedere rapidamente agli articoli, agli eventi, ai punti sulla mappa, ai documenti e ai podcast utilizzati come fonti.
- Copia dei messaggi della conversazione: aggiungi un pulsante di copia a ogni messaggio, così i tuoi utenti possono copiarne il testo negli appunti.

3. Definisci il tono di scrittura
Usa il campo Tono di scrittura per impostare il tono che l’assistente applica a ogni risposta: livello di cortesia, stile di scrittura o modo di rivolgersi ai tuoi utenti. Serve principalmente a definire linee guida stilistiche.

4. Limita l'accesso alla sezione Chatbot (facoltativo)
Se utilizzi le estensioni Sistema di abbonamenti o Autenticazione, puoi limitare l'accesso:
Estensione Sistema di abbonamenti: attiva l'opzione per rendere il chatbot disponibile solo agli abbonati a pagamento.
I non abbonati saranno reindirizzati alla pagina di abbonamento.
Estensione Autenticazione: attiva l'opzione, quindi vai al menu Community > Pubblico/Privato per rendere la sezione privata.
Puoi anche limitare l'accesso per gruppo di utenti se l'estensione Gruppi di utenti è abilitata.
Gli utenti che non hanno effettuato l'accesso verranno reindirizzati alla pagina di accesso o di registrazione.

5. Regola le Impostazioni avanzate (facoltativo)
Clicca su Impostazioni avanzate per aprire il pannello.

Modello di generazione
I modelli più avanzati forniscono risposte di qualità superiore e più naturali, ma consumano più crediti.

Modello di indicizzazione
Questo modello legge e indicizza i tuoi contenuti (articoli, eventi, punti sulla mappa, podcast e file) e li converte in un formato che il chatbot può utilizzare per trovare le informazioni più rilevanti.
Versione Large: più accurata, ma consuma più crediti.
Versione Small: più economica.
In breve: il modello di indicizzazione costruisce la base di conoscenza del chatbot e il modello di generazione scrive le risposte.

Trascrivi automaticamente l’audio dei podcast
Attiva questa opzione per indicizzare anche il contenuto audio dei tuoi episodi podcast.
Poi scegli il modello di trascrizione: OpenAI - Whisper o Mistral - Voxtral Mini Transcribe 2 (un fornitore di IA europeo).
Il modello selezionato si applica solo alle nuove trascrizioni: cambiarlo non trascrive di nuovo gli episodi già trascritti.
Formati audio supportati: MP3, WAV, M4A, FLAC, OGG.

Limite di elementi per flusso
Questo parametro definisce quanti elementi verranno indicizzati dai feed delle sezioni che hai abilitato nella scheda Sezioni (passaggio 4 sopra).
Il valore predefinito è 100, che rappresenta un ottimo punto di partenza per testare il tuo chatbot senza consumare troppi crediti durante l'indicizzazione iniziale. Tuttavia, se la tua app dispone di una libreria di contenuti più ampia, dovresti aumentare questo valore in un secondo momento per garantire una base di conoscenza più completa. Tieni presente che aumentare questo limite comporterà un maggiore consumo di crediti durante la prima indicizzazione dei tuoi contenuti.

6. Salva le impostazioni.

I nuovi elementi, gli aggiornamenti dei contenuti e i file caricati vengono indicizzati automaticamente ogni 2 ore: un nuovo file può quindi richiedere fino a 2 ore prima di essere utilizzato dal chatbot.

Nota: estensione Sistema di abbonamenti
Quando l'estensione Sistema di abbonamenti è attiva, le risposte del chatbot dipendono dallo stato dell'abbonamento dell'utente:
- Abbonati: il chatbot può utilizzare tutti i contenuti indicizzati.
- Non abbonati: il chatbot analizza tutti i contenuti indicizzati per selezionare le informazioni più rilevanti, ma le sue risposte includono solo il testo di anteprima gratuito. Ciò gli consente di consigliare contenuti premium relativi alla domanda, mantenendo protetti i contenuti a pagamento.

1. Vai in Chatbot (pannello a sinistra) > scheda Design.
2. Personalizza l'aspetto della sezione Chatbot:
- Scegli i colori e i caratteri degli elementi della sezione.
- Modifica il nome e l'immagine dell'avatar del tuo assistente.
- Scrivi i diversi messaggi che appariranno nella sezione Chatbot.
3. Clicca su Salva per applicare le modifiche al design.

Le app che includono contenuti generati dall'intelligenza artificiale devono fornire agli utenti un modo per segnalare o contrassegnare le conversazioni direttamente dall'app.
Nella tua app, gli utenti possono segnalare una conversazione se la ritengono inappropriata o errata.
Tutte le conversazioni segnalate sono elencate in Chatbot (pannello a sinistra) > scheda Segnalazioni.

Utilizza queste segnalazioni per rivedere e moderare il comportamento del tuo chatbot:
- Aggiorna i contenuti della tua app, se necessario.
- Modifica il tono di scrittura nella scheda Impostazioni per perfezionare la formulazione delle risposte dell’assistente.
- Escludi o modifica contenuti specifici, oppure elimina un file dalla scheda File, se non devono far parte della base di conoscenza del chatbot.

Utilizza il campo di ricerca nella parte superiore della pagina per trovare rapidamente segnalazioni specifiche.