Class AI_LLAMA_CHAT

Questa funzionalità trasforma un insieme di elementi HTML in un'interfaccia di chat per il modello LLAMA servito da CodBi. Consente conversazioni interattive a più turni sulle immagini caricate e sui documenti PDF e fornisce l'accesso alle query Internet al modello tramite Brave Search API e la posizione del cliente tramite l'API di geolocalizzazione. L'input vocale è supportato tramite la funzionalità Media.Input.Speech.Whisper.

Se il modello non è specificato, viene scaricato e utilizzato QWEN3-VL 2B.

Elementi obbligatori (trovati dalla classe CSS all'interno dell'antenato comune più vicino):

Classi CSS generate (inserite in fase di esecuzione):

Comportamento:

• L'area di testo del display è di sola lettura e mostra la cronologia completa delle conversazioni.
• Quando i file vengono selezionati tramite l'input di caricamento, vengono allegati per i messaggi successivi.
• Quando l'utente fa clic su Invia (o preme CTRL+Invio nell'input), il messaggio e tutti i file allegati vengono inviati al backend standard per l'elaborazione tramite il modello AI. La risposta viene visualizzata nella chat.
• I file PDF vengono rilevati ed elaborati automaticamente (renderizzati in immagini o estratti).
• È possibile allegare più file; ciascuno viene elaborato indipendentemente dal modello.
• Il pulsante di invio e l'input sono disabilitati durante l'inferenza per evitare richieste duplicate.

Parametri di configurazione:

• MaxPages: numero massimo di pagine PDF da elaborare (default: 5).
• Rotazione: rotazione dell'immagine in gradi (90, 180 o 270). Se è noto che l'immagine da elaborare è ruotata, questo può essere impostato per evitare che Tesseract OSD (se disponibile) o che l'IA debba gestirlo, accelerando l'inferenza. Non impostare o impostare su 0 significa che la rotazione è sconosciuta.
• MaxPixelSize: budget totale massimo di pixel (larghezza×altezza). Le immagini che superano questo limite vengono ridimensionate sul lato client preservando le proporzioni. Predefinito: 3211264 (≈ 1792×1792). Impostato su 0 per disabilitare il downscaling lato client.
• LLAMABubble: colore di sfondo per le bolle di Lama (AI) (predefinito: #e5e5ea).
• UserBubble: colore di sfondo per le bolle utente (default: #0b93f6).
• WelcomeText: testo mostrato dopo il nome del modello nel messaggio di pronto (predefinito: "Chat pronta. Allega file e digita la tua domanda.").
• VoiceHotkey: scorciatoia da tastiera per attivare/disattivare l'input vocale, ad es. "Alt+A" (predefinito: "Alt+A"). Formato: modificatore/i + tasto separato da +. Modificatori riconosciuti: "Alt", "Ctrl", "Maiusc", "Meta". La parte fondamentale non fa distinzione tra maiuscole e minuscole.
• VoicePlaceholder: testo segnaposto mostrato nell'input della chat quando è disponibile l'input vocale. Predefinito: "Alt+A = 🎙 on/off | Alt+Q = 🎙 off + invia" (riflette i tasti di scelta rapida configurati).
• VoiceSendHotkey: scorciatoia da tastiera per interrompere la registrazione e inviare, ad es. "Alt+Q" (predefinito: "Alt+Q"). Stesso formato del modificatore di "VoiceHotkey".
• Lingua: codice della lingua per la sintesi vocale di Whisper (ad esempio "de", "en"). Vuoto o non impostato indica il rilevamento automatico.
• WaitingText: testo mostrato in attesa che il server AI diventi disponibile (predefinito: "In attesa del server AI\u2026").
• LowConfidenceText: testo di avviso mostrato quando la risposta dell'AI ha un livello di confidenza basso (predefinito: "Confidenza bassa").
• RethinkButtonText: Etichetta del pulsante che offre di rispondere con il modello di pensiero (default: "Ripensa").
• UncertainText: testo della descrizione comando mostrato quando si passa sopra token incerti (a bassa confidenza) (predefinito: "Bassa confidenza").
• ShowUncertainTokens: se evidenziare visivamente i token incerti nelle risposte dell'IA. Impostato su "false" per disabilitare l'evidenziazione (default: "true").
• ResponseLanguage: codice ISO 639-1 di due lettere (ad es. "de", "fr"). Quando impostata, l'IA lo è costretto a rispondere in questa lingua: non viene eseguito alcun rilevamento automatico. Sostituisce la proprietà del plugin AI_LLAMA_STD_Language per questa istanza. L'interfaccia della chat riflette questa lingua per le etichette, ove disponibile.
• Specialista: nome di un modello specializzato registrato tramite AI_LLAMA_STD_SPECIALIST_XXX proprietà del plugin. Una volta impostate, le richieste vengono indirizzate allo specialista in questione istanza del server dedicato (corrispondenza senza distinzione tra maiuscole e minuscole).
• QueueBadge: Se impostato su "true", mostra un badge con la posizione corrente della coda mentre in attesa di deduzioni. Sostituisce la proprietà del plugin "AI_QueueBadge". per questa istanza. Predefinito: determinato dalla proprietà del plugin.
• QueueText: testo aggiunto dopo il numero della posizione in coda nel badge (es. "in coda" → il badge indica "3 in coda"). Predefinito: vuoto.
• FilterResults: se impostato su "true", abilita il filtro PII sulle query di Brave Search in questo caso, sovrascrivendo il file globale AI_BraveSearch_FilterResults proprietà del plugin. Predefinito: determinato dalla proprietà del plugin.