Assistant Dashboard
Panoramica operativa dell'assistant attivo nel tenant corrente.
Configurazione attiva
Deploy
Aggiorna il checkout con `git pull` e riavvia rapidamente il processo Python quando il servizio viene rialzato automaticamente da systemd.
Tenants
Elenco tenant
Apri il tenant su cui vuoi lavorare| Tenant | Slug | Assistants | Azione |
|---|
Settings del tenant
Assistants
Elenco assistants
Tenant corrente: nessuno| Assistant | Slug | Visibilita | Azione |
|---|
Settings dell'assistant
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.
Assistant Tools
Mini integrazioni HTTP JSON che l'assistant puo usare prima del RAG quando servono dati live.
{{ticket_id}} in URL, query, body e header JSON.{"ticket_id":"ID ticket richiesto dall'utente"}.Assistant Knowledge
Knowledge base e configurazione RAG riferite all'assistant attivo.
RAG Settings
Guida knowledge + esempi
Documenti esempio pronti nella cartella `example/`- - 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.
- - 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.
- - Evita dump lunghi non segmentati e contenuti duplicati.
- - Dopo modifiche a chunk size/overlap: usa "Salva + Reindicizza".
Carica documento
| 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 UI
Queste opzioni definiscono l'esperienza chat e widget del solo assistant attivo.
Avatar
Modello da mostrare (se abilitato):
Push-to-Talk
Voce e Lingue
Automatico riproduce subito, facoltativo solo su click dell'utente, disabilitato non chiama il servizio TTS.
Se attivo, l'utente puo scegliere la lingua della conversazione. L'italiano resta sempre disponibile di default.
Inserisci i codici lingua separati da virgola, ad esempio it, en, de, fr.
Template grafico
Messaggio di benvenuto
Velocita digitazione testo
Durata conversazione
Alla scadenza la chat mostra un avviso, propone un nuovo inizio immediato e fa partire automaticamente una nuova conversazione dopo 30 secondi.
Assistant Widgets
Crea uno o piu widget embeddabili da incollare in siti esterni.
Assistant Chat Logs
Storico conversazioni del solo assistant attivo.
| Data | Sessione | Utente | Risposta | ms | Apri |
|---|
Assistant Request Logs
Tracciamento richieste API e diagnostica del solo assistant attivo.
| Data | Tipo | Metodo | Path | Status | ms | IP | Dettagli |
|---|
Assistant Test Chat
Chat di test collegata all'assistant attivo nel tenant corrente.
Assistant API
Riferimenti API e pagine utili per integrare l'assistant attivo.
Pagine
Chat (pubblici)
Chat RAG testuale. Body: {"message":"...", "stream": false}
WebSocket real-time. Supporta type: "text" e type: "audio" (base64)
Disabilitato: le foto non sono leggibili pubblicamente
URL del modello 3D avatar attivo
Config chat: avatar, PTT, template, welcome
Admin (richiedono JWT)
Autenticazione. Body: {"username":"...", "password":"..."} — ritorna JWT token
GET: modelli attivi — PUT: override LLM, Embedding, STT, TTS (vuoto = usa .env)
GET/PUT: avatar, PTT, template, messaggio benvenuto
Stato completo: KB count, sorgenti, conteggi log
GET: leggi prompt corrente — PUT: aggiorna il system prompt
Ripristina il system prompt al valore di default
Elenco file su disco e sorgenti indicizzate, con stato e conteggio chunks
Upload file (.txt, .md, .csv, .json) — JSON e TXT JSON vengono normalizzati automaticamente
Svuota e reindicizza tutto da knowledge_docs/
Svuota completamente la knowledge base
Storico conversazioni — query: ?limit=50&offset=0
Log richieste HTTP con timing e status
Upload foto (jpg, png, gif, webp) per il carousel
Lista foto caricate con URL protetti admin
Lista modelli GLTF disponibili + modello attivo
Imposta il modello avatar attivo. Body: {"url":"/static/models/Fox.glb"}