L'IA nella tua app

La tabella qui sotto è il piano di questa guida. Leggila per prima: evita tre quarti delle scelte sbagliate.

Una frase per tenere ferma la distinzione: il chatbot RAG sa quello che hai pubblicato, l'estensione ChatGPT sa quello che il modello ha imparato. Il primo non può rispondere su un argomento che non hai mai trattato. Il secondo risponderà lo stesso, ed è a volte esattamente quello che non vuoi.

I due possono convivere nella stessa app. Un assistente di conversazione generale nella pagina iniziale e un chatbot documentario nella sezione archivio non sono in concorrenza.

RAG sta per retrieval-augmented generation. Il principio sta in una frase: prima di rispondere, l'assistente va a cercare i passaggi pertinenti nei tuoi contenuti, e scrive la sua risposta a partire da quei passaggi.

È la differenza tra un assistente che conosce il tuo argomento e un assistente che conosce il tuo. Per un archivio di dieci anni di articoli, una guida di viaggio, un manuale interno o una base di domande frequenti, è l'unica forma che regge: le risposte restano nei confini di quello che hai scritto, e invecchiano allo stesso ritmo.

Il chatbot è un'estensione prima di essere una sezione, e l'ordine conta. Tutto parte dalla voce RAG Chatbot del menu principale, al primo livello tra Notification e Statistics: è lì che aggiungi l'estensione, e solo dopo averla aggiunta la sezione diventa disponibile nella tua app. Cercarla nella lista delle sezioni prima di passare di lì significa non trovarla.

Una volta a posto, si comporta come qualsiasi altra sezione: prende il suo posto nel tuo menu, conta nelle tue 120 sezioni, e adotta i colori e la tipografia della tua app.

Le sue impostazioni si aprono dalla stessa voce di menu, su una schermata con quattro schede: impostazioni, design, sezioni di origine e report.

È l'impostazione che decide la qualità del tuo chatbot, ed è anche quella che si liquida in fretta.

La scheda Sections elenca le tue, ordinate per tipo di contenuto: i tuoi articoli, i tuoi eventi, i tuoi luoghi. Spunti quelle che devono alimentare la base di conoscenza, e puoi scendere fino al livello di categoria: tutta la sezione Articoli, oppure solo la categoria Pratica.

Tutto quello che pubblichi in quelle sezioni successivamente ci entra automaticamente. Non c'è nessun pulsante di aggiornamento da ricordare, nessun export da rifare: la tua base di conoscenza segue quello che pubblichi.

Un'ultima impostazione completa il quadro: un tetto al numero di elementi conservati da ogni fonte selezionata, a partire dal più recente. Alzarlo dà all'assistente più materiale e consuma più crediti. Un editore che pubblica ogni giorno e una guida di viaggio stabile non hanno bisogno dello stesso valore.

Due modelli si impostano separatamente, e non fanno lo stesso lavoro.

Il modello di generazione è quello che scrive la risposta. La lista va dai modelli più recenti fino alle loro varianti Mini e Nano, più rapide e più frugali. Comprende modelli OpenAI e modelli Mistral, il che ti permette di restare su un'infrastruttura europea quando la cosa ti sta a cuore.

Il modello di indicizzazione è quello che trasforma i tuoi contenuti in qualcosa su cui la ricerca può lavorare. La sua versione grande gestisce meglio i testi lunghi e sfumati; la sua versione economica è più rapida e consuma meno.

La regola pratica: parti da una variante economica, misura la qualità delle risposte sulle tue domande reali, e sali se non ci sei. Fare il contrario costa soldi per niente.

Un campo di tono di scrittura ti permette di descrivere come l'assistente si rivolge ai tuoi lettori: il livello di formalità, lo stile. Quel campo non serve ad aggiungere conoscenza, serve a fissare la voce.

Porta però l'istruzione più utile di tutta la schermata: quella che dice che cosa rispondere quando la risposta non è nei tuoi contenuti. Senza, un assistente spesso preferisce improvvisare piuttosto che ammetterlo. Scrivila esplicitamente: digli di dire che non lo sa e di rimandare alla tua pagina dei contatti. Una frase, e il tuo chatbot smette di inventare.

Due interruttori decidono che cosa compare sotto le risposte. Le schede di fonte interattive mostrano l'articolo, l'evento o il luogo da cui è stata costruita la risposta, e il lettore lo apre con un gesto. Un secondo interruttore aggiunge un pulsante di copia su ogni messaggio della conversazione.

Guarda quella risposta: non è solo corretta, dice da dove viene. Ogni ricetta citata porta il suo link all'articolo, e la fila di schede sotto la conversazione riporta il lettore dentro il contenuto. È la differenza visibile tra un assistente che attinge da te e un assistente che parla a memoria.

Attiva le schede di fonte. Fanno tre cose insieme: dimostrano che la risposta viene davvero da te, riportano il lettore dentro i tuoi contenuti invece di lasciarlo nella conversazione, e ti danno un modo per controllare il tuo chatbot con un colpo d'occhio.

Un'opzione di restrizione dell'accesso chiude il chatbot ai visitatori di passaggio e lo riserva a chi è connesso o abbonato. Si appoggia su una delle due famiglie di accesso della piattaforma, l'estensione di abbonamento integrato o l'estensione Authentication, quindi una delle due deve essere attiva nella tua app.

Quelle due famiglie non si sommano: è la biforcazione descritta in «Animare una community con la tua app», e si decide prima, non dopo. Se la tua app vive di un abbonamento integrato, è da lì che passa la restrizione.

È un buon candidato per i contenuti riservati. Un assistente che conosce dieci anni del tuo archivio ha un valore che un lettore coglie subito, cosa che raramente vale per un articolo in più.

Il chatbot RAG è un'estensione, e la sua scheda mostra il prezzo che si applica alla tua app. Comprende un volume di crediti, rinnovato ogni mese, e un contatore in cima alla schermata mostra il saldo residuo insieme alla data del prossimo rinnovo. Il volume incluso è su quella stessa scheda.

Due cose consumano quei crediti, e non nelle stesse proporzioni. Indicizzare i tuoi contenuti costa poco e avviene una volta, poi a ogni pubblicazione. Le domande dei tuoi utenti costano il resto, e il loro consumo dipende dal modello scelto e dalla complessità della domanda. In altre parole, il tuo conto segue il tuo pubblico: è una buona notizia, a patto di averla vista arrivare.

L'altro tipo di assistente non legge i tuoi contenuti. Innesta un'istanza di ChatGPT nella tua app, e sei tu a darle un ruolo.

Come ogni estensione, la sua scheda mostra il prezzo che si applica alla tua app, e funziona su entrambe le linee di prodotto, sia sulle app di contenuti sia su quelle di e-commerce.

Come il chatbot RAG, è un'estensione prima di essere una sezione, e vale lo stesso ordine: la attivi prima in Extensions Store › All extensions, e la sezione compare nella lista dei tipi solo dopo. Troverai poi lo stato di tutte le tue estensioni in Extensions Store › Management.

Le sue impostazioni si aprono dal menu della sezione, tramite la voce che configura l'assistente. La sua schermata ha solo due schede, impostazioni e design, mentre il chatbot RAG ne ha quattro. È la differenza di natura, visibile a occhio nudo.

La prima differenza è proprio lì, e non è da poco. Un blocco di accesso a OpenAI ti chiede una chiave API segreta, che crei sul tuo account OpenAI. Il rapporto commerciale resta tra te e OpenAI: GoodBarber non fa pagare nulla sulle conversazioni e non trattiene nulla al passaggio.

Che cosa significa in pratica: apri un account presso OpenAI, ci metti un metodo di pagamento, e segui i consumi dalla loro dashboard, non dal tuo back office. Alcuni modelli recenti richiedono inoltre che la tua organizzazione sia verificata presso OpenAI, cosa che la schermata segnala.

Solo tre campi, e il terzo porta tutto il resto. Inserisci il nome dell'assistente, scegli un modello di generazione da una lista che va dal più recente al più economico, e poi scrivi il messaggio di sistema.

Quel testo è l'unica cosa che separa il tuo assistente da un ChatGPT qualunque. Ne descrive il ruolo, il tono e soprattutto la gamma di argomenti che accetta di trattare. Un assistente a cui non è stato detto di che cosa parla parlerà di tutto, comprese cose che non vuoi nella tua app.

Scrivilo in due parti. Prima il ruolo, detto semplicemente: chi è, a chi parla, su quale argomento. Poi la chiusura, altrettanto importante: che cosa deve rispondere quando la domanda esce dall'argomento. È quella seconda metà che ci si dimentica, ed è quella che tiene l'assistente nella sua corsia.

Come il chatbot RAG, l'estensione ChatGPT si può riservare ai tuoi utenti connessi, tramite la stessa opzione di restrizione, e il suo aspetto si imposta nella scheda del design.

Discende direttamente dal suo funzionamento: questo assistente non conosce i tuoi contenuti. Non sa che cosa hai pubblicato ieri, né i tuoi orari, né i tuoi prezzi, né il nome della tua nuova collezione. Se un utente glielo chiede, risponderà lo stesso, con quello che il modello crede di sapere.

Il messaggio di sistema riduce quel rischio, non lo elimina. Riserva quindi questa estensione agli usi in cui la risposta non deve essere per forza tua: un assistente che consiglia, che riformula, che accompagna qualcuno ai primi passi. Non appena la risposta deve essere esatta e verificabile, quello che ti serve è il chatbot RAG.

La questione si risolve su una sola riga: la risposta deve venire da te?

Tre esempi per fissare la regola.

Un centro educativo. Paraigua pubblica i suoi calendari, il suo regolamento e le sue circolari. Le stesse domande tornano ogni anno, nelle stesse date, e ognuna ha già la sua risposta scritta da qualche parte. È il caso da manuale per il RAG: il materiale esiste, è solo mal raggiungibile.

Una guida di viaggio. Portland descrive luoghi, eventi, percorsi. Un visitatore che chiede «che cosa è aperto la domenica mattina vicino al porto» chiede una cosa a cui il contenuto risponde, ma che nessun menu gli permette di formulare. Di nuovo RAG.

Un salone di bellezza. Freyja Spa non ha un corpus di documenti, ma ha clienti che esitano tra due trattamenti. Un assistente inquadrato da un messaggio di sistema, che fa due o tre domande e indirizza verso il servizio giusto, è utile senza dover conoscere il catalogo a memoria. L'estensione ChatGPT basta, e non costa niente di più.

Il chatbot RAG esiste solo sulle app di contenuti. Un'app di e-commerce oggi non può attivarlo. Su quella linea resta disponibile l'estensione ChatGPT.

Un chatbot risponde bene solo se i tuoi contenuti rispondono. È il limite che più spesso si scopre troppo tardi. Un assistente innestato su trenta articoli vaghi produce trenta risposte vaghe, e rende visibile un problema di contenuto che passava inosservato finché nessuno faceva la domanda in modo diretto. Prima di attivarlo, rileggi quello che pubblichi e chiediti se un lettore ci troverebbe la sua risposta. Se no, è il contenuto da lavorare, non il modello.

Resti responsabile di quello che dice la tua app. Un assistente parla a tuo nome, nella tua app, con i tuoi colori. Provalo con le tue domande reali prima di pubblicare, comprese quelle scomode, e tieni l'istruzione che gli dice di ammettere quello che non sa. Un assistente che risponde «non lo so, scrivici» non ti costa niente. Un assistente che inventa i tuoi orari ti costa un cliente.