Impostazioni TuaGPT

Scheda «Connessioni»

Scopo: definire come TuaGPT raggiunge il backend LLM e, separatamente, come invia le email dall’app.

Imposta connessione al Server

• URL del server TuaGPT — Indirizzo base dell’API compatibile OpenAI (es. Ollama http://localhost:11434, LM Studio, TuaGate). È il prerequisito per elenco modelli e chat.
• Token di sicurezza — Chiave o token richiesto dal gateway (TuaGate, OpenAI, ecc.); per server locali senza auth può restare vuoto.
• Timeout HTTP/LLM (sec) — Tempo massimo di attesa per una richiesta. Valori bassi interrompono risposte lunghe; valori alti (120–300) aiutano con modelli lenti o contesti grandi.
• Verifica Connessione — Controlla raggiungibilità e credenziali senza avviare una chat.
• Connetti — Stabilisce la sessione con il server (comportamento dipende dalla versione; usa dopo aver impostato URL/token).
• Scopri Endpoint — Aiuta a individuare endpoint o modelli disponibili sul server configurato.

Impostazioni Invio Email

• Modalità invio — SMTP diretto usa host/porta/credenziali; Client di posta delega al programma di posta predefinito di Windows.
• Host, porta, username, password, SSL — Parametri del provider SMTP (es. porta 587 con STARTTLS).
• Test SMTP — Invia un messaggio di prova per validare la configurazione.

Scheda «Generali»

Scopo: opzioni globali del client, sicurezza, notifiche, backup e aspetto della chat (incluso ChatDisplayBox).

Opzioni Generali TuaGPT Client

• Connetti al server TuaGPT all’avvio — Avvia automaticamente la connessione all’URL configurato all’apertura dell’app.
• Abilita Crittografia Dati — Cifra il database locale; i dati restano leggibili solo in questo ambiente.
• Salva recupero / Aggiorna recupero — Gestione file di backup/recupero cifrato per migrare o ripristinare (usa passphrase dove richiesto).
• Abilita link cliccabili nelle chat — Trasforma gli URL nel testo in collegamenti attivi.
• Riduci nell’area di notifica… — Chiudendo la finestra l’app resta nell’icona tray invece di uscire.
• Mostra conferme e notifiche di esito — Dialoghi di conferma per operazioni sensibili.
• Salva log su file / Abilita tutti i log — Diagnostica su disco; utile per segnalare problemi, aumenta l’uso disco.
• Abilita invio con tasto Enter — Invio rapido del messaggio (attenzione a invii accidentali).
• Usa endpoint nativi (…/v1/responses) — Per backend che espongono API in formato “responses”; attivalo solo se il server lo richiede.
• Titolo gruppo area tasti funzione — Testo mostrato sul riquadro dei tasti FN nel form principale (es. «Tasti FN», «Scorciatoie»).

Notifiche Windows

• Abilita notifiche nel Centro notifiche — Toast di sistema.
• Avvisa quando la risposta del modello è conclusa — Utile con risposte lunghe mentre lavori su altre finestre.

Backup Database

• Esegui backup completo alla chiusura — Copia automatica all’uscita.
• Cartella di destinazione / Sfoglia / Esegui backup ora — Percorso e backup on-demand.

Visualizzazione Chat (ChatDisplayBox)

L’area messaggi della conversazione è sempre resa con ChatDisplayBox (icone copia, azioni sui messaggi, tabelle, LaTeX, ecc.).

• Tema — Chiaro / Scuro / Sistema (se abilitato in versione corrente).
• Padding, spaziatura righe, font, font codice, dimensione base — Leggibilità e densità del testo.
• Mostra timestamp nei messaggi — Data/ora su ogni messaggio.
• Mostra icone azioni messaggio — Thumbs, rigenera, ecc.

Scheda «Prompt & Chat»

Scopo: organizzare categorie e gruppi chat, titoli automatici, QueryBoost, prompt di sistema e prompt per funzioni avanzate (ricerca unificata).

Imposta le Categorie dei Prompt

Le categorie classificano i template in Gestione Prompt. Aggiungi, rinomina, elimina ed eventualmente importa/esporta per backup o condivisione interna.

Imposta i Gruppi delle Chat

I gruppi servono a filtrare e organizzare le conversazioni nella lista (distinti dalle etichette colore). Stesse operazioni: elenco, aggiunta, rinomina, eliminazione, import/export.

Generazione Automatica Titoli Chat

• Generazione titoli — Se attiva, il titolo della chat viene proposto automaticamente in base al contenuto.
• Modello — Quale LLM usare per il titolo (spesso un modello veloce va bene).
• Lunghezza massima titolo / max token — Limiti per non sprecare token.
• Personalizza prompt — Modifica il prompt usato per generare il titolo.

Prompt di Sistema Chat

Prompt opzionale applicato come contesto di sistema alle conversazioni. Utile per tono, regole o vincoli globali. Usa «Personalizza» per editare il testo e verifica lo stato indicato nell’etichetta.

Prompt Ricerca Unificata (tool)

Definisce come il modello deve comportarsi quando usi la ricerca unificata tramite tool. Personalizzalo se vuoi output più strutturati o settoriali.

QueryBoost

• Abilita QueryBoost — Riformula o arricchisce la domanda prima dell’invio al modello principale (migliora qualità a costo di una chiamata extra).
• Modello LLM per QueryBoost — Modello dedicato (può essere più leggero del chat).
• Avvisi — Opzioni di avviso legate al costo o al comportamento.
• Personalizza prompt QueryBoost — Controllo fine su come viene riscritta la query.

Scheda «LLM & OCR»

Scopo: parametri di campionamento del modello «principale», OCR su immagini (RAG e documenti), e modelli riservati alle funzioni automatiche.

Configurazione OCR

• Abilita OCR — Estrazione testo da immagini tramite Tesseract.
• Percorso dati Tesseract — Cartella dei file lingua .traineddata.
• Lingua — Es. ita+eng per documenti misti.
• Soglia confidenza (%) — Sotto questa soglia il carattere può essere scartato o segnalato come incerto.
• OCR parallelo / Dimensione pool / Tentativi retry — Prestazioni e robustezza in elaborazioni batch o multi-pagina.
• Test / Aggiorna stato / Debug — Verifica installazione e diagnostica.

Impostazioni LLM

• Modello di riferimento — Modello predefinito per le chat (allineato al selettore nella finestra principale).
• Temperature, Top P, Max Tokens, Presence/Frequency Penalty — Parametri standard OpenAI: creatività, varietà, lunghezza risposta, penalità su ripetizione e su nuovi argomenti.
• Limita max tokens — Se disattivato, alcuni server permettono risposte molto lunghe (dipende dal backend).
• Parametri per modello — Al cambio modello si caricano i valori salvati nel database per quel profilo; modifiche ai controlli numerici vengono salvate automaticamente per il modello corrente.

Modelli Riservati

Elenco di modelli contrassegnati per funzioni di sistema (es. QueryBoost, generazione titoli). Riservare modelli leggeri qui evita di usare modelli grandi per compiti brevi.

Scheda «LLM e Classificazione»

Scopo: selezione intelligente del modello in base al tipo di richiesta, profili, statistiche e mapping manuale modello–categoria.

Selezione Automatica LLM

• Abilita selezione automatica — Il client sceglie un modello in base a analisi della query (complessità, tipo, lingua, ecc.).
• Pesi — Regolano l’influenza di complessità, tipo, contesto, topic, lingua nello score. Valori più alti su un criterio lo rendono più determinante.

Profili Modelli

Tabella per associare modelli a scenari o preferenze (salva/aggiorna dalla griglia). Utile quando hai molti modelli installati.

Statistiche Feedback

Mostra quante volte è stata usata la selezione automatica e punteggi medi; pulsanti per azzerare statistiche o approfondire.

Mapping Manuale Modelli-Categorie

Per ogni categoria di prompt puoi forzare un modello specifico, ignorando la selezione automatica per quel tipo di contenuto. Salva le righe dalla griglia dopo le modifiche.

Scheda «Tool LLM»

Scopo: abilitare i tool (funzioni) che il modello può invocare — ricerca web, file, estensioni browser e Thunderbird — con limiti di sicurezza.

Impostazioni Tool LLM

• Abilita Tool per LLM — Master switch: senza di esso il modello non riceve definizioni di tool.
• Limite iterazioni tool — Quante volte di seguito il modello può chiamare tool in un turno (0 = illimitato secondo implementazione).
• Directory sicura per operazioni file — Cartella dentro cui i tool possono leggere/scrivere file, per ridurre rischi.
• URL Whitelist (futuro) — Riservato a restrizioni future sugli URL.

Planner / calendario interno

• Abilita tool planner (calendario e task interni TuaGPT…) — Quando è spuntato e Abilita Tool per LLM è attivo, il modello con function calling riceve i tool planner_* per elencare, creare, aggiornare o eliminare eventi e task, calcolare intervalli occupati, cercare slot liberi e riassumere una giornata. I dati sono gli stessi del pannello Planner nella barra strumenti (vedi guida principale, sezione Planner).

Estensione Browser

• Abilita estensione — Permette ricerca web reale tramite browser (Chrome/Firefox) e polling su localhost.
• Porta TuaGPT — Deve coincidere con quanto configurato nell’estensione (es. 8765).
• Token, Copia, Rigenera, Mostra — Autenticazione tra browser e TuaGPT.
• Browser preferito, Test connessione, Test navigazione — Verifica end-to-end.
• Personalizza Prompt — Prompt per la parte web search legata all’estensione.

Estensione Thunderbird (posta)

• Abilita estensione Thunderbird — Espone API /thunderbird/ per leggere/inviare posta tramite tool.
• Token Thunderbird — Separato dal token browser; copia nell’estensione Thunderbird.
• Test connessione / Test job ping — Verifica che TuaGPT riceva i job dalla coda.
• Personalizza Prompt — Comportamento dei tool email.

La porta Thunderbird è la stessa «Porta TuaGPT» usata dall'estensione browser: dopo cambiamenti rilevanti può essere necessario riavviare TuaGPT.

Scheda «LaTeX»

Scopo: controllare come le formule matematiche in LaTeX vengono renderizzate nella chat (motore CSharpMath), dimensioni, limiti e inserimento in RTF.

Rendering CSharpMath

Opzioni principali del motore di rendering (scala, DPI, fattori di qualità). Modificale se le formule appare troppo piccole/grandi o sgranate.

Padding per lato

Spazio intorno alla formula; valore 0 usa il default del sistema di layout.

Dimensioni bitmap

Limiti di larghezza/altezza dell’immagine generata per la formula, per evitare formule enormi in chat.

Display

Altezze massime per formule in linea vs blocco, larghezza massima, allineamento centrato per i blocchi.

RTF

Parametri Picwgoal / Pichgoal multiplier per l’inserimento delle immagini formula nel flusso RTF della chat: influenzano come WordPad/RTF interpreta le dimensioni.

Limiti

Massima lunghezza formula — Protegge da input LaTeX enormi che potrebbero rallentare o bloccare il rendering.

Anteprima

Anteprima e Ripristina default per testare visivamente le modifiche senza chiudere le impostazioni.