Questa sezione è pensata per chi visita il sito e vuole usare l'assistente.
Cos'è l'assistente
È un chatbot con intelligenza artificiale che risponde alle tue domande basandosi solo sui contenuti del sito di WP Demo 1 PROD e sui documenti caricati nella sua Knowledge Base (la sua "base di conoscenza").
- Non inventa risposte: se un'informazione non è presente nelle fonti, te lo dice apertamente invece di indovinare.
- Le regole di base anti-invenzione (anti-allucinazione) sono sempre attive e non possono essere disattivate.
- Quando è possibile, indica da dove proviene l'informazione (pagina o documento).
Come si usa
- Scrivi la tua domanda nel campo di testo in basso.
- Premi Invio oppure il pulsante Invia per inviare.
- Usa Shift + Invio per andare a capo senza inviare (utile per domande su più righe).
- Attendi la risposta: durante l'elaborazione vedrai dei puntini (…).
L'assistente risponde nella lingua in cui gli scrivi: se fai la domanda in italiano risponde in italiano, se la fai in un'altra lingua risponde in quella lingua.
Sessione e privacy
- Nessun login richiesto. Puoi usare l'assistente subito, senza registrarti.
- La sessione è collegata a un identificativo di sessione anonimo generato in modo casuale e salvato solo nel tuo browser (in
localStorage). Non contiene il tuo nome né dati personali.
- Se svuoti i dati del browser o usi un altro dispositivo, viene creato un nuovo identificativo e la cronologia precedente non viene richiamata.
- Le conversazioni e i relativi dati tecnici (compreso l'indirizzo IP) sono registrati per il periodo stabilito dal gestore del sito e poi cancellati automaticamente. Per i dettagli su come vengono trattati i dati fai riferimento all'informativa privacy del sito.
Buone pratiche per domande efficaci
- Fai una domanda alla volta e sii specifico (es. orari, requisiti, procedure, documenti necessari).
- Aggiungi contesto utile: periodo, luogo, tipo di servizio a cui ti riferisci.
- Se la prima risposta è parziale, chiedi un approfondimento o una riformulazione ("puoi spiegarmi meglio…?").
- Evita informazioni personali sensibili non necessarie alla domanda.
Se la risposta è "non lo so"
Significa che l'informazione non è presente nelle fonti disponibili all'assistente. In questo caso puoi:
- Riformulare la domanda con parole diverse o più dettagli.
- Verificare se stai cercando qualcosa effettivamente trattato dal sito.
- Contattare direttamente WP Demo 1 PROD tramite i recapiti presenti sul sito: alcune richieste (personali o non pubblicate) richiedono un operatore umano.
Questa sezione è per lo studio / gestore del sito che amministra l'assistente e i suoi contenuti.
Il Backoffice
Dalla pagina Backoffice (link in alto a destra), protetta da login con email e password, il titolare e le persone che ha aggiunto gestiscono l'assistente: Conversazioni, Knowledge Base, Prompt e regole, Panoramica del sito (con i TWIZA Talent), Altri prodotti, Aspetto pubblico e Persone e password. Ruoli: titolare e amministratore vedono tutto, l'editor vede Conversazioni, Knowledge Base e Altri prodotti.
L'elenco dei documenti nella Knowledge Base si consulta solo dal Backoffice (area riservata): la chat pubblica non mostra i nomi dei file.
Caricare documenti nella Knowledge Base
Dal Backoffice, sezione Knowledge Base: scegli un file e premi Carica.
Formati accettati: .pdf, .txt, .md, .doc, .docx e immagini .jpg, .png, .webp, .tiff (dimensione massima del singolo file: 50 MB). Le scansioni (PDF senza testo) e le immagini con testo leggibile vengono lette con OCR e il testo entra nella Knowledge Base.
I documenti vengono archiviati e poi indicizzati nella Knowledge Base dell'assistente. Il caricamento avvia da solo l'indicizzazione: nel Backoffice vedi lo stato con l'attesa stimata e, accanto a ogni file, «✓ interrogabile» oppure «⏳ in indicizzazione». Finché un documento è «in indicizzazione», il suo contenuto potrebbe non comparire ancora nelle risposte.
Knowledge Base ibrida: due fonti
La conoscenza dell'assistente arriva da due sorgenti combinate:
- Crawler del sito web — le pagine pubbliche del sito vengono lette automaticamente.
- Documenti caricati — i file che carichi tu (vedi sopra).
Il piano e i suoi limiti
I piani sono tre: Nubia, Luangwa e Masai. Ognuno stabilisce tre cose, e i numeri li dichiara il registro licenze di SHAKAZAMBA:
- Spazio per i documenti caricati: oltre lo spazio del piano un caricamento viene rifiutato prima di scrivere. Lo spazio usato si vede nel Backoffice.
- Siti letti dal crawler della Knowledge Base.
- Accessi al Backoffice: le persone che possono entrare, account principale compreso. Al limite non si aggiunge né si riattiva un'altra persona.
I visitatori della chat pubblica non contano mai: nessun limite di conversazioni. Niente si cancella se sei già oltre un limite: semplicemente non si aggiunge, finché non rientri o cambi piano.
Per un cambio di piano contatta il supporto.
Il plugin WordPress "WP TWIZA Lite"
Se il sito del cliente è in WordPress, la personalizzazione dell'assistente avviene dal plugin WP TWIZA Lite (menu WP TWIZA Lite in wp-admin). Da lì il gestore configura:
- Widget flottante: colori, avatar/icona, testi del pulsante e placeholder del campo di input.
- Messaggio di benvenuto: la prima frase mostrata all'apertura della chat.
- System Prompt: le istruzioni di comportamento specifiche del sito (vedi paragrafo dedicato).
- Licenza: la License Key (formato
TWIZA-WP-XXXXXXXX), che si lega al dominio al primo utilizzo. Senza licenza valida il widget resta disabilitato.
- Sincronizzazione istruzioni: al salvataggio, il System Prompt viene inviato all'agente AI (campo Agent Instructions); è disponibile anche un pulsante per forzare la sincronizzazione.
System Prompt vs regole di base
Nel campo System Prompt vanno scritte solo le tue istruzioni specifiche (tono, argomenti da privilegiare, comportamenti desiderati per questo sito).
- Le regole anti-allucinazione di base sono gestite a livello di piattaforma, restano sempre applicate e hanno priorità sulle tue istruzioni.
- Non serve (e non conviene) riscriverle nel System Prompt: vengono preservate automaticamente a ogni sincronizzazione, anche se l'istruzione dell'agente viene modificata.
Cosa gestisce il superadmin (SHAKAZAMBA)
Alcune operazioni non sono a carico dello studio ma del superadmin SHAKAZAMBA:
- creazione dell'ambiente (tenant) e provisioning;
- creazione e configurazione dell'agente DigitalOcean;
- endpoint e chiave API dell'agente (mai esposti al browser);
- emissione della licenza, cambio di piano e credenziali dell'account principale.
Per queste richieste scrivi al supporto: info@shakazamba.tech.
Limiti e note
- L'indicizzazione di nuovi contenuti può richiedere qualche minuto prima di essere disponibile nelle risposte.
- Documenti molto grandi o in formati non supportati potrebbero non essere indicizzati.
- Se un documento appena caricato non compare nelle risposte, attendi il completamento del reindex e riprova.