Assistant Dashboard
Panoramica operativa dell'assistant attivo nel tenant corrente.
-
Knowledge chunks
-
Sorgenti
-
Chat logs
-
Requests
Configurazione attiva
Deploy
Aggiorna il checkout con `git pull` e riavvia rapidamente il processo Python quando il servizio viene rialzato automaticamente da systemd.
PID attuale
-
Git branch
-
Ultimo esito
Nessuna azione eseguita
Il pulsante invia SIGTERM al processo corrente. Se il servizio ha un `Restart=` attivo in systemd, verra riportato su automaticamente.
Tenants
Cos'è un Tenant
Il tenant e il progetto o servizio che stai amministrando.
Qui gestisci solo il contenitore principale: creazione, modifica, selezione ed eliminazione del tenant. La gestione degli assistant e separata nella pagina dedicata `Assistants`.
In pratica: prima apri il tenant, poi passi alla schermata assistants per gestire i ruoli AI.
Come leggere la navigazione
Apri un tenant per lavorare sul progetto corretto.
Dalla schermata `Tenants` scegli il progetto. Dalla schermata `Assistants` gestisci gli assistant di quel tenant. Le sezioni operative della sidebar usano invece l'assistant attivo.
Livello tenant
Anagrafica del progetto, selezione del contesto e operazioni di rinomina o eliminazione del tenant.
Livello assistant
La schermata `Assistants` e tutte le sezioni operative lavorano sugli assistant del tenant selezionato.
Elenco tenant
Apri il tenant su cui vuoi lavorare| Tenant | Slug | Assistants | Azione |
|---|
Settings del tenant
Apri un tenant dall'elenco a sinistra per vedere e modificare i suoi dati.
Qui puoi rinominare il tenant o eliminarlo. L'eliminazione richiede conferma e rimuove anche gli assistant collegati.
Lo slug del tenant `default` non puo essere modificato.
Assistants
Cos'è un Assistant
Un assistant e un ruolo AI specializzato dentro un tenant.
Qui gestisci gli assistant del tenant aperto: creazione, modifica, apertura del contesto attivo ed eliminazione con conferma. Ogni assistant puo avere prompt, knowledge, modelli e interfaccia propri.
In pratica: tenant = progetto, assistant = comportamento AI specifico dentro quel progetto.
Apri prima un tenant dalla schermata `Tenants` per vedere e gestire i suoi assistant.
Elenco assistants
Tenant corrente: nessuno| Assistant | Slug | Visibilita | Azione |
|---|
Settings dell'assistant
Apri un assistant dall'elenco a sinistra per vedere e modificare i suoi dati.
Qui puoi rinominare l'assistant, aggiornarne le impostazioni base o eliminarlo. Se lo apri, diventa anche il contesto operativo usato dalle sezioni della sidebar.
Assistant AI Settings
Questi modelli e parametri appartengono solo all'assistant attivo.
Modelli AI modificabili da interfaccia. Se vuoti, si usa il valore da .env.
Per chatbot RAG conviene stare bassi, di solito tra 0.1 e 0.4.
Riducilo se vuoi risposte piu brevi e veloci.
Assistant Prompt
Il prompt qui sotto vale solo per l'assistant attivo.
Questo prompt viene inviato come messaggio di sistema ad ogni conversazione. Modifiche immediate, nessun riavvio necessario.
Placeholder disponibili: {current_date}, {current_time}, {current_datetime}, {current_datetime_iso}, {current_timezone}, {current_utc_offset}, {current_year}, {today}.
Assistant Lingue
Qui configuri i contenuti localizzati per ogni lingua abilitata nella chat pubblica.
Per ogni lingua abilitata puoi definire un prompt dedicato, un messaggio di benvenuto tradotto e i parametri TTS specifici. Se lasci un campo vuoto, il sistema usa i valori base configurati in Prompt e AI Settings.
Abilita prima il multilingua nella pagina Chat UI e scegli almeno una lingua disponibile.
Assistant Tools
Mini integrazioni HTTP JSON che l'assistant puo usare prima del RAG quando servono dati live.
Come funziona
Il runtime decide prima se usare un tool, solo dopo eventualmente passa al RAG.
Se almeno un tool e abilitato, l'assistant prova a capire se la richiesta necessita dati live da un endpoint esterno. Se trova un match usa il tool e risponde solo su quei dati. Se non trova un tool adatto, torna al RAG normale.
Esempi: stato ticket, dettaglio ordine, anagrafica cliente, disponibilita live.
Configurazione semplice
Ogni tool e una chiamata HTTP verso un endpoint che restituisce JSON. Descrivi quando usarlo, quali parametri estrarre dal messaggio utente e come costruire la richiesta. Puoi usare placeholder come
{{ticket_id}} in URL, query, body e header JSON.Input schema
JSON con i parametri da estrarre, ad esempio
{"ticket_id":"ID ticket richiesto dall'utente"}.Template richiesta
Puoi usare URL dinamici, query string o body JSON. Se lasci query/body vuoti, il sistema usa automaticamente gli argomenti estratti.
Nessun tool configurato. Aggiungi il primo tool per collegare dati live all'assistant.
Assistant Knowledge
Knowledge base e configurazione RAG riferite all'assistant attivo.
-
Chunks totali
-
Sorgenti
RAG Settings
Modifiche non salvate
Modalita RAG
Distance Threshold
Più basso = filtro più severo (meno risultati, più precisi). Più alto = più risultati, ma più rumore.
Esempio: una domanda specifica non trova nulla? prova 0.55 → 0.70.
Top K
Numero massimo di chunk candidati prima del filtro soglia.
Esempio: 3-5 per output concisi; 8-12 per query più ambigue.
Chunk Size
Lunghezza di ogni blocco indicizzato.
Esempio: riduci (700) se i chunk sono troppo generici; aumenta (1200) se manca contesto.
Chunk Overlap
Testo condiviso tra chunk consecutivi per non perdere info ai confini.
Esempio: alza 200 → 300 se dettagli vicini finiscono in chunk diversi.
Quando reindicizzare:
solo se cambi Chunk Size o Chunk Overlap.
Se cambi solo soglia o top-k, basta Salva RAG.
Guida knowledge + esempi
Documenti esempio pronti nella cartella `example/`esempio_rag_friendly.md
Struttura base per contenuti descrittivi generici.
esempio_assistenza_tecnica_rag.md
Ideale per ticket/email: intent, sintomi, diagnosi, soluzione.
esempio_manuale_uso_rag.md
Per manuali utente: procedure, FAQ dirette, troubleshooting.
Come strutturare il knowledge
- - Un file per tema/servizio, non misto.
- - Titoli chiari e sezioni brevi.
- - FAQ con domanda reale + risposta diretta.
- - Alias/sinonimi per migliorare il retrieval.
- - Procedure step-by-step quando serve operativita.
Formati consigliati
- - Ottimale: .md (titoli + paragrafi strutturati).
- - Buono: .txt (testo lineare pulito).
- - Utile per dati tabellari: .csv.
- - Supportato: .json oppure .txt con JSON valido, che viene normalizzato per il RAG.
- - Supportato: .pdf con testo estraibile, convertito automaticamente in testo prima dell'indicizzazione.
- - Evita dump lunghi non segmentati e contenuti duplicati.
- - Dopo modifiche a chunk size/overlap: usa "Salva + Reindicizza".
Carica documento
Trascina qui i documenti oppure clicca per selezionarli
Formati supportati: .txt, .md, .csv, .json, .pdf
Nessun file rilevato
Reindicizzazione in corso
0%
Preparazione job...
| Sorgente | Stato | Chunks | Azioni |
|---|
Editor sorgente
RAG Inspector
La colonna preview mostra testo troncato. Clicca su preview per vedere il chunk completo.
| Distance | Pass | Source | Chunk | Preview |
|---|
Assistant Chat/Widgets
La chat full screen e i widget embedded usano ora lo stesso modello di configurazione.
Ogni assistant ha sempre un widget di sistema Chat Principale, usato per la chat full screen pubblica. Da qui puoi aggiungere anche widget embedded che ereditano la stessa struttura di impostazioni: esperienza, voce, lingue, avatar, colori e comportamento.
Suggerimento: nella card Full Screen Chat trovi il link pubblico reale. Nelle card Widget trovi anche il codice embed da copiare nei siti esterni.
Nessun widget configurato. Clicca su Nuovo widget per crearne uno.
Assistant Chat Logs
Storico conversazioni del solo assistant attivo.
| Data | Sessione | Utente | ms | Test chat |
|---|
Assistant Request Logs
Tracciamento richieste API e diagnostica del solo assistant attivo.
| Quando | Metodo | Path | Stato | Durata | IP |
|---|
Test Chat
Messaggi verso l'assistant attivo (contesto tenant corrente).
Gestione Utenti
Multi-User
Assegna gli utenti ai tenant.
Crea utenti e associa i tenant a cui possono accedere. Gli utenti non-admin vedranno solo i tenant assegnati.
Crea nuovo utente
| Username | Ruolo | Attivo | Tenant IDs | Azione |
|---|