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 animati (…).
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.
Accesso al Backoffice
Il Backoffice è protetto da login: si entra con email e password. L'account principale (il titolare) ha le credenziali consegnate all'attivazione dell'ambiente; le altre persone le aggiunge il titolare o un amministratore. La sessione dura al massimo 12 ore; Esci la chiude prima.
- Password dimenticata? Per l'account principale scrivi al supporto SHAKAZAMBA, che può mandarti un collegamento per impostarne una nuova. Per le persone aggiunte, la password la reimposta un amministratore del sito da Persone e password.
Chi può fare cosa
- Titolare (account principale) e Amministratore: tutto il Backoffice.
- Editor: Conversazioni, Knowledge Base e Altri prodotti; non vede persone né impostazioni.
Cosa trovi nel Backoffice
- Conversazioni: le sessioni registrate dalla chat pubblica; apri una sessione per rileggere l'intero scambio. Utile per capire cosa chiedono i visitatori.
- Knowledge Base: i documenti dell'assistente, con caricamento ed eliminazione, lo stato dell'indicizzazione e lo spazio usato del piano.
- Prompt e regole: le istruzioni specifiche del sito (le regole di base restano sempre attive, vedi sotto).
- Panoramica del sito: sessioni e messaggi, andamento giornaliero, TWIZA Talent consumati e residui con le soglie di avviso, ultima indicizzazione, stato della licenza e avvisi.
- Altri prodotti: gli altri prodotti TWIZA dello stesso cliente e i fascicoli che uno di quelli ha condiviso con questo sito. Si possono solo consultare: non entrano nella Knowledge Base e non arrivano alla chat pubblica.
- Aspetto pubblico: colore, font e messaggio di benvenuto della pagina pubblica, e per quanti giorni (da 1 a 365, predefinito 90) si conservano le conversazioni prima della cancellazione automatica. L'avviso «Stai interagendo con un assistente AI» resta sempre visibile.
- Persone e password: chi può entrare nel Backoffice, con ruolo e password; mostra quanti accessi sono in uso sul totale del piano, account principale compreso.
Caricare documenti nella Knowledge Base
Dalla 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; accanto al file compare lo stato «OCR ok», «OCR in corso» (file grandi, completato in background) o «OCR fallito».
I documenti vengono archiviati e poi indicizzati nella Knowledge Base dell'assistente. Il caricamento avvia da solo l'indicizzazione: non devi fare altro. Sopra l'elenco vedi lo stato («allineata», «in corso», «in coda») con l'attesa stimata calcolata dai tempi reali di questo ambiente; accanto a ogni file compare «✓ interrogabile» (l'assistente lo usa già nelle risposte) oppure «⏳ in indicizzazione» (sarà interrogabile al termine del job in corso o del prossimo). 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.