Assistente IA sulla selezione (Ctrl+K / Ctrl+I)

Chiedere e modificare con l'IA

IA predefinita. In cima a Impostazioni → Assistenti IA, l'IA predefinita sceglie l'assistente usato da Ctrl+K/Ctrl+I, dalla chat Chat IA (modificabile per sessione) e dalle attività automatiche (riscrivere la domanda, riassumere, riassunto audio, generare il contesto). Elenca sia le CLI sia i provider API. La trascrizione audio e gli embeddings hanno un provider proprio, e LightNote suggerisce un modello in base al provider scelto.

Premi Ctrl+K (Chiedi all'IA) o Ctrl+I (Modifica con l'IA) nell'editor — con o senza selezione — per aprire un popup flottante in stile chat inline: il campo del prompt viene precompilato con la selezione sotto una riga vuota; digita l'istruzione sopra e invia con Ctrl+Invio. Nel popup scegli l'IA (quella predefinita è preselezionata) e la modalità del risultato: sostituire la selezione tramite un diff (Originale × Suggerimento, con Accetta / Copia / Rifiuta) oppure solo visualizzare la risposta come testo.

LightNote esegue la CLI di IA in modalità "one-shot" (senza aprire un terminale). Le CLI e l'IA predefinita si trovano in Impostazioni → Assistenti IA.

Collegare un modello

Modelli via API. Oltre alle CLI locali, puoi registrare modelli LLM tramite un'API compatibile con OpenAI (OpenAI, Groq, DeepSeek, OpenRouter, Gemini, Anthropic, istanze locali come Ollama/LM Studio…) in Impostazioni → Assistenti IA. Scegli un provider dal catalogo (URL base già pronto), incolla la chiave (memorizzata codificata solo su questa macchina), usa Cerca modelli… e Test. I modelli registrati compaiono nello stesso selettore di Ctrl+K, insieme alle CLI.

Collegare in un passo. Il percorso normale non è compilare la tabella: in Impostazioni → Assistenti IA fai clic su Collega un'IA…, scegli il provider (l'elenco segnala chi ha un piano gratuito e chi gira sul tuo computer, senza chiave), segui i tre passaggi, apri la pagina delle chiavi con il pulsante e incolla la chiave. LightNote compila da solo indirizzo e modello e testa la connessione prima di salvare: una chiave sbagliata si vede lì, non in mezzo a una conversazione. L'elenco in alto mostra ciò che è già collegato e, per quanto è incompleto, che cosa manca («manca incollare la chiave», «manca scegliere il modello»); un doppio clic riapre l'assistente su quel provider.

Regolazioni fini. Indirizzo, modello, permesso MCP, comandi delle CLI, trascrizione audio ed embedding restano tutti disponibili in Avanzate, in fondo alla pagina — e nell'assistente stesso, in Opzioni avanzate, puoi cambiare l'URL di base e il modello prima di collegare. Non è stato tolto nulla: si è solo spostato dalla strada di chi inizia. Negli embeddings c'è anche il campo facoltativo Dimensioni: alcuni modelli accettano di restituire un vettore più piccolo (512 invece di 1536), il che dimezza la cache con poca perdita. Lascialo su (predefinito del modello) se non sai — non tutti i provider accettano il parametro. Cambiare il valore invalida la cache: vettori di dimensioni diverse non si confrontano, quindi viene scartata e ricostruita alla ricerca successiva, il che costa nuove chiamate.

Non tutti i guasti sono uguali. LightNote distingue le classi perché chiedono gesti opposti. Il sovraccarico del provider e il limite di frequenza passano da soli: l'app ripete la chiamata per conto suo, rispettando il tempo richiesto dal provider, e l'errore lo vedi solo se nemmeno così funziona. Il saldo o il limite di spesa non passa con nessuna ripetizione — il messaggio lo dice, per non farti insistere. Una conversazione diventata troppo lunga chiede una sessione nuova, non un altro modello. E il guasto del modello — ritirato, fuori dal tuo account, fuori dal tuo piano, o ha accettato la chiamata senza rispondere — è l'unico che cambiare modello risolve. Quando il tempo richiesto è troppo lungo per aspettare, il messaggio dice quanti secondi ha chiesto, invece di lasciare la finestra ferma.

Cambiare modello da solo. Spunta Cambiare modello automaticamente quando l'attuale fallisce e LightNote prova, nell'ordine mostrato lì stesso, i modelli consigliati per quel provider. Arriva non spuntato di proposito: ogni tentativo è una chiamata addebitata sul tuo account. L'alternativa non costa mai più del modello che hai scelto — l'elenco è pubblicato dal più caro al più economico e l'app lo percorre solo in discesa; un modello personalizzato, che non è nell'elenco, cade direttamente sul più economico. Solo il guasto definitivo viene salvato nel provider; quando è stata la rete a cedere, il cambio vale solo per quella chiamata e la tua scelta resta valida. Il cambio non è mai silenzioso: una notifica dice quale modello ha risposto e se la modifica è stata salvata.

E l'avviso che arriva prima del guasto. Il cambio automatico agisce solo dopo che la chiamata è fallita — ma il catalogo dei modelli, che LightNote consulta da solo, di solito sa del ritiro prima di allora. Quando il modello che LightNote stesso ha configurato per un provider esce dal catalogo, un avviso lo dice, e in Impostazioni → Assistenti IA compare un pulsante per passare al sostituto — che, per la stessa regola, non è mai più caro. L'avviso vale solo per il modello che l'app ha scelto e che non hai mai toccato: un modello che hai scritto tu è una tua scelta, e LightNote non ci si intromette.

Quando non risponde nessuno. LightNote dice cos'è successo e offre di cambiare modello, usare un altro assistente o disattivare quel provider finché non risolvi. Un provider disattivato (colonna Attivo della tabella, in Avanzate) sparisce dagli elenchi senza perdere la chiave né il resto della configurazione. Nell'elenco degli assistenti ognuno dice se è locale o nel cloud — sceglierne uno nel cloud fa uscire dalla tua macchina il testo inviato.

Configura IA. La via guidata per qualsiasi IA è il pulsante Configura IA…, in cima a Impostazioni → Assistenti IA (è anche ciò che aprono Collega un'IA… della chat vuota e l'avviso di Ctrl+K senza alcuna IA). Chiede cosa vuoi configurare e ti guida, passo dopo passo, lungo cinque percorsi: IA nel cloud, IA sul tuo computer con Ollama o LM Studio, IA sul tuo computer direttamente da LightNote, assistente da riga di comando e ricerca per significato. Accanto al pulsante, la tabella Cosa usa ogni funzione mostra quale IA serve la chat, Ctrl+K, l'IA del blocco, le attività automatiche e la ricerca per significato. I dettagli sono in IA sul tuo computer.

Senza chiave: LLM locale

Ancora nessuna IA? Usando Ctrl+K senza alcun assistente collegato, LightNote lo spiega e propone di collegarne uno subito — e appena lo colleghi, l'azione richiesta prosegue, senza ripetere la scorciatoia.

LLM locale (senza chiave). I provider locali — Ollama, LM Studio, llama.cpp — non richiedono una chiave API: scegline uno in Aggiungi (il selettore indica se il server è in esecuzione) e usa Cerca modelli… per scegliere tra i modelli che hai scaricato. Se Ollama non è installato, LightNote si offre di installarlo. È già registrato alla prima esecuzione: devi solo scegliere il modello. Poiché un modello locale può impiegare molto più tempo a rispondere (soprattutto alla prima generazione, mentre il modello viene caricato), LightNote lo attende molto più a lungo di un servizio cloud. Nessun tuo testo lascia la macchina.

Eseguire il modello senza alcun programma a parte. Oltre a Ollama e LM Studio, LightNote sa scaricare ed eseguire un modello da solo, con il programma ufficiale di llama.cpp: la procedura guidata Configura IA mostra prima quanto occupa su disco e in memoria e misura la velocità sul tuo computer. Vedi IA sul tuo computer.

Accettare, prompt e dove stanno le azioni

Accetta blocco per blocco. Quando il risultato arriva come diff, non devi accettarlo tutto: ogni blocco modificato ha una casella per includerlo o meno, e il testo finale viene ricostruito solo con i blocchi che tieni. Il prompt porta anche il contesto automatico del file (percorso, linguaggio e le righe attorno alla selezione), così l'IA risponde con più precisione senza che tu incolli nulla.

Libreria di prompt. IA → Libreria di prompt… conserva prompt riutilizzabili come file .md in una cartella Prompts/ del tuo spazio di lavoro — formato aperto, versionabile in Git e parte del tuo secondo cervello. Il selettore offre ricerca, anteprima e un pulsante per creare un nuovo prompt. Quando ne scegli uno, i campi {selection}, {file}, {folder}, {name} e {language} vengono riempiti con il contesto dell'editor corrente (le tue variabili sono preservate), e il testo viene inserito nel campo di Ctrl+K oppure inviato al terminale di IA attivo, senza inviarlo.

Non solo nell'editor di codice. Le azioni IA (Ctrl+K / Ctrl+I e il menu contestuale) funzionano anche nell'editor Markdown, nella nota incorporata delle Attività e nell'editor di query SQL del database: in ciascuno il popup si apre sopra il cursore e applica il risultato sul posto.

Tutte le azioni di IA stanno nel menu IA (nel pulsante ☰ e nel pulsante bacchetta della barra delle attività): Chiedi all'IA (Ctrl+K), Modifica con l'IA (Ctrl+I), Sessioni di IA, Chat IA, Libreria di prompt, Genera il file di contesto dello spazio di lavoro, Attiva l'IA in questa cartella e Configura gli assistenti di IA.

La finestra resta aperta mentre scrivi. Non si chiude quando fai clic nell'editor: puoi rileggere il codice o selezionare un altro punto senza perdere l'istruzione già scritta. La chiudono Esc, la ✕ della finestra stessa e le azioni di risultato (Accetta/Rifiuta). Cambiando scheda si mette da parte conservando quanto scritto: torna allo stesso file, premi Ctrl+K e l'istruzione ricompare dov'era.