Usare l'Assistente AI nella Knowledge Base
Panoramica
L'assistente AI e un widget di chat integrato nella piattaforma che risponde a domande sulla documentazione, sulla configurazione e sull'uso del sistema POS. Utilizza un modello linguistico (Claude, Anthropic) combinato con il database documentale della Knowledge Base per fornire risposte contestuali e accurate.
Accesso all'Assistente
L'assistente AI e disponibile su piu canali della piattaforma:
| Canale | Interfaccia | Accesso |
|---|---|---|
| Console Admin | Widget FAB (pulsante flottante) in basso a destra | Tutti gli utenti admin |
| App Cassa | Overlay accessibile dal menu impostazioni | Operatori con permesso |
| App Cameriere | Overlay nella schermata impostazioni | Operatori con permesso |
| Sito Documentazione | Widget Docusaurus integrato | Utenti autenticati |
Il widget FAB (Floating Action Button) si presenta come un pulsante circolare con l'icona dell'assistente. Un clic apre la finestra di chat.
Selettore Audience
Prima di porre una domanda, e possibile selezionare l'audience di riferimento per ottenere risposte calibrate:
| Audience | Destinatario | Tipo di Risposte |
|---|---|---|
| Utente | Operatore cassa, cameriere | Istruzioni operative, procedure quotidiane |
| Admin | Amministratore del locale | Configurazione, gestione, reportistica |
| Installer | Tecnico installatore | Setup hardware, rete, troubleshooting |
| Developer | Sviluppatore | API, architettura, codice, integrazioni |
| Reseller | Distributore | Licensing, gestione clienti, manutenzione |
Il selettore audience si trova nella parte superiore della finestra di chat. L'audience influenza sia il linguaggio della risposta (tecnico vs semplificato) sia le fonti documentali consultate.
Come Porre Domande
Per ottenere risposte efficaci dall'assistente:
Domande Specifiche
Formulare domande precise e contestuali:
- "Come configuro una stampante fiscale Epson FP-81II su rete Ethernet?"
- "Qual e la procedura per aprire un turno cassa?"
- "Come importo prodotti da un file CSV?"
Domande da Evitare
L'assistente non e in grado di:
- Accedere ai dati operativi del punto vendita (ordini, vendite, clienti)
- Eseguire operazioni sul sistema (creare prodotti, modificare configurazioni)
- Rispondere su argomenti non correlati alla piattaforma POS
Revisione delle Fonti
Ogni risposta dell'assistente include i riferimenti alle fonti documentali utilizzate:
- I link alle pagine di documentazione citate sono visibili sotto la risposta
- Cliccando su un riferimento si apre la pagina completa nella documentazione
- Il numero di fonti consultate indica il livello di copertura della risposta
Se la risposta non cita fonti, significa che il topic potrebbe non essere ancora coperto dalla Knowledge Base.
Feedback
Il sistema di feedback permette di migliorare la qualita delle risposte nel tempo:
Valutazione
Sotto ogni risposta sono disponibili due pulsanti:
- Pollice su: la risposta e stata utile e accurata
- Pollice giu: la risposta non e soddisfacente o contiene errori
Effetto del Feedback
Il feedback viene registrato nel backend e utilizzato per:
- Identificare le domande frequenti senza copertura documentale
- Migliorare il ranking delle fonti nelle risposte future
- Segnalare agli autori gli articoli che necessitano di aggiornamento
- Generare metriche sulla qualita complessiva dell'assistente
Reset Conversazione
Per iniziare una nuova conversazione:
- Cliccare l'icona Reset (freccia circolare) nella barra superiore della chat
- La cronologia della conversazione corrente viene cancellata
- Il contesto viene azzerato per una nuova sessione
Il reset e consigliato quando si cambia argomento, per evitare che il contesto della conversazione precedente influenzi le risposte successive.
FAQ
D: L'assistente AI ha accesso ai miei dati di vendita? R: No, l'assistente consulta esclusivamente la Knowledge Base documentale. Non ha accesso ai dati operativi del punto vendita (ordini, clienti, vendite).
D: Le conversazioni con l'assistente vengono salvate? R: Le conversazioni sono mantenute solo per la durata della sessione. Al reset o alla chiusura del widget, la cronologia viene cancellata. Il feedback (pollice su/giu) viene invece salvato in forma anonima.
D: Posso contribuire alla Knowledge Base per migliorare le risposte? R: Si, gli utenti con ruolo "contributor" possono creare articoli nella Knowledge Base. Vedi la sezione Gestione Contenuti per il workflow editoriale.
Vedi Anche
- Gestione Contenuti -- Creazione e approvazione articoli
- Panoramica Console -- Navigazione console admin