Dashboard
Snapshot del tuo ambiente — ultimi 30 giorni.
Ultimo accesso precedente
Attivita recente
| Quando | Evento | Utente | Dettaglio |
|---|---|---|---|
| Caricamento… | |||
Fiscal

Snapshot del tuo ambiente — ultimi 30 giorni.
| Quando | Evento | Utente | Dettaglio |
|---|---|---|---|
| Caricamento… | |||
Fascicoli / clienti del tuo studio. Ogni fascicolo ha la sua cartella documenti e le sue sessioni — quando l'utente chatta su un fascicolo, TWIZA cerca solo nei documenti di quel fascicolo, evitando contaminazione tra fascicoli. Limite tier: — fascicoli attivi.
Sessioni suddivise per utente. Click sulla riga apre i messaggi.
| Session ID | Utente | Messaggi | Aggiornata |
|---|---|---|---|
| Caricamento… | |||
Aggiungi fino a 10 utenti. Riceveranno un magic link via email per accedere senza password.
| Nome | Ruolo | Ultimo accesso | ||
|---|---|---|---|---|
| Caricamento… | ||||
File indicizzati dalla knowledge base di TWIZA. Letti e indicizzati: PDF (con testo oppure scansionati: il testo viene letto con OCR), immagini JPG/PNG/WEBP/TIFF (testo letto con OCR), Word (DOC/DOCX), Excel (XLS/XLSX), PowerPoint (PPT/PPTX), OpenDocument (ODT/ODS/ODP), HTML, email (EML/MSG — convertite in PDF, con gli allegati estratti e indicizzati singolarmente), testo (TXT/MD/CSV/RTF), XML (fatture elettroniche/atti) e firme digitali P7M (busta CAdES: viene letto il documento interno). Limite 100 MB per singolo file; per file più grandi spezza prima il documento o esporta in PDF.
Come funziona: ogni caricamento avvia da solo l'indicizzazione (un job per volta, i caricamenti successivi si mettono in coda). Il riquadro qui sotto mostra lo stato e l'attesa stimata dai volumi reali; ogni documento porta il badge ✓ interrogabile o ⏳ in indicizzazione. Reindicizza KB serve solo per forzare un giro completo.
Scarica un archivio .zip con tutti i file della Knowledge Base oppure filtra per fascicolo. L'archivio include un _MANIFEST.json con elenco file, hash e metadati di esportazione.
| Nome file ↕ | Dimensione ↕ | Data ↕ | ||
|---|---|---|---|---|
| Caricamento… | ||||
Aggiungi fino a 5 URL che TWIZA puo consultare oltre ai documenti caricati. Il crawler segue tutti i sottodomini e le sotto-pagine del sito (modalità SUBDOMAINS). La frequenza determina ogni quanto la knowledge base rilegge automaticamente il contenuto.
Flusso consigliato: aggiungi/modifica tutti i siti che ti servono, poi vai in Documenti → Reindicizza KB. Le modifiche qui non lanciano una re-indicizzazione automatica — questo evita job parziali che si sovrappongono e non finiscono mai.
| URL | Freq | Fascicolo | Status | Ultimo indice | |
|---|---|---|---|---|---|
| Caricamento… | |||||
I modelli scritti dal tuo studio. Ognuno dice come si redige un documento: tono, cosa deve contenere e in che ordine, cosa non si può inventare. Compaiono nella pagina iniziale del Drafter, nel menu dei modelli e nella colonna di sinistra, accanto ai predefiniti. Gli stessi modelli si creano e si modificano anche dal Drafter, dall'ingranaggio di «I miei modelli».
La carta intestata con cui escono i documenti: margini, carattere, logo, piè di pagina. Una veste è una pagina HTML con dentro il segnaposto {{DOCUMENTO}} — al posto suo va il testo della bozza. Vale sui modelli predefiniti quanto sui tuoi: la veste è di chi firma il documento, non del modello che lo ha scritto. Quella marcata come predefinita è quella che si usa se chi esporta non sceglie diversamente.
Le scorciatoie che compaiono nella sidebar e nella welcome card della chat. Quando l'utente clicca, il prompt qui sotto viene inviato direttamente all'agente. Scrivilo come scriveresti una richiesta a un collega: l'agente seguirà l'istruzione e, se servono chiarimenti, li chiederà al volo seguendo le sue regole anti-allucinazione.
Parametri runtime usati da TWIZA per ogni risposta. I default sono conservativi per ridurre rischio di allucinazioni in ambito fiscale. Modifica solo se sai cosa stai facendo — ogni campo ha la sua spiegazione qui di fianco.
temperature: la risposta era 400 a ogni messaggio, su ogni tenant.Popola questo ambiente con un caso di studio completo: fascicoli con i loro documenti, scadenze nel calendario e sessioni salvate. Serve per provare ogni funzione su dati veri invece che su un ambiente vuoto. I dati sono sintetici: nessun cliente reale.
Si può rilanciare quante volte si vuole: quello che c'è già viene saltato, niente doppioni. L'indicizzazione dei documenti parte da sola e ci mette qualche minuto.
Consumo dell'assistente TWIZA di questo ambiente nel periodo scelto, con il costo stimato secondo il listino TWIZA del tuo piano.
I TWIZA Talent sono l'unità in cui è misurato il tuo piano: ogni cosa che l'assistente fa per te ne consuma una quantità. Qui vedi quanti te ne restano per il periodo in corso.
Caricamento…
Manuale completo del pannello di amministrazione TWIZA FISCAL. Copre ogni sezione, funzione, limite e ruolo. Le voci contrassegnate admin sono visibili solo agli amministratori.
Il backoffice è il pannello di controllo del tuo ambiente TWIZA FISCAL. Da qui gestisci utenti, fascicoli, documenti della Knowledge Base (KB), siti web indicizzati, il comportamento dell'agente AI e i modelli rapidi. La chat (per gli utenti finali) è un'app separata, raggiungibile dal link “Apri chat ↗” nel menu.
Il prodotto esiste in due varianti: FISCAL Assistant (📁 fa) e FISCAL Drafter (✍ df). Le funzioni del backoffice sono le stesse; l'unica differenza rilevante è che in FISCAL Drafter la sezione “Azioni rapide” si chiama “Modelli Rapidi” e mostra la libreria di modelli di drafting tributario (vedi §8).
| Ruolo | Cosa può fare | Accesso backoffice |
|---|---|---|
| admin | Tutto: gestione utenti, impostazioni agente, fascicoli, documenti, azioni rapide (incluse eliminazione e ripristino), GDPR, dashboard e utilizzo. | Completo |
| superuser | chat + backoffice | Ridotto (si apre su Domande) |
| studio | Crea fascicoli e carica documenti/cartelle dalla chat, dal pannello “Gestione Fascicoli”. Ha accesso implicito a tutti i fascicoli. Non gestisce utenti né impostazioni. | No (opera dalla chat) |
| user | Solo chat. | No |
Il menu ha quattro gruppi: Controllo, Operatività, Configurazione e Gestione.
| Gruppo · Sezione | admin | superuser |
|---|---|---|
| Controllo · Dashboard, Domande, TWIZA Talent | ✓ | ✓ |
| Controllo · Utilizzo (€) | ✓ | — |
| Operatività · Fascicoli, Documenti | ✓ | ✓ |
| Operatività · Siti web | ✓ | — |
| Configurazione · Azioni rapide (in FISCAL Drafter anche Modelli del Drafter) | ✓ crea, modifica, disattiva, elimina, ripristina default | ✓ crea, modifica, disattiva (il bottone sparisce dalla chat) |
| Configurazione · Impostazioni TWIZA | ✓ | — |
| Gestione · Account, Guida | ✓ | ✓ |
| Gestione · Utenti | ✓ (tutti i ruoli) | ✓ (non crea né disattiva admin) |
| Gestione · Dati demo · Export GDPR | ✓ | — |
TWIZA Talent: lettura della dotazione del tuo piano dal registro licenze…
Spazio e utenti di ogni piano li stabilisce il registro licenze: quelli del tuo ambiente sono nel riquadro Piano della barra laterale, sempre aggiornati. La quota utenti è cumulativa: admin + superuser + studio + user contano insieme, e il proprietario dell'ambiente conta come utente. Lo spazio comprende i documenti dei fascicoli e gli allegati delle bozze del Drafter: oltre lo spazio del piano un caricamento viene rifiutato. Non c'è nessun limite sul numero di fascicoli (il fascicolo è il cliente dello studio). Se sei già oltre un limite non si cancella niente: semplicemente non si aggiunge, finché non rientri o passi a un piano superiore. La licenza dura 365 giorni.
Schermata iniziale con lo snapshot degli ultimi 30 giorni:
I fascicoli rappresentano i clienti dello studio. Ogni fascicolo ha la sua cartella documenti e le sue sessioni: quando un utente chatta su un fascicolo, TWIZA cerca solo nei documenti di quel fascicolo, evitando contaminazione tra fascicoli diversi.
Usa “🔍 Cerca fascicolo…” per filtrare e la checkbox “Mostra archiviate” per includere quelle chiuse. La tabella mostra Codice, Nome, Cliente, Apertura, Stato, n. Documenti, n. Sessioni.
“📦 Archivia” mette il fascicolo fuori uso senza cancellare niente: sparisce dal selettore in alto e la chat non ci cerca più dentro, ma documenti, sessioni e indice restano dove sono. “↺ Ripristina” lo rimette in servizio subito, con tutti i suoi documenti già indicizzati: non c'è nessuna attesa e non serve ricaricare niente.
Con “Permessi” assegni a ciascun utente un ruolo sulla singolo fascicolo: nessun accesso, read (lettura), edit (upload/delete) o admin (gestione). Gli utenti admin e studio del tenant hanno già accesso pieno a tutti i fascicoli (non serve assegnarli qui).
Se il cliente ha più prodotti attivi (es. CM + LD), il pannello “🔄 Sincronizza fascicoli” permette di condividere un fascicolo con gli altri ambienti. “Condividi” la replica negli ambienti fratelli (stesso nome/cliente); le modifiche successive restano locali (nessun sync continuo). In caso di nomi identici, vince il fascicolo creato per prima. “Rendi privata” rimuove il collegamento (le repliche restano ma diventano indipendenti).
Elenco delle sessioni, per consultare cosa hanno chiesto gli utenti.
Gestione degli utenti dell'ambiente (fino al limite del tier — quota cumulativa su tutti i ruoli).
La tabella mostra Email, Nome, Ruolo (badge colorato: admin fucsia, studio indaco, user grigio) e Ultimo accesso. Azioni per riga:
Se lo studio ha anche l'altro prodotto FISCAL (Assistant o Drafter), sulla riga di un utente attivo compare “🌐 Dai accesso anche a…”: scegli gli ambienti e l'utente viene creato là dove manca (stessa email, senza copiare password: entra col collegamento via email). La sincronizzazione di tutti gli utenti è riservata all'admin. Gli utenti già presenti negli altri ambienti non vengono modificati, e ogni ambiente applica il proprio limite utenti.
Qui carichi i documenti dei fascicoli che TWIZA consulta per rispondere. In FISCAL non c'è una Knowledge Base DigitalOcean da indicizzare: il testo dei documenti viene estratto (e letto con OCR per scansioni e immagini) e il motore lo passa all'assistente quando lavori su quel fascicolo; le banche dati fiscali stanno nel motore. Letti e indicizzati: PDF (con testo oppure scansionati: il testo viene letto con OCR), immagini JPG/PNG/WEBP/TIFF (testo letto con OCR), Word (DOC/DOCX), Excel (XLS/XLSX), PowerPoint (PPT/PPTX), OpenDocument (ODT/ODS/ODP), HTML, email (EML/MSG, convertite in PDF con gli allegati estratti a parte), testo (TXT/MD/CSV/RTF), XML (fatture elettroniche/atti) e firme P7M (sbustate al documento interno). Limite 100 MB per file (per file più grandi, spezzali o esporta in PDF).
.eml/.msg vengono convertite in PDF e i loro allegati estratti come file separati. Per scansioni e immagini il testo viene letto con OCR: nell'elenco documenti la colonna stato mostra “OCR ok”, “OCR in corso” (file grandi, completato in background) o l'eventuale errore._MANIFEST.json (elenco, hash, metadati).“Quota storage” mostra lo spazio usato/disponibile del piano (documenti più allegati delle bozze); oltre lo spazio un caricamento viene rifiutato con il messaggio «Spazio del piano esaurito». La barra di stato KB e “📊 Dettagli indicizzazione” riguardano la KB DigitalOcean dei prodotti che ce l'hanno: in FISCAL restano vuoti.
Aggiungi URL che TWIZA può consultare oltre ai documenti. Il crawler segue sottodomini e sotto-pagine del sito.
https://…).Nella tabella puoi modificare al volo Frequenza e Fascicolo, vedere lo Status (active/error) e l'ultimo indice, ed eliminare un sito. Le modifiche qui non lanciano il re-index automaticamente: usa “↻ Reindicizza KB” dopo le modifiche.
Le Azioni rapide sono scorciatoie che appaiono nella chat (sidebar e welcome card): al click inviano un prompt predefinito all'agente, nel contesto del fascicolo selezionato in chat (le risposte usano solo i documenti di quel fascicolo).
La sezione mostra la gerarchia completa dei modelli di drafting tributario predefiniti (8 categorie: Contenzioso tributario — ricorso e appello CGT, istanza di sospensione; Definizioni e adesione — accertamento con adesione, avviso bonario, rateazione; Interpelli — ordinario, probatorio, antiabuso; Ravvedimento e rimborsi; Rapporto con il cliente — incarico, parcella, sollecito; Dichiarazioni e attestazioni; Parere fiscale; Autotutela — avviso di accertamento, cartella esattoriale), in sola lettura (gestiti centralmente). Sotto, la sezione “Personalizzati” dove crei modelli su misura del tuo studio con “+ Nuovo modello personalizzato” (stesso editor).
Modello LLM — il motore che scrive ogni risposta. Si sceglieva alla creazione dell'ambiente: ora si cambia anche da qui, senza aggiornare il prodotto e senza interruzioni (le domande già in corso finiscono col modello vecchio, le successive partono col nuovo). Cambiare motore cambia costi, tempi di risposta e qualità: se non sai quale scegliere lascia il default della piattaforma, che teniamo aggiornato noi. È riservato all'admin: il superuser non vede il pannello e il server rifiuta comunque la richiesta.
Parametri runtime dell'agente AI. I default sono conservativi per ridurre il rischio di allucinazioni in ambito fiscale. Modificali solo se sai cosa fai.
| Parametro | Range | Consigliato | Cosa fa |
|---|---|---|---|
| Temperature | 0–2 | 0.0–0.3 | Creatività: 0 = deterministico e ancorato ai documenti; >1 rischia allucinazioni. |
| Top P | 0–1 | 0.9 | Nucleus sampling (ampiezza delle alternative considerate). |
| Max tokens (risposta) | 256–8192 | 4096 | Lunghezza massima della risposta (~16k caratteri). |
| Retrieval Top K | 5–50 | 20 | Stadio 1 (recall): quanti documenti candidati recuperare. Sotto 10 rischi di perderne. |
| Rerank Top N | 3–15 | 6 | Stadio 2 (precision): quanti passano al modello dopo il rerank. |
| Retrieval method | — | rewrite | rewrite (riscrive la query, consigliato) / step_back (domanda più generale) / sub_queries (sotto-domande) / none (query grezza). |
| Max storia sessione | 2–50 | 20 | Quanti messaggi precedenti l'agente considera (~10 turni). |
“✓ Salva impostazioni” le attiva per le nuove sessioni; “↻ Ripristina default” torna ai valori conservativi.
Il bottone “↻ Reindicizza KB” (in cima a Documenti e Siti web) chiede alla piattaforma di rielaborare la Knowledge Base DigitalOcean dell'ambiente. Sugli ambienti FISCAL (Assistant e Drafter) quella KB non esiste: i documenti li legge il motore direttamente dal fascicolo, quindi non c'è niente da reindicizzare e la richiesta risponde che la KB non è stata creata. Non è un guasto e non serve rilanciarla.
Il calendario del cliente non è nel backoffice: si trova nella chat (bottone “Calendario” in alto). È condiviso a livello di cliente tra tutti i prodotti (FISCAL Assistant / FISCAL Drafter) ed è scrivibile dall'Assistant; sul Drafter è in sola lettura (non si creano, modificano né eliminano eventi). La connessione a Google/Outlook (sync bidirezionale) e la rigenerazione del link iCal sono riservate all'admin. Vedi la Guida della chat (bottone “Guida” in alto, accanto al logo SHAKAZAMBA) per i dettagli.
TWIZA Talent (admin e superuser) mostra il credito del periodo: quanti talent del piano hai consumato e quanti ne restano, più gli eventuali pacchetti acquistati, che non scadono e si usano dopo la dotazione del piano. Gli avvisi di consumo arrivano alle soglie stabilite dal registro licenze. Se il saldo non si può leggere la pagina dice «non disponibile» col motivo: non vuol dire zero.
Utilizzo (€) è riservato all'admin: il costo misurato e le domande, per utente. È un dato di gestione; il credito del piano si legge nei talent.
Solo in FISCAL Drafter: la struttura dei documenti e la carta intestata su cui escono i modelli. Puoi creare un modello da un file, dare a ogni modello la sua veste (anche caricandola da un documento Word) e riusarla per i modelli predefiniti.
TWIZA FISCAL · © SHAKAZAMBA S.r.l. — Questa guida descrive tutte le funzioni del backoffice. Le funzioni per gli utenti finali (chat, Gestione Fascicoli, drafting) sono documentate nella Guida della chat.
Cambia password admin del tenant. Tutte le altre sessioni vengono invalidate.
Disconnetti tutti i dispositivi (utile se sospetti accesso non autorizzato).
Esporta tutti i dati del tenant (utenti, documenti, chat, audit, web sources) in un singolo JSON. Per compliance art. 20 GDPR (diritto alla portabilita).