QuickAgent - Guida

Guida utente di QuickAgent

QuickAgent è uno spazio di lavoro local-first per agenti AI. Trasforma un obiettivo in un Run duraturo, lo limita con un Workspace Profile, chiede una revisione prima delle azioni sensibili e conserva i risultati verificati negli Artifacts.

Per iniziare

Apri Impostazioni > AI, aggiungi un provider ed esegui il suo test di connessione.
Apri Impostazioni > Workspace Profiles. Scegli quale provider e quali strumenti, connessioni, radici di file, sorgenti Knowledge e ambiti di Memory possono essere usati.
Seleziona New Chat, scegli il profilo e conferma la destinazione del provider mostrata sopra la conversazione.
Descrivi un risultato atteso. Aggiungi solo i file, le cartelle, i contenuti multimediali, la Knowledge o la Memory necessari a questo Run.
Esamina il piano, le approvazioni, la conferma Critical e la Data Send Preview quando compaiono.
Segui il lavoro nella Timeline. Apri il risultato completato da Artifacts e ispeziona la traccia di controllo in Cronologia.

Suggerimento: Inizia con un Workspace Profile ristretto. Amplia i suoi strumenti o le sue radici solo quando QuickAgent mostra un motivo specifico di indisponibilità.

Panoramica dell'interfaccia

Sezione	A cosa serve
Chats	Conversazioni, destinazione del provider, Context Tray, piani, approvazioni e Timeline del Run attivo.
Runs	Ogni attività pianificata, in corso, in pausa, programmata, fallita o completata.
Approval Inbox	Revisioni di azioni in sospeso, Critical e Data Send che richiedono una tua decisione.
Artifacts	File, report, log, contenuti multimediali, tabelle e manifest delle operazioni verificati, creati dai Run.
Automations	Pianificazioni, monitor, webhook, eventi dell'app e trigger Shortcut/App Intent.
Skills	Istruzioni riutilizzabili con input tipizzati, strumenti consentiti, connessioni necessarie, rischio e output.
Connections	Provider, profili del browser, radici file/VFS, SSH, MCP, HTTP/SaaS, bridge domotici e canali di notifica.
Knowledge	Cartelle indicizzate, contenuti di QuickNote, ritagli web, PDF e sorgenti Office.
Cronologia	Decisioni di sicurezza, azioni degli strumenti, destinazioni e marche temporali, in sola aggiunta.
Impostazioni	Aspetto, lingua, AI, strumenti, sicurezza, Workspace Profiles, scorciatoie, permessi, Guida e Pro.

Provider e Workspace Profiles

QuickAgent può usare System AI quando il sistema operativo espone una funzionalità compatibile, provider locali come Ollama, LM Studio o DeskLLM, endpoint LAN o personalizzati compatibili con OpenAI e provider cloud configurati come Anthropic o Gemini. La disponibilità è determinata da un test di capacità in tempo reale; il solo nome di un provider non significa che sia pronto.

Un Workspace Profile è l'involucro dei permessi del Run. Cattura in un'istantanea il provider o modello selezionato, gli strumenti consentiti, le connessioni, le radici di file, le sorgenti Knowledge, gli ambiti di Memory, le deroghe di sicurezza e il budget. Una modifica successiva della configurazione rende obsoleta l'istantanea e richiede una revisione.

Regola sulla destinazione: QuickAgent non passa mai in silenzio da un provider on-device o locale al cloud. La destinazione attiva resta visibile nella Chat e in ogni revisione di Data Send.

Run, approvazioni e ripristino

Controlli del Run

Pause richiede un arresto cooperativo a un checkpoint duraturo.
Resume prosegue lo stesso Run e il lavoro già completato.
Arresta annulla il lavoro del provider e degli strumenti. Un effetto esterno interrotto o incerto non viene riportato come riuscito.
Retry è disponibile solo quando QuickAgent riesce a individuare un confine di ripetizione sicuro.

Livelli di sicurezza

Livello	Significato
Safe	Leggere, ispezionare o trasformare entro il profilo attivo.
Approve	Rivedere una normale scrittura o azione esterna.
Verifica che	Rivedere una modifica di maggiore impatto o più difficile da annullare.
Critical	Conferma forte ogni volta; le regole non la approvano mai automaticamente.

L'approvazione mostra il bersaglio esatto, la destinazione, gli argomenti proposti, il rischio e lo stato di Undo. Se modifichi un argomento, QuickAgent convalida e rivaluta il rischio dell'azione modificata.

Esito incerto: dopo un'interruzione, controlla prima il sistema di destinazione. Scegli “Ho verificato — riprova” solo quando ripetere l'azione è appropriato. “Resume” da solo non ripete mai un effetto esterno incerto.

Run multi-agente

Gli obiettivi complessi possono usare un planner, worker specializzati tipizzati, un revisore e un revisore per la sicurezza. La Timeline mostra ogni passaggio di consegne, revisione, ritentativo, fallback e confine della risposta finale. I worker ricevono solo l'intersezione a quattro vie tra strumenti della Skill, strumenti del Workspace Profile, strumenti del ruolo e strumenti attualmente disponibili.

