CHIEDIMI è un servizio fruibile tramite API che funge da intermediario tra l’LLM fornito da OpenAI ed il software del Sito/Blog/Portale del Cliente per l’implementazione di ‘Assistenti Virtuali’.
Grazie al ‘Pannello di Controllo‘, fornito a seguito della sottoscrizione di una licenza, è possibile creare e gestire delle KNOWLEDGE BASE (d’ora in poi KB). Saranno queste KB ad essere utilizzate dall’LLM per generare le risposte.
Una KB non è altro che un insieme di frasi che descrivono, in italiano ed in linguaggio naturale, il contesto che l’LLM dovrà prendere in considerazione. Una KB è anche definita Rule Set (insieme di regole).
Un esempio di KB (scherzoso, per l’occasione) potrebbe essere questo:
Sei un esperto di uccelli. Rispondi solamente sulla base delle seguenti informazioni.
Ci sono tre tipi di uccelli: quelli rossi, quelli verdi e quelli bianchi.
I rossi si nutrono di semi, i verdi di insetti, i bianchi di qualsiasi cosa sia commestibile.
I rossi volano, i verdi nuotano, i bianchi riposano sulla poltrona.
I rossi preferiscono giocare tra loro, i verdi adorano beccare i piedi dei bagnanti ed i bianchi preferiscono giocare a Ramino.
Il sabato sera tutti e tre i tipi di uccelli si incontrano al Pub per giocare a Poker.
Utilizzando l’icona in basso a destra per interagire con CHIEDIMI e richiedere informazioni, potrai testare la flessibilità delle risposte dell’assistente. La KB utilizzata per questa istanza è esattamente quella descritta sopra.
Pannello di controllo
Accedendo al PANNELLO DI CONTROLLO è possibile creare, modificare e testare le KB prima della loro distribuzione.
Il pannello è diviso verticalmente in due sezioni principali:
- quella di sinistra raccoglie tutte le regole definite, indipendentemente dal Rule Set per il quale sono state generate
- quella di destra raccoglie tutti i Rule Set con l’elenco delle regole collegate.
Una singola regola può essere utilizzata in più Rule Set permettendo di definire KB simili in tempi rapidissimi.
Normalmente è preferibile frazionare la KB in più Rule Set se le regole necessarie per la gestione del contesto globale sono diverse decine o centinaia diminuendo così l’utilizzo di token e semplificando le operazioni di verifica del Rule Set.
Questo frazionamento, eseguito con criterio, permette di utilizzare un Rule Set dedicato al contesto di pagina, per esempio un Rule Set con KB tecnica per le pagine di supporto ed un Rule Set con KB illustrativa dedicato alla sezione prodotti.
Il plugin per WordPress
Lavoro quasi zero per chi ha un sito WordPress. E’ disponibile un plugin che si fa carico di tutte le richieste e della gestione degli errori e delle eccezioni.
L’area in basso (“Scrivi un messaggio…”) è quella dedicata alla scrittura delle richieste dell’Cliente. Per inviare la richiesta è sufficiente dare INVIO sulla tastiera o fare click sul pulsante “Invia”
Per l’installazione del plugin procedere come segue:
- vai su Pannello di Controllo e genera una Secret Key (se non l’hai ancora fatto)
- annota il codice di tutti i Rule Set che intendi utilizzare
- vai sul tuo portale
- per scrupolo esegui un backup dei files e del database (esistono diversi plugin che ti permettono di farlo con pochi click
- installa il plugin (l’indirizzo del repository privato lo trovi sulla documentazione che dovresti aver ricevuto alla sottoscrizione della licenza)
- attivalo
- vai su Impostazioni/Plugin Chiedimi
- inserisci la Secret Key
- seleziona l’immagine che utilizzerai per l’attivazione dell’assistente
- imposta il titolo della finestra
- imposta la pausa tra una parola e l’altra nella risposta dell’assistente (inizia lasciando il default, potrai sempre variare dopo)
- configura gli assistenti per le pagine per le quali desideri sia presente, attivando lo switch e selezionando per ognuna il Rule Set adatto (può essere utilizzato anche lo stesso se hai optato per una KB monolitica)
- Salva le modifiche
- Da questo momento l’assistente CHIEDIMI è operativo.
Il Client generico
Come alternativa al plugin per WordPress è stato preparato un client generico composto da 3 moduli PHP che richiede PHP 7 o superiore, nessun supporto a database ed una manciata di kilobyte disponibili (~30 KB) sul server/spazio web dove è installato il tuo Portale.