Budget globali e per ruolo limitano invocazioni, tempo, costo, byte di rete e token. Quando un budget viene raggiunto, QuickAgent mette in pausa. Mostra i limiti attuali e quelli proposti, e li aumenta solo dopo una revisione esplicita. Il budget approvato e la cronologia dei ruoli completati sopravvivono a un riavvio.

Context, Knowledge e AI Memory

Context Tray

Aggiungi file, cartelle, immagini, fotogrammi video, audio, note vocali, contenuti di QuickNote, Knowledge o Workspace Memory. QuickAgent estrae o riassume i contenuti supportati e mostra se un allegato verrà inviato direttamente a un provider.

Knowledge

Le sorgenti Knowledge sono indicizzate separatamente dalla chat. Un Run può cercare solo nelle sorgenti consentite dal suo Workspace Profile e le citazioni conservano l'identità della fonte.

Memory

La Memory è deliberata, non una cronologia di chat automatica. Gli ambiti User, Workspace, Project e Tool/Connection sono separati. Ogni richiesta di creazione, modifica o eliminazione riceve una nuova approvazione, e l'anteprima dell'approvazione mostra l'ambito e il valore esatto proposto.

Strumenti e connessioni

Il catalogo attivo copre operazioni su file/VFS; Office, PDF e dati strutturati; contenuti multimediali e OCR; uso del browser e del computer; comandi di sviluppo; SSH; MCP; HTTP e SaaS; bridge domotici; notifiche; pianificazioni; monitor; e controllo delle automazioni. I server MCP collegati possono aggiungere strumenti dinamici dopo la convalida dello schema e una nuova valutazione del rischio da parte di QuickAgent.

Impostazioni > Tools mostra perché uno strumento è pronto o disattivato. I motivi più comuni sono una connessione mancante, un permesso del sistema operativo, una piattaforma non supportata, una restrizione del Workspace Profile, un endpoint non testato o una funzionalità del provider non disponibile.

Uso del computer: la cattura dello schermo e il controllo di accessibilità e input sono permessi distinti. Tieni disponibili l'anteprima visibile e lo Stop di emergenza. Le piattaforme mobili non offrono lo stesso controllo desktop senza restrizioni.

Automations

Le automazioni possono partire da trigger di tempo, file/cartella, web, webhook, email, calendario, rete, host, dispositivo, sensore, posizione, evento dell'app, Shortcut/App Intent, comando o manuali, quando la piattaforma li supporta. Un trigger crea un Run ordinario; non aggira i controlli di Workspace Profile, approvazione, Critical o Data Send.

Il monitoraggio su desktop prosegue solo mentre il processo dell'app è in esecuzione.
Le piattaforme mobili recuperano il lavoro arretrato quando l'app torna in primo piano.
Usa Shortcut/App Intent o un relay di eventi affidabile quando è necessaria la consegna da parte del sistema operativo.
Eventi in coda, pausa, annullamento ed eliminazione restano espliciti, così nessun evento viene scartato in silenzio.

Skills e Skill Pack

Una Skill memorizza un prompt orientato al risultato, variabili tipizzate, il provider consigliato, gli strumenti consentiti, le connessioni e le capacità richieste, il rischio massimo e gli Artifacts attesi. Prima dell'uso QuickAgent mostra gli input e i permessi effettivi; l'anteprima non concede di per sé alcun permesso.

Sette Pack integrati forniscono Skill reali per Office, Coding, Smart Home, Research, Browser Automation, Personal Admin e Incident Response. Puoi installare, aggiornare, disinstallare, personalizzare, duplicare, importare ed esportare Skill. Il JSON importato riceve un'anteprima di attendibilità, editore, firma, permessi, rischio, piattaforma e conflitti. “Mantieni entrambi” crea un derivato locale non firmato, invece di ereditare l'attendibilità di un altro editore.

Artifacts, cronologia e Undo

Gli Artifacts conservano i byte di output, i metadati, le versioni, la provenienza, il Run di origine e i manifest delle operazioni. In base alle capacità della piattaforma puoi aprirli, condividerli, esportarli o mostrarli nel file manager. Le operazioni idonee espongono un Undo sottoposto a revisione; il lavoro distruttivo o incerto non viene mai ripetuto automaticamente.

La cronologia è in sola aggiunta. Filtrala per Safe, Approve, Confirm o Critical ed esporta l'audit quando ti serve un registro esterno.

Impostazioni

Generale: aspetto, lingua, Workspace Profiles, scorciatoie, Guida e permessi.
AI: provider, endpoint, modelli, credenziali e test in tempo reale.
Tools: disponibilità del catalogo, supporto della piattaforma e motivi di configurazione.
Safety: regole di approvazione, comportamento di Data Send, autenticazione del dispositivo e policy di Memory per ambito.
Advanced: ripristino e diagnostica pensati per la risoluzione dei problemi.

Scorciatoie da tastiera

Su macOS l'app mappa le scorciatoie mostrate come Ctrl sul tasto Comando della piattaforma, dove opportuno. La pagina Scorciatoie nell'app è il riferimento autorevole e supporta la personalizzazione.

Scorciatoia	Azione
`Ctrl` + `N`	New Chat
`Ctrl` + `L`	Porta il focus sul campo di composizione
`Ctrl` + `Shift` + `Space`	Metti in pausa o riprendi il Run attivo
`Ctrl` + `.`	Arresta il Run attivo
`Ctrl` + `1` … `9`	Apri le Chat tramite History
`Ctrl` + `,`	Apri le Impostazioni
`F1`	Apri Guida & privacy
`Esc`	Chiudi una finestra di dialogo o annulla l'interazione non distruttiva in corso

Note sulle piattaforme

Piattaforma	Limiti importanti
macOS	In sandbox sia in Debug sia in Release. L'accesso ai file usa radici selezionate e segnalibri con ambito di sicurezza. Registrazione schermo e Accessibilità sono permessi di sistema distinti. Le integrazioni con processi locali e Shortcut restano soggette a test di capacità.
Windows	Le funzioni per file, Office/PDF/dati, browser, sviluppo, accesso remoto e controllo del desktop dipendono dal runtime installato e dai permessi. Le integrazioni riservate ad Apple non sono disponibili, con un motivo visibile.
iPhone / iPad	I file usano il selettore di sistema. Fotocamera, microfono, riconoscimento vocale, foto, rete locale e notifiche vengono richiesti nel contesto d'uso. Il monitoraggio in background non è garantito; usa Shortcuts/App Intents o il recupero in primo piano.
Android	File e cartelle usano lo Storage Access Framework. Il lavoro in background segue le restrizioni di Android. Il controllo dell'input basato sull'accessibilità non viene mai considerato concesso solo perché un servizio è dichiarato.
Web	Usa un'archiviazione limitata alla sessione per le funzioni che richiedono persistenza nativa e disattiva chiaramente le capacità non supportate relative a dispositivi, radici di file, processi locali e attività in background.

Consigli & trucchi

Inizia con un Workspace Profile ristretto e aggiungi uno strumento, una connessione o una radice di file solo quando il Run mostra un requisito specifico.

Assegna a ogni richiesta un risultato chiaro, un Artifact atteso e un confine di revisione, così i progressi restano facili da verificare.

Usa Knowledge per le sorgenti indicizzate riutilizzabili e Context per il materiale necessario solo al Run corrente.

Quando un effetto esterno è incerto, ispeziona la destinazione prima di riprovare; Resume non lo ripete mai automaticamente.

Risoluzione dei problemi

Problema	Cosa controllare
Il provider non funziona	Apri Impostazioni > AI. Controlla configurazione, autenticazione, capacità del modello, raggiungibilità dell'endpoint, timeout e dettagli sui limiti di frequenza, quindi esegui il test di connessione.
Uno strumento è disattivato	Apri Impostazioni > Tools e leggi il motivo aggiornato. Verifica la piattaforma corrente, i permessi, il test di connessione, il Workspace Profile e la radice selezionata.
Un Run sembra bloccato	Apri Runs e la Timeline. Potrebbe essere in pausa o in attesa di input, approvazione, conferma Critical, revisione Data Send o revisione del budget. Stop resta disponibile.
Un permesso è cambiato	Apri Guida > Panoramica oppure le Impostazioni, poi apri le impostazioni di sistema. Al ritorno, ripeti il test della connessione o dello strumento interessato.
Un'azione esterna è incerta	Controlla il sistema di destinazione. Tieni il Run in pausa o arrestalo, a meno che tu non abbia verificato che riprovare sia appropriato.
Un'automazione non è partita in background	I sistemi operativi mobili non garantiscono il polling arbitrario. Torna in primo piano per il recupero, oppure configura uno Shortcut/App Intent o una sorgente di eventi affidabile.
Un Artifact non si apre o non si esporta	Verifica se i suoi byte sono ancora disponibili, se la piattaforma supporta l'azione e se l'autorizzazione della destinazione scelta è ancora valida.

Privacy, autorizzazioni e licenze

QuickAgent memorizza in locale conversazioni, Run, approvazioni, metadati della Knowledge, Skill e impostazioni. Le credenziali usano l'archiviazione protetta dalla piattaforma. I contenuti lasciano il dispositivo solo tramite un provider o un servizio collegato che configuri e gli invii esterni ricevono un'anteprima specifica per la destinazione.

Le autorizzazioni vengono richieste nel contesto d'uso: file/cartelle, foto, fotocamera, microfono, riconoscimento vocale, rete locale, notifiche, registrazione dello schermo e accessibilità/controllo dell'input sono indipendenti. La rimozione di un'autorizzazione rende non disponibile la funzione interessata invece di produrre un falso successo.

Apri Impostazioni > Guida & Privacy per la tabella aggiornata delle funzionalità per piattaforma e Licenze open source per le note sui pacchetti e sui componenti nativi inclusi.

Free e Pro: tutte le funzioni dell'agente restano disponibili nella versione Free. La prova di sette giorni è senza pubblicità; in seguito, su mobile possono comparire annunci e su desktop un promemoria giornaliero. Pro rimuove questi messaggi tramite un abbonamento annuale o un acquisto a vita.