Tutto su Ava Supernova

Cos'è Ava?

Ava è un'intelligenza artificiale che fa davvero le cose, non si limita a parlare. Ti costruisce un'app, scrive un documento, ti insegna qualcosa da capo, progetta un logo o gestisce quella burocrazia che rimandi sempre. E si ricorda di te: su cosa stai lavorando, come preferisci fare le cose e cosa hai chiesto la settimana scorsa.

C'è una sola Ava, e lavora dove lavori tu — nel tuo editor di codice, come app desktop o nel terminale. Stessa memoria, stessa personalità, ovunque.

Cosa la rende diversa

• Tua di default. Il tuo lavoro rimane sulla tua macchina. Nessun tracciamento, nessuna telemetria — mai.
• Aperta a tutti. Ogni riga di codice di Ava è pubblica. Niente da accettare ciecamente.
• Gratuita per iniziare. 300 crediti al mese, senza carta di credito, senza sorprese — oppure inserisci le tue chiavi IA personali e non ci paghi assolutamente nulla.
• Didattica integrata. Chiedi ad Ava di insegnarti qualsiasi argomento e lei crea un vero corso: lezioni, esempi e quiz.

Non hai mai scritto codice? La pagina seguente è scritta proprio per te. Sei già esperto? Vai avanti — lei ti starà dietro.

Mai scritto codice? Inizia qui

Se non hai mai scritto una riga di codice, sei esattamente il tipo di persona per cui Ava è stata creata. Non serve imparare gergo tecnico per iniziare: le parli in linguaggio semplice, come faresti con un amico esperto. Questa pagina è tutta la tua rampa di partenza.

Cosa puoi fare oggi, senza esperienza

• Chiedile qualsiasi cosa, con parole normali: "cosa fa questo file?", "perché la mia pagina è vuota?", "cos'è anche un database?". Risponde in modo chiaro e ricorda la conversazione.
• Impara qualcosa da capo: dì "insegnami Python da zero" e lei crea un corso completo con lezioni e quiz.
• Fatti costruire qualcosa: descrivi cosa vuoi (ad esempio "un pulsante che scarica le mie note") e lei lo scrive, mostrandoti ogni modifica prima che avvenga.

Non devi capire tutto

Ava ha molto meccanismo sotto il cofano: modalità, modelli, specialisti, instradamento. Potresti vedere queste parole nell'app e in questa documentazione. Ecco il segreto: puoi ignorare quasi tutto. Ava sceglie gli strumenti giusti e gli assistenti giusti per te automaticamente. Le pagine tecniche ci sono quando ti incuriosisci, non perché ne hai bisogno per iniziare.

Un primo approccio gentile

1. Installa Ava (pagina successiva) e apri la chat.
2. Scrivi una domanda reale che hai. Qualsiasi cosa. Vedi come risponde.
3. Prova la modalità apprendimento: digita "insegnami" e un argomento. Seguila passo dopo passo.
4. Quando vuoi che lei crei o modifichi qualcosa, chiedi pure: ti mostrerà sempre cosa sta per fare e aspetterà il tuo "sì".

Installa

Scegli l'interfaccia che meglio si adatta al tuo modo di lavorare. Puoi utilizzarne più di una — sulla stessa macchina condividono una cartella ~/.ava, così la memoria di Ava ti accompagna da una all'altra.

Estensione VS Code

1. Apri il pannello Estensioni in VS Code (Ctrl+Shift+X / Cmd+Shift+X).
2. Cerca "Ava Supernova" e clicca su Installa.
3. Premi Ctrl+Shift+A (Cmd+Shift+A su macOS) per aprire il pannello della chat.
4. Segui la procedura guidata — scegli un modello, imposta la tua modalità di autorizzazione, fatto.

IDE Desktop

1. Scarica l'installer per la tua piattaforma dalla pagina delle release.
2. Esegui il file. L'IDE si avvia con un flusso di benvenuto la prima volta.
3. Accedi per ottenere i token gratuiti della piattaforma, oppure incolla la tua chiave API per eseguire tutto in locale.

CLI

1. npm install -g @ava/cli (o pnpm / yarn — scegli tu).
2. Esegui ava in qualsiasi directory del progetto.
3. Al primo avvio ti chiede un provider e un modello. Scegli e vai.

La tua prima cosa da fare con Ava

Il modo più veloce per usare Ava è chiederle qualcosa di concreto e vederla all'opera. Nessuna configurazione da leggere, niente da imparare prima: digli semplicemente cosa vuoi, con parole semplici.

Prova subito questo

1. Apri la chat.
2. Scrivi qualcosa che desideri davvero. Prova "spiega cosa fa questo progetto", oppure "aggiungi un pulsante che svuota il modulo".
3. Ava ti mostra cosa sta per fare — e aspetta.
4. Sei soddisfatto? Di sì. Guardala mentre lo fa.

Questo è tutto il ritmo: tu chiedi, lei ti mostra il piano, approvi, lei esegue. Non modifica mai nulla senza mostrartelo prima, così non puoi rompere nulla provando.

Alcune cose che vale la pena chiedere

• Una domanda — "perché la mia pagina è vuota?", "cosa fa questo file?"
• Qualcosa da costruire — "creami una pagina semplice per le liste di cose da fare".
• Per imparare qualcosa — "insegnami Python da zero". Costruisce per te un corso vero, passo dopo passo.
• Un documento — "scrivimi una proposta di progetto di una pagina". Ti consegnerà un file Word o PDF.

Locale o cloud, in un paragrafo

Tutto ciò che Ava conserva è locale. Memoria, attività, diario, personalità, impostazioni — tutto salvato sul tuo computer in ~/.ava/ e .ava/ (per progetto). Si connette ai provider dei modelli tramite HTTPS per elaborare la tua richiesta, poi torna a casa. Non richiama il server centrale. Non raccoglie telemetria. Non utilizza il tuo codice per l'addestramento.

Se ti accedi, ricevi 300 crediti gratuiti al mese su entrambe le flotte — Maestro su Qwen, e Supernova con un coordinatore DeepSeek. L'accesso non carica mai la tua memoria, attività o impostazioni — non esiste sincronizzazione cloud. Usa la tua chiave API e Ava funziona completamente senza account.

Devo scegliere un'IA?

È un sollievo: non scegli tu l'IA. Ava sceglie quella giusta per ogni passaggio automaticamente, così ottieni buoni risultati senza doverci pensare.

L'unica cosa che puoi scegliere è uno stile di instradamento — e quello predefinito va bene per quasi tutti. Ti servono gli altri solo per motivi specifici.

I due stili

• Maestro — il predefinito. Stabile, affidabile, prevedibile. Non sei sicuro? Questo è quello giusto.
• Supernova — per lavori pesanti e multistep, dove conviene affidare ogni parte del compito a uno specialista diverso.

Cambia in qualsiasi momento dal selettore dei modelli in alto nella chat. Nulla è bloccato.

Glossario in linguaggio semplice

Ogni parola che potresti incontrare intorno ad Ava, spiegata senza presupporre conoscenze pregresse. Non devi memorizzare nulla di tutto questo: torna indietro ogni volta che un termine ti crea difficoltà.

Instradamento — come Ava sceglie i modelli

Ecco la versione breve: non devi mai scegliere quale modello IA usare. Ava lo fa per te, scegliendo lo strumento migliore per ogni parte di un compito — proprio come un bravo capo assegna il compito giusto alla persona giusta.

Scegli uno dei due stili — Maestro o Supernova — e Ava invia ogni parte di lavoro al modello che lo gestisce meglio. Maestro è il predefinito, è attivo su tutti i piani ed è una buona scelta per quasi tutti.

Perché preoccuparsi dell'instradamento?

Mettere il modello giusto su ogni passaggio costa meno rispetto all'esecuzione di tutto su un unico grande modello costoso — e dà risultati migliori, perché ogni modello fa ciò in cui eccelle. Ottieni costi stabili e alta qualità senza dover mai sapere quale modello sia quale.

Crediti Ava — come funziona la fatturazione

I crediti sono semplicemente il modo in cui Ava conta ciò che usi — come i minuti su un piano telefonico. Ogni piano, incluso quello gratuito, viene fornito con un fondo di crediti, e ogni cosa che Ava fa (risponderti, creare un'immagine) costa un piccolo numero di essi. Questo è tutto il concetto. Il dettaglio qui sotto è per quando vuoi sapere esattamente quanto costa cosa.

Ava fattura in crediti, non in token grezzi. (Un "token" è il minuscolo pezzo di testo — circa poche lettere — che i modelli AI leggono e scrivono; la maggior parte dei servizi ti addebita per token, il che è difficile da prevedere.) Un credito copre un'unità di lavoro — un turno di chat, una creazione di persona (un assistente che svolge una parte del compito), una generazione immagine. Disaccoppiare dalla misurazione a livello di token significa che non devi sapere quale modello è attivo per sapere quanto costerà un'azione. Lo stesso turno di chat costa uguale sia che Maestro lo instradi a Qwen 3.7 Plus o che Supernova lo instradi a DeepSeek Flash.

Piani

Ogni piano ha accesso a tutte le funzionalità — accesso ai modelli, Creative Studio, tutti e sette le modalità, l'intera orchestrazione delle persone. I livelli superiori comprano più crediti e un limite di frequenza più alto, non funzionalità sbloccate.

• Gratuito — $0/mese. 300 crediti. Limite di frequenza 20 richieste/minuto. Nessuna carta richiesta.
• Pro — $19/mese. 5.000 crediti. 60 richieste/minuto.
• Ultra — $39/mese. 10.000 crediti. 120 richieste/minuto.
• Enterprise — $79/mese. 20.000 crediti. 200 richieste/minuto.

Quanto costano le cose

Tabella dei costi per azione — cosa viene detratto dal tuo pool di crediti quando ogni azione viene eseguita. (Un "cache hit" è quando Ava riutilizza lavoro già fatto invece di rifarlo; quando succede paghi meno — la tariffa scende del 70%, o del 50% sui modelli pesanti di output come DeepSeek Flash.)

• Turno di chat — 2 crediti. Un singolo scambio in qualsiasi modalità.
• Chiamata leggera — 1 credito. Intent gate, classificazione, lettura single-shot.
• Ruolo pesante — 3 crediti. Architetto, Ricercatore, Ricercatore CVE, Ideatore (profondità ≥ 4).
• Ruolo leggero — 1 credito. Esploratore, Verificatore, Sequenziatore, Sfidante (profondità ≤ 2).
• Orchestrazione — 10 crediti. Avvio completo del pipeline dei ruoli (Conduttore + compito multi-ruolo).
• Generazione immagini — 12 crediti. Creative Studio.
• Generazione video — 150 crediti (720p), 300 a 1080p. Creative Studio, tramite Wan.
• Generazione voce — 10 crediti. Creative Studio, tramite Qwen3-TTS.
• Rimozione sfondo — 2 crediti.

Moltiplicatori per modello

Questo è per i curiosi — non serve per usare Ava. Un moltiplicatore scala semplicemente il costo in crediti su o giù in base a quanto costa il modello dietro un'azione, quindi i modelli più pesanti costano un po' di più. (\"Margine netto\" è la fetta che il progetto trattiene dopo aver pagato le proprie spese — puntiamo basso così il valore torna da voi.)

Ogni modello ha un moltiplicatore che regola il costo di un'azione per tracciare quanto costa realmente eseguirlo — i modelli più leggeri costano meno della fascia base, quelli più pesanti di più. Calibrato per un margine netto del ~30%, riequilibrato verso il basso dal 55% e poi dal 40%: ogni volta che l'obiettivo scende, anche tutti i moltiplicatori scendono con esso e la differenza torna da te.

• 1.0× — qualsiasi modello senza moltiplicatore elencato. Tariffa base.
• Una flotta di per sé non aggiunge nulla. Ogni stile di routing è 1.0× per progettazione; il costo di un turno deriva interamente dai modelli che usa. Ecco perché spostare una flotta su un modello leader più economico abbassa ciò che addebita senza alcuna modifica di prezzo.
• Una nota su DeepSeek: applica tariffe doppie tra le 01:00–04:00 e dalle 06:00 alle 10:00 UTC. Ogni prezzo DeepSeek indicato qui e nel calcolatore dei costi è quello fuori dagli orari di punta, che vale per 17 ore su 24.

BYOK e crediti

BYOK ("portare la propria chiave" — fornisci il tuo account presso un fornitore di IA e una chiave, ovvero una password privata che consente al software di utilizzare quell'account a pagamento) è rivolto a chi paga già direttamente un fornitore di IA. Se non è il tuo caso, puoi ignorare questa sezione del tutto.

Le richieste BYOK bypassano completamente l'infrastruttura della piattaforma: la chiamata va diretta da Ava al fornitore, paghi il fornitore e non vengono consumati crediti. L'unica eccezione si verifica quando una sessione BYOK attiva un profilo di livello gestito per un compito secondario: la detrazione dei crediti si applica comunque perché viene utilizzata l'interfaccia di orchestrazione di Ava.

Dove controllare il saldo

• Estensione — Impostazioni → Account, oppure l'indicatore dei crediti nell'intestazione della chat.
• IDE — La scheda della dashboard Account mostra il saldo attuale e il tasso di consumo.
• Web — avasupernova.com/dashboard mostra saldo, cronologia e data di rinnovo.

Modalità — Gli stati d'animo di Ava

Una modalità è il modo di pensare di Ava — come un collega che cambia cappello. Stessa persona, stesso ricordo di te, ma un costruttore pensa diversamente da un insegnante. Scegli la modalità e questo cambia come si comporta e quali assistenti porta. Cambia quando vuoi con il selettore di modalità, oppure digita una scorciatoia di due caratteri.

Quale preferisci?

Parti da quello che stai cercando di fare — la modalità ne consegue:

• Voglio costruire o modificare qualcosa → Codice (>>). Lo descrivi, lei lo costruisce, mostrandoti ogni modifica prima. L'intero team di assistenti interviene per i lavori più grandi.
• Voglio un piano prima che cambi qualcosa → Piano (::). Ci riflette sopra e ti consegna un piano da approvare o modificare. In questa modalità non toccherà i tuoi file.
• Voglio solo parlare o chiedere → Chat (..). Un partner di pensiero con memoria, notizie e meteo. Nessuna modifica ai file, nessun codice — solo conversazione.
• Voglio imparare qualcosa → Insegna (??). Un vero corso costruito per te: lezioni, quiz, tutto. Disponibile su tutti i piani. Perfetto se sei nuovo.
• Voglio controllare il progetto per falle di sicurezza → Sicurezza (!!). Un team verifica l'elenco standard delle vulnerabilità web comuni (le categorie "OWASP") e le difetti noti segnalati (chiamati "CVE"), poi ti consegna un rapporto ordinato per gravità. Questo è rivolto agli sviluppatori — saltalo se non sei uno di loro.
• Voglio idee → Brainstorming (**). Genera opzioni basate sulla tua situazione reale, identifica i punti deboli e affina le altre in passi successivi.
• Voglio scrivere un documento → Scrivi (<<). Report, proposte, lettere, articoli — bozza in Markdown ed esporta un documento Word o PDF aziendale, affinando sezione per sezione. Niente codice, solo scrittura.

Memoria — come Ava ricorda te

In parole semplici: Ava ricorda te. Dille qualcosa una volta — cosa ti piace, una decisione che hai preso — e lei la conserva, così non devi ripeterlo nella prossima chat o la settimana prossima. Questa è la notizia principale. Gli strati qui sotto spiegano solo come mantiene quella memoria ordinata nel tempo.

Ava ha una memoria persistente ("persistente" significa che rimane attiva dopo aver chiuso l'app) che sopravvive attraverso conversazioni e progetti, e risiede solo sul tuo computer. Non è un registro di chat. È una comprensione strutturata e ricercabile di chi sei, cosa ti piace e quali decisioni hai preso.

Cinque livelli

1. Estrai — fatti chiave catturati da ogni messaggio in tempo reale.
2. Rifletti — analisi più approfondite alla fine delle sessioni significative. Pattern, temi, contraddizioni.
3. Accumula — correzioni e preferenze si accumulano nel corso di settimane e mesi.
4. Analizza — il motore a grafo collega memorie correlate e segnala contraddizioni quando nuove informazioni confliggono con quelle vecchie.
5. Consolida — memorie simili si fondono; quelle obsolete vengono eliminate. La memoria diventa più nitida col tempo, non più rumorosa.

Richiamo

Quando fai una domanda, Ava cerca nella memoria per significato ("ricerca semantica" — capisce cosa intendi, così trova la memoria giusta anche se la esprimi diversamente), non solo per corrispondenza esatta di parole. Filtri specifici per modalità si applicano insieme — Modalità Chat richiama contesto personale, Modalità Lavoro richiama decisioni di progetto e pattern di codice.

Compiti e diario

Ava tiene tre tipi di note per te, ed è facile confonderle. Il modo veloce per ricordarle: la memoria è ciò che sa di te, i compiti sono ciò che devi ancora fare, e il diario è un resoconto di come sono andate le cose. Ecco quando usare quale.

• Memoria — fatti persistenti. Preferenze, decisioni, schemi. Chiesti ripetutamente, raramente creati manualmente.
• Compiti — cose da fare. Azioni con scadenze e stato. Le spunti quando sono finite.
• Diario — riflessione. Registro giornaliero, voci doppie (tue e osservazioni di Ava sulla sessione). Utile per tracciare l'umore, revisioni della sessione, contesto per domani.

Ava scrive in tutte e tre quando ha senso. Puoi scrivere in ognuna direttamente dalla dashboard. Nulla è bloccato in un unico posto dove usi Ava — un compito che crei in uno (diciamo lo strumento a riga di comando) appare ovunque altrove (come l'app desktop), automaticamente.

Permessi — la manopola della tua sicurezza

I permessi sono la manopola della tua sicurezza. Decidono quando Ava chiede il tuo ok prima di fare qualcosa sul tuo computer, invece di procedere subito. Puoi impostarla per chiedere di tutto, chiedere solo sulle cose rischiose, o fidarti che giri — e puoi cambiarlo in qualsiasi momento. Se non sei sicuro, lascialo su predefinito e starai bene.

Ava dispone di oltre 120 strumenti (\"strumenti\" sono le azioni che può compiere — leggere un file, cercare sul web, eccetera). Ogni strumento appartiene a una categoria (operazioni sui file, terminale, Git, web, media, database, sistema, documenti, memoria, apprendimento). Ogni chiamata allo strumento passa attraverso il cancello delle autorizzazioni (un controllo che decide se chiederti prima) prima di essere eseguita. Tu controlli cosa viene approvato automaticamente, cosa chiede una volta e cosa chiede sempre.

Bilanciato è il predefinito. Rigido quando stai verificando il suo comportamento (guardando da vicino per controllare ogni passo). Autonomo quando vuoi che proceda da sola.

Guidare e fermare Ava

Sei sempre tu il responsabile. Mentre Ava è impegnata a lavorare, puoi sia indirizzarla verso una nuova direzione senza interrompere il flusso, sia fermarla immediatamente. Due pulsanti, due risultati — ecco tutto quello di cui parla questa pagina.

Ava continua finché il suo piano non è completato o finché non la fermi. Hai due modi per intervenire (il termine per questo è "intervenire") mentre sta lavorando.

Intervieni — guida senza annullare

Digita un nuovo messaggio mentre Ava lavora. Termina la chiamata dello strumento corrente, legge il tuo messaggio e aggiusta il suo piano. Nessun contesto viene perso. Usalo quando vuoi reindirizzare, aggiungere informazioni o cambiare priorità durante l'esecuzione.

Arresto immediato — annulla e pulisci

Premi Esc (CLI), clicca su Stop (estensione, IDE), o digita un comando di arresto. L'esecuzione corrente viene annullata, le chiamate degli strumenti in sospeso vengono eliminate e la conversazione è pronta per un nuovo turno.

Profili Desktop

Questa pagina è per i curiosi e per gli utenti esperti. L'"automazione desktop" (a volte chiamata "uso del computer") significa che Ava può effettivamente cliccare sullo schermo e usare le app per te — aprire Gmail, compilare un modulo, inviare un messaggio — come una persona alla tastiera. Per farlo in sicurezza, divide il lavoro tra cinque piccoli aiutanti, ognuno con un ruolo specifico. Non interagisci mai direttamente con loro; questa pagina ti mostra solo chi fa cosa.

Ogni passo in una traiettoria desktop (un'esecuzione di Ava che guida il tuo schermo verso un obiettivo) attiva un'onda di cinque ruoli. Ogni ruolo ha un compito e solo un compito. La separazione mantiene i prompt concisi, gli output strutturati e il ragionamento scettico per progettazione.

Esploratore

Riporta ciò che è visibile sullo schermo in questo momento. Non inventa elementi. Non pianifica. Restituisce un JSON ScreenState con ID elemento, nomi, bboxes, confidenza e una fonte di ancoraggio (UIA, Playwright DOM, o visione OmniParser).

Pianificatore

Decide l'unica azione successiva. Un'azione per passo — mai in batch. Preferisce percorsi reversibili. Classifica il rischio secondo l'ontologia di sicurezza. Produce un JSON ProposedAction con tipo, target, parametri, riskClass, ragionamento e una previsione expectedPostState.

Esecutore

Esegue esattamente quanto proposto dal Pianificatore — dopo che il cancello di approvazione è stato superato. Nessuna improvvisazione. Nessun tentativo di ripetizione. Il fallimento viene riportato fedelmente e il Verificatore gestisce il prossimo movimento.

Verificatore

Controlla se l'azione è andata a buon fine. Confronta il nuovo ScreenState con la previsione del Pianificatore. Restituisce verified, deviated, o rollback_needed. Esegue anche il rilevamento di loop — ripetere un'azione già riuscita è una deviazione, non una verifica.

Narratore

L'unica voce che l'utente sente durante una traiettoria. Una frase al passato per passo ("Aperto Gmail.", "Cliccato Componi."). Scrive anche il registro di audit strutturato. Dice quando qualcosa va storto — non nasconde mai un problema.

Ontologia di sicurezza desktop

In breve: prima che Ava clicchi qualsiasi cosa sul tuo schermo, classifica l'azione in base al rischio. Leggere lo schermo? Inoffensivo. Inviare denaro o eliminare qualcosa? Si ferma sempre e ti chiede prima — ogni singola volta, senza eccezioni. Le cinque etichette qui sotto sono solo i gradini di quella scala dei rischi. Questo è un dettaglio per utenti esperti, ma il concetto è semplice: le cose pericolose richiedono sempre il tuo sì.

Ogni azione proposta è classificata in una delle cinque classi di rischio. La classificazione combina tre segnali — qual è il bersaglio sullo schermo, una descrizione in linguaggio semplice ("didascalia semantica" — le parole di Ava su ciò che sta guardando), e le impostazioni dell'azione — ed eleva il livello (tratta come più rischioso) quando non concordano. Un falso positivo (chiedere quando non era necessario) è solo un fastidio. Un falso negativo (non chiedere quando avrebbe dovuto) è un incidente grave.

Le cinque classi

• Osservazionale — leggi albero UIA, screenshot, hover. Sempre consentito automaticamente.
• Navigazionale — scorri, sposta il focus, apri un menu. Consentito automaticamente in modalità Drive.
• Mutativo reversibile — digita in un campo, incolla, apri un'app, naviga su un URL. Conferma in modalità Chiedi; automatico in Drive se nella lista autorizzata.
• Mutativo irreversibile — invia, invia modulo, paga, cancella, conferma, pubblica. Conferma sempre, indipendentemente dal livello di permesso. L'approvazione non viene mai memorizzata.
• Privilegiati — elevazione UAC, sudo, modifiche al registro, richieste di credenziali. Vietati di default. Richiede un consenso esplicito singolo per ogni sessione.

Approvazioni mai memorizzate

Ogni concorrente memorizza le approvazioni (ricorda il tuo "sì" e lo usa la prossima volta). Questo è il punto di ingresso più grande per l'iniezione di prompt — un attacco in cui una pagina web insidiosa inserisce istruzioni nascoste nell'AI per farla agire contro di te. Se le approvazioni vengono memorizzate, una pagina compromessa può approfittare di un "sì" che hai dato in precedenza. Ava non memorizza mai. Ogni azione mutativa irreversibile richiede una nuova conferma.

Gestione dei segreti

Password, chiavi API e codici 2FA (i codici monouso che un'altra app o un SMS ti danno quando accedi) sono gestiti tramite riferimenti opachi — segnaposto che sostituiscono il valore reale. Ava vede "{secret}", non la password vera. Il valore reale non entra mai nella sua memoria, nel suo registro delle attività o in ciò che "legge" — uno strato separato a basso livello lo digita nell'ultimo istante, premendo i tasti, così la parte AI non lo tocca mai.

Gerarchia di ancoraggio desktop (Anteprima)

Prima che Ava possa cliccare un pulsante, deve capire davvero cosa c'è sul tuo schermo e dove si trovano le cose — questo è l'"ancoraggio" (capire cos'è ogni elemento sullo schermo e la sua posizione esatta). Ha tre modi per farlo e sceglie quello più affidabile che funziona per l'app che stai usando. Questo è un dettaglio tecnico avanzato; il punto è semplicemente che preferisce metodi solidi e precisi rispetto a indovinare da un'immagine.

Tre livelli, valutati in ordine. Vince la fonte affidabile più economica.

1. Finestra browser → Playwright DOM

Se la finestra attiva è un browser web, Ava legge la struttura stessa della pagina (il "DOM" — la lista sottostante di ciò che c'è su una pagina) invece di indovinare dall'immagine. Leggere la struttura è circa 10× più affidabile che guardare i pixel a occhio nudo — sa esattamente dove si trova ogni pulsante e quando la pagina ha finito di caricarsi. Questa è la strada principale per tutto ciò che è sul web, non un piano di riserva.

2. App nativa con UIA → Automazione interfaccia utente Windows

Per le normali app desktop su Windows, Ava legge una mappa di accessibilità integrata ("UIA", gli stessi dati usati dai lettori vocali per descrivere una finestra) — elenca ogni controllo, il suo nome e dove si trova. Se quella mappa restituisce almeno cinque elementi utilizzabili e nominati, si fida e li usa.

3. UIA vuota o inutilizzabile → Visione OmniParser

Quando quella mappa manca o è inutile (alcune app, giochi e schermi remoti non ne forniscono una), Ava ricade sull'effettivo sguardo allo screenshot. Uno strumento di visione (OmniParser) individua le aree cliccabili e etichetta cosa rappresenta ciascuna, trasformando l'immagine di nuovo in una lista su cui può agire — combinata con qualsiasi piccolo contributo che la mappa di accessibilità abbia fornito.

Interruttori di emergenza desktop (Anteprima)

Un "interruttore di emergenza" è esattamente quello che dice la parola — un modo d'emergenza per fermare Ava istantaneamente mentre controlla il tuo schermo. La parte rassicurante: ce ne sono tre, costruiti separatamente, quindi se uno fallisce un altro funziona comunque. Non devi imparare tutti e tre. Sappi solo che quando qualcosa sembra sbagliato, puoi sempre fermarla, e la fermata più forte (l'interruttore di panico qui sotto) non dipende dalla collaborazione di Ava.

Dopo aver letto ogni incidente pubblico di autonomia (casi reali in cui agenti AI hanno ignorato comandi di arresto, eliminato archivi email, cancellato dischi), abbiamo costruito tre interruttori di emergenza su tre livelli diversi. Nessuno di essi dipende dal modello AI stesso — se Ava è bloccata o non risponde, puoi ancora fermarla.

Pausa — barra spaziatrice o il pulsante Pausa

Si ferma al prossimo passo. Riprendibile. Usalo quando vuoi intervenire senza perdere il filo.

Stop — Esc o il pulsante Stop

Aborto pulito. Il narratore riassume cosa è stato fatto finora. Non riprendibile. Il registro di audit viene aggiornato.

Terminazione di emergenza — triplo-Esc o Ctrl+Shift+K

È la fermata più drastica in assoluto. Un piccolo programma watchdog separato chiude forzatamente la parte di Ava che controlla il tuo schermo. Non aspetta che l'IA risponda, non ha bisogno che la finestra dell'app sia attiva, e non gli importa in che stato siano le cose — si limita a spegnerla. È questa da usare quando qualcosa va davvero storto.

Riferimento agli strumenti

Questo è l'elenco completo di tutti gli strumenti di Ava — uno "strumento" è solo un'azione specifica che può compiere, come leggere un file o eseguire una ricerca. Non hai bisogno di leggere questa pagina. Ava sceglie lo strumento giusto lei stessa ogni volta. È qui quando sei curioso di sapere esattamente cosa può fare.

La cassetta degli attrezzi integrata completa. Ogni strumento qui è registrato nel runtime principale (il motore alla base di tutte e tre le interfacce) ed è disponibile per Ava quando la modalità e la modalità di autorizzazione lo permettono. Filtra per categoria o rischio.

Non c'è bisogno di memorizzare nulla — la tabella qui sotto è solo una scheda di riferimento.

Livelli di rischio

• Sicuro — legge le cose senza modificare nulla. file_read, glob (trova file per modello di nome), grep (cerca testo all'interno dei file), git_status (Git è il sistema che tiene traccia delle modifiche al tuo progetto).
• Scrivere — modifica file, salva un punto di controllo del tuo lavoro (un "commit"), o produce qualcosa di nuovo. file_edit, git_commit, generate_image.
• Pericoloso — esegue comandi sul tuo computer (il "terminale"), controlla il desktop, accede a internet, o interroga database. bash, browser, desktop_*.

Modelli

Un "modello" è il cervello IA che pensa — Qwen, DeepSeek, Mistral e altri. Questa pagina elenca tutti i modelli che Ava può utilizzare. In sintesi: non devi sceglierne uno. Ava sceglie il modello giusto per ogni passaggio lei stessa. Procedi con la lettura solo se vuoi capire o sovrascrivere questa scelta.

Tutti i modelli a cui Ava può indirizzare, più le tre strategie di orchestrazione — le regole che decidono quale modello gestisce ogni parte di un compito. Scegli una modalità di instradamento e lascia che Ava assegni, oppure scegli un singolo modello e salta l'instradamento del tutto.

Modalità di instradamento

Due strategie orchestrate. Lo stesso flusso di lavoro delle personalità (il piccolo team di assistenti specializzati che Ava gestisce dietro le quinte) è attivo su entrambe; ciò che cambia è la flotta di modelli sottostante. Scegli una modalità nel selettore dei modelli e Ava si occupa del resto. Ogni scheda qui sotto mostra gli specialisti coinvolti che il coordinatore instrada.

Non hai bisogno di memorizzare le schede qui sotto — sono qui perché puoi vedere di cosa è composta ciascuna strategia.

Modelli gestiti dalla piattaforma

Disponibili su ogni piano, incluso quello gratuito. I token (le unità con cui l'IA misura il testo — circa tre quarti di parola ciascuna) contano sul tuo limite del piano. Le chiavi (le password private che sbloccano ogni modello a pagamento) sono ruotate e monitorate dalla piattaforma — niente da configurare da parte tua.

Porta la tua chiave

Una "chiave API" è una password privata che permette al software di utilizzare un servizio a pagamento sul tuo account. "BYOK" significa semplicemente "porta la tua chiave" — usare la tua invece della nostra. Incolla la tua chiave API nelle impostazioni. Le richieste BYOK vanno direttamente da Ava al fornitore (l'azienda che gestisce il modello) — non passano attraverso la nostra infrastruttura e non consumano token della piattaforma. Paghi il fornitore; noi non vediamo il traffico.

Orchestrazione dei ruoli

Un "ruolo" è un incarico di supporto che Ava svolge dietro le quinte per compiti più difficili — un esploratore, un pianificatore, un verificatore di fatti. Non parli mai direttamente con loro e non hai bisogno di capire questa pagina per usare Ava. È qui quando sei curioso di sapere come lei scompone un grande compito in un piccolo team di esperti.

24 specialisti distribuiti su 5 team di modalità. Il Coordinatore (l'assistente che coordina gli altri) decide quale team eseguire, in che ordine e con quale contesto. La modalità Chat non ha ruoli — è la stessa Ava.

Come funziona l'orchestrazione

1. Invii un messaggio in modalità Piano, Insegna, Sicurezza o Brainstorm (o una richiesta di Lavoro complessa).
2. Il Coordinatore legge la richiesta, sceglie il team della modalità e costruisce un piano di esecuzione — alcuni ruoli vengono eseguiti in sequenza, altri in onde parallele.
3. Ogni ruolo ha il proprio prompt di sistema, un elenco consentito di strumenti limitato e un pool di contesto condiviso su ciò che hanno trovato i ruoli precedenti.
4. L'ultimo ruolo produce un riepilogo, un piano o un report, a seconda della modalità.
5. Ava ti presenta il risultato. Approvi, modifichi o reindirizzi.

L'elenco completo qui sotto è solo a scopo di riferimento — non c'è bisogno di memorizzare chi fa cosa. Ava assembla il team giusto per te.

Comandi CLI

Questa pagina è dedicata alla CLI — la versione di Ava con cui interagisci digitando in una finestra del terminale, invece di cliccare sui pulsanti. Se usi l'estensione o l'app desktop, puoi ignorarla del tutto. È presente per chi preferisce usare la tastiera.

La CLI è un REPL — un prompt che attende che tu digiti, esegue quanto scritto, poi attende di nuovo. Questi comandi slash (istruzioni che iniziano con "/") funzionano direttamente dal prompt.

• /help — elenca i comandi e la modalità corrente.
• /mode <nome> — cambia modalità (lavoro, scrittura, pianificazione, chat, insegnamento, sicurezza, brainstorming).
• /model <id> — cambia modello senza uscire dalla sessione.
• /clear — cancella la conversazione corrente. La memoria resta intatta.
• /history — elenca le conversazioni passate in questo progetto.
• /memory — apri il browser della memoria.
• /tasks — elenca e gestisci i compiti.
• /journal — apri l'entrata del diario di oggi.
• /settings — apri il menu delle impostazioni.
• /exit — esci dal REPL.

Flag di avvio

I flag sono opzioni aggiuntive da aggiungere quando avvii Ava, ognuna inizia con "--", per impostare come viene avviata.

• --mode <nome> — avvia in una modalità specifica.
• --model <id> — avvia con un modello specifico.
• --permission <modalità> — rigoroso / bilanciato / autonomo.
• --project <path> — imposta esplicitamente la radice del progetto.

Configurazione

Questa pagina mostra dove Ava conserva le sue impostazioni e i file sul tuo computer. Quasi mai dovrai toccarli manualmente: è l'app a gestirli per te. È qui se vuoi vedere, fare il backup o condividere quei file tu stesso.

Ava legge la configurazione (le sue impostazioni salvate) da due ambiti. Le impostazioni globali — quelle valide ovunque — risiedono in una cartella chiamata ~/.ava/ (il "~" è un'abbreviazione per la tua cartella home). Le impostazioni specifiche del progetto risiedono in una cartella .ava/ all'interno del progetto stesso.

Globale — ~/.ava/

• settings.json — preferenze del modello, modalità di permesso, personalità, lingua.
• memory/ — i tuoi ricordi globali (preferenze, decisioni che valgono ovunque).
• tasks.json — elenco dei compiti tra progetti.
• journal/ — voci del diario quotidiano, organizzate per data.

Progetto — .ava/

• instructions.md — istruzioni specifiche del progetto che Ava carica sempre. Contesto durevole ("usiamo pnpm, non npm", "le chiavi API vivono in 1Password").
• context.md — appunti sul progetto liberi opzionali.
• memory/ — ricordi limitati a questo progetto.
• datasets/config.json — configurazione per la cattura dei dataset, su base volontaria.

Scorciatoie da tastiera

Le scorciatoie da tastiera sono accelerazioni opzionali — ognuna di esse è anche un pulsante che puoi cliccare. Consulta questa sezione solo se vuoi interagire con Ava più velocemente usando la tastiera.

Scorciatoie per ambiente (ciascuno dei tre spazi in cui Ava opera: l'estensione VS Code, l'app desktop e il terminale). Personalizzali nelle impostazioni di ciascun ambiente. Non c'è bisogno di memorizzare l'elenco qui sotto.

Contesto del progetto

Questo spiega come Ava si documenta sul tuo progetto prima di iniziare — i file che consulta per capire su cosa stai lavorando. Non devi configurare nulla; lo fa da sola. Leggilo se vuoi sapere dove inserire una nota affinché la veda sempre.

Quando apri un progetto, Ava carica diversi livelli di contesto (informazioni di sfondo che tiene a mente). Capire questi livelli ti aiuta a inserire le informazioni nel posto giusto.

Caricati automaticamente

• .ava/instructions.md — considerata come guida duratura e prioritaria. Sempre presente nel contesto.
• .ava/context.md — appunti liberi. Caricati, con priorità inferiore.
• README.md — analizzato al primo avvio per il riepilogo del progetto.
• package.json / pyproject.toml / Cargo.toml — i piccoli file che elencano l'impostazione del progetto; letti per rilevare il linguaggio, il framework e il comando di test.
• .gitignore — l'elenco dei file da escludere dal controllo versione; rispettato da tutti gli strumenti sui file (glob, grep, project_index).

Caricati su richiesta

"Su richiesta" significa che Ava recupera questi elementi solo quando un compito ne ha effettivamente bisogno, invece di caricarli subito.

• Indice del progetto — una mappa strutturata dei tuoi file e delle parti nominate al loro interno (funzioni, classi — "simboli") e di come si collegano ("importazioni"). Costruito solo quando serve.
• Cronologia Git — il registro delle modifiche passate; recuperata quando vengono eseguiti git_status, git_diff o git_create_pr (Git è lo strumento che traccia ogni modifica al progetto; "PR" è una pull request, una proposta di gruppo di modifiche).
• Memoria — le voci vengono abbinate per significato ("semanticamente") e inserite una alla volta, non tutte insieme.

Limiti di budget per il desktop

Quando Ava controlla il tuo desktop per tuo conto — cliccando, digitando, aprendo app — ogni esecuzione è chiamata "traiettoria". Questa pagina spiega i limiti di sicurezza che impediscono a una singola esecuzione di durare troppo a lungo o costare troppo. Il concetto chiave: lei si ferma sempre e fa un controllo prima di superare i limiti. I numeri sono qui se vuoi i dettagli.

Ogni traiettoria opera sotto tre limiti simultanei (limiti rigidi). Vince quello raggiunto per primo. La traiettoria non prosegue mai silenziosamente oltre una violazione: il Narratore (l'assistente che ti accompagna spiegando cosa sta succedendo) si ferma e chiede cosa fare.

Tre limiti rigidi (predefiniti)

• Conteggio passaggi — 30 passaggi
• Budget token — 500,000 token
• Tempo reale — 5 minuti

Fasce di costo per compito

• Semplice (cerca documenti, apri una pagina) — 5–10 passaggi, ~70–135K token, ~$0.04–0.08
• Medio (accedi, controlla i log, scarica l'output) — 15–25 passaggi, ~205–340K token, ~$0.12–0.21
• Complesso (gestisci tre GitHub issue) — 25–30 passaggi, ~340–410K token, ~$0.21–0.25

Le cifre sui token sopra sono i limiti tecnici per traiettoria, non il tuo mensile — questo viene conteggiato in crediti, e i 300 al mese del piano gratuito coprono comodamente una miscela di chat, codice e alcune automazioni.

Lista autorizzata per sessione desktop

Una "lista autorizzata" è semplicemente l'elenco delle app e dei siti web che hai detto ad Ava essere autorizzati a toccare mentre controlla il tuo desktop. Questa pagina spiega come concedere tale permesso e perché si resetta ogni volta. In breve: può agire solo dove le permetti e chiede prima di andare da qualche parte di nuovo.

All'inizio di una sessione desktop Ava chiede dove è autorizzata ad agire. L'italiano semplice va bene: "Gmail, Cursor, il portale Azure." Lo legge e conferma la corrispondenza con te ("Gmail web, l'app Cursor, portal.azure.com").

Come viene applicato

Azioni solo visualizzazione — scattare uno screenshot, leggere l'elenco di pulsanti e campi sullo schermo (l'"albero UIA", la mappa propria di Windows di ciò che c'è in una finestra) — sono consentite ovunque, perché devi vedere cosa c'è sullo schermo per decidere se aggiungere un'app alla lista autorizzata. Tutto ciò che modifica qualcosa è bloccato fuori dall'elenco; Ava si ferma e chiede se aggiungerlo.

Confinato alla sessione, deliberatamente

La lista autorizzata NON persiste tra le sessioni. Non esiste l'opzione "ricorda questa app". Ogni nuova traiettoria inizia con un ambito nuovo. Scomodo per scelta progettuale — dimenticare di ri-autorizzare è una funzionalità, non un bug.

Aggiunte durante la traiettoria

Durante una traiettoria puoi aggiungere app dall'intestazione: "+ Consenti app" apre un piccolo campo di inserimento. Tocca Aggiungi e la nuova app è attiva per il resto della sessione.

Pacchetti di conoscenza

In parole povere: dai ad Ava una cartella con i tuoi documenti, e lei può leggerli per rispondere alle tue domande. Un "pacchetto di conoscenza" è proprio questo insieme di file — il materiale di riferimento che può consultare.

Trascina una cartella di materiale di riferimento (specifiche, RFC, appunti di riunione, documentazione API) in un pacchetto di conoscenza. Ava può estrarre i pezzi rilevanti nel contesto quando una conversazione tocca l'argomento.

I pacchetti sono indicizzati localmente. Il recupero è semantico — Ava trova il documento giusto per significato, non per nome file. ("Semantico" significa che abbina in base a di cosa parla un documento, quindi non devi ricordare le parole esatte o il nome del file.) I pacchetti possono essere condivisi con un team o tenuti privati.

Creative Studio

In parole semplici: descrivi l'icona, l'immagine, il video o la voce che vuoi, e Ava la progetta con te — niente software di design, niente gestione dei prompt.

Creative Studio è uno spazio di lavoro di progettazione guidato. Si apre in tre pannelli — i tipi di design a sinistra, la tua tela al centro e i controlli per l'elemento su cui stai lavorando a destra. Non c'è un pulsante "genera" da cercare: parli con l'Architetto del Design (Ava, nel suo ruolo di designer) in fondo allo schermo, lei esegue gli strumenti per te e tu raffini con pochi controlli chiari.

Cosa puoi creare oggi

• Icone — il prodotto principale. Parti da una forma di icona lineare reale (1.990 integrate), scegli un materiale e il colore del tuo brand, e Ava la ristila e la ritaglia in un PNG trasparente pulito.
• Immagini — libere, da una descrizione. Quadrato, orizzontale o verticale (1:1, 16:9, 9:16).
• Video — brevi clip AI da un prompt. 5 o 10 secondi, fino a 1080p, in orizzontale, verticale o quadrato.
• Doppiaggio — trasformazione del testo in voce naturale, con anteprima dell'onda sonora. Undici voci in dieci lingue.
• Brand Kit — la tua tavolozza, sempre a portata di mano perché ogni risorsa rispetti il brand.

Altri tipi di design — icone app, loghi, badge, avatar, banner, immagini copertina e social, illustrazioni, pattern e un set completo per lo sviluppo di giochi — stanno arrivando e appariranno come "presto" nella barra laterale sinistra.

Cosa lo rende possibile

Icone e immagini vengono generate con Qwen-Image, video con Wan e doppiaggi con Qwen3-TTS. Tutto ciò che crei finisce nella tua Libreria, classificato in base al tipo di creazione.

Creative Studio non è un extra a pagamento — è disponibile su tutti i piani, incluso quello Gratuito. Le generazioni usano il tuo normale credito, lo stesso budget del resto di Ava.

Salute e Nutrizione

In parole semplici: indica ad Ava il tuo obiettivo e cosa hai a disposizione, e lei costruisce un vero piano di allenamento e pasti — poi ti aiuta a seguirlo, giorno per giorno.

Salute e Nutrizione è un'area dedicata nel cruscotto. Ava chiede alcune cose su di te — il tuo obiettivo, le tue attrezzature, eventuali limiti — poi attinge a una vera libreria di esercizi e ricette per creare un piano su misura. I piani possono essere solo fitness, solo pasti, o entrambi insieme.

Come funziona

1. Ava chiede del tuo obiettivo e della configurazione tramite controlli semplici — schede obiettivo, etichette per le attrezzature, un campo numerico — niente muri di domande.
2. Crea un piano plurisettimanale dal catalogo, qualcosa che puoi realmente seguire con ciò che hai.
3. Lo segui giorno per giorno; Ava può integrare o modificare qualsiasi giornata singola man mano che le cose cambiano.

Tutto viene salvato nella tua libreria locale dei piani, sul tuo dispositivo. I cataloghi di ricette ed esercizi sono contenuti reali e curati — non inventati al volo.

Trasformare un piano in cibo

Un piano è utile solo se puoi comprarne gli ingredienti. La lista della spesa raccoglie tutti gli ingredienti della settimana e li ordina come in negozio — frutta e verdura, carne e pesce, latticini, forno, dispensa — così giri una volta sola invece di tornare indietro.

• La stessa cosa scritta in due modi viene unita. "Cipolla" e "cipolla tritata" diventano una riga, e ti dice quali piatti la volevano.
• Le quantità si adattano alla tua famiglia. Quel numero si applica qui e solo qui — il tuo piano resta a persona, quindi una famiglia di quattro non moltiplica le calorie di ogni giorno per quattro.
• Le unità sono scelte per leggibilità. Mezzo chilo di riso si legge come 500g.
• Le indicazioni senza misura rimangono. "Sale q.b." viene contato invece di essere scartato solo perché nessuno lo ha pesato.
• Scegli per quali pasti stai facendo la spesa. Tutto è selezionato all'inizio; togli uno se ce l'hai già. Questo tiene separato "Ce l'ho già" da "L'ho comprato", cosa che una semplice spunta non può esprimere.
• Se la lista non può coprire qualcosa, lo dice e spiega perché — invece di sembrare completa e poi risultare carente.

Quando cucinare davvero

Il piano di preparazione mostra dove cade il lavoro durante la settimana. Separa i minuti di lavoro attivo da quelli in attesa, perché nessuno sta davanti a uno stufato per quattro ore — la cottura conta come impegno fino a un'ora, non oltre, quindi un piatto lungo e lento appare più leggero di quanto indichi l'orologio, ed è proprio così per lo sforzo richiesto.

• Quale giorno porta più lavoro, così vedi un martedì pesante prima ancora di viverlo.
• Cosa va iniziato la sera prima — avena overnight e simili. Solo quando cambia davvero la tua serata; un riposo dell'impasto di novanta minuti non vale la pena di ricordartene.
• Cosa vale la pena cucinare una volta. Lo stesso piatto due volte nella settimana, dentro i giorni che mantiene, diventa cuoci lunedì, copri mercoledì, risparmi un'ora.
• Se hai detto ad Ava quanto tempo hai per cucinare, i giorni che superano il limite vengono segnalati. Se non l'hai fatto, nulla viene chiamato pesante — un budget non dichiarato è ignoto, non zero.

Registrare cosa è successo

I piani incontrano la vita reale. Apri qualsiasi giorno passato e segna ogni elemento: fatto o saltato, mangiato, mangiato qualcos'altro, o saltato. C'è una casella di note accanto, e dice chiaramente che Ava la legge — perché le persone scrivono diversamente quando sanno di essere lette, e scoprire dopo sembra di essere osservati.

Vuoto significa non registrato. Non significa saltato. Sono fatti diversi e Ava li tratta diversamente — non considererà mai un giorno vuoto come saltato.

Per l'allenamento c'è anche un registro più completo: serie, ripetizioni e peso, precompilati da ciò che il piano richiedeva, così nel caso comune bastano pochi tap e solo le differenze vanno digitate. Saltare è esattamente facile quanto registrare, deliberatamente — se saltare è nascosto, la gente lascia la riga vuota invece, e la distinzione si perde alla fonte.

Ciò che registri alimenta la memoria di Ava su come allenarti e mangiare davvero, così il consiglio della prossima settimana è modellato dalla realtà piuttosto che dal piano che ha scritto lei.

Ripetere e progredire

Copia un giorno o una settimana intera in avanti, eventualmente incrementata — una ripetizione in più, o una serie in più. La copia è incrementata, mai l'originale, così il lavoro che hai già fatto non viene riscritto.

Riscaldamenti, defaticamenti, lavoro di mobilità e giorni di recupero interi restano intatti. Aggiungere una serie a un giorno di recupero non è progresso, è trasformarlo silenziosamente in una sessione — l'esatto contrario di ciò che quel giorno era programmato per prevenire. Il carico non viene aumentato automaticamente nemmeno qui: il peso qui è testo libero, e aggiungere una percentuale a "peso corporeo" è assurdo.

Chiedere aiuto per un giorno

Bloccato di giovedì? Chiedi ad Ava di riempirlo, aggiungi un finisher, rendilo più facile, aggiungi più proteine, o fallalo più veloce. Lei propone — il giorno attuale sta accanto al suo suggerimento così vedi esattamente cosa cambia prima che tocchi il tuo lavoro, e nulla viene salvato finché non dai conferma.

Tutto viene salvato nella tua libreria di piani locale, sul tuo dispositivo. I cataloghi delle ricette e degli esercizi contengono contenuti reali e selezionati: le ricette prevedono tre livelli di difficoltà e il metodo completo, mentre gli esercizi includono guide alle tecniche, errori comuni e immagini dimostrative. Nulla è inventato al volo.

Apprendimento

In parole semplici: chiedi ad Ava di insegnarti qualcosa e lei crea un corso completo — lezioni, esempi pratici e quiz — poi ti guida passo dopo passo al tuo ritmo.

Apprendimento è un'area dedicata nel cruscotto. Ava pianifica un percorso per ciò che vuoi imparare, insegna lezione per lezione, verifica la tua comprensione con i quiz e tiene traccia di ciò che hai già visto, così puoi riprendere esattamente da dove avevi interrotto.

Come funziona

1. Indica ad Ava un argomento — "insegnami Python da zero", oppure "aiutami a capire i database".
2. Crea un corso strutturato: moduli, lezioni e checkpoint.
3. Impari una lezione alla volta; lei spiega, fornisce esempi e ti pone quiz per assicurarti che rimanga impresso.
4. Il tuo progresso viene salvato, quindi la prossima sessione ricomincia esattamente da dove avevi interrotto.

Alla base, questa è la modalità Insegnamento — un piccolo team di specialisti (un progettista curriculare, uno scrittore di contenuti, un verificatore di fatti, un maestro dei quiz e un tutor) che Ava coordina per te.

Office Suite

Ti serve un report, una mail o un documento scritto? Ava può abbozzarlo e consegnarti un vero file Word, Excel o PDF che puoi aprire e modificare come qualsiasi altro.

Report, email e documenti — abbozzati, formattati ed esportati in formati nativi (.docx è Word, .xlsx è Excel, .pdf è un PDF).

• report_generate — un .docx strutturato che attinge da task, diario, memoria e stato del progetto.
• email_draft — email con tono controllato salvata come file .docx.
• document_manage — crea, leggi, modifica ed esporta tra Word, Excel, PDF, CSV, Markdown.

Utile quando Ava scrive per te — report di stato, presentazioni di avvio, aggiornamenti ai clienti. Il .docx finisce nel tuo progetto dove puoi rifinirlo.

Libreria

In parole povere: uno scaffale unico per ciò che conservi — i documenti che stai leggendo, le risorse che hai creato e i testi che hai scritto — così nulla si perde.

La Libreria è una dashboard navigabile con tre schede:

• Articoli — articoli scientifici che hai salvato, recuperati da arXiv, OpenAlex e Crossref, con il testo completo da leggere direttamente qui.
• Risorse — tutto ciò che hai creato in Creative Studio, ordinato secondo gli stessi tipi di design usati per crearle (Open Canvas, Web / App, Game Dev). Filtra per gruppo, poi per tipo; ogni tipo mostra quanti ne hai.
• Documenti — i file Word, Excel, PDF e altri che Ava ha creato insieme a te, filtrabili per tipologia.

Una barra dello spazio in alto mostra quanto spazio usano i tuoi file locali e un pulsante "Apri cartella di salvataggio" ti porta direttamente nella cartella sul disco. È local-first — la Libreria legge ciò che si trova sul tuo computer.

Briefing giornaliero

In parole semplici: una breve nota ogni mattina ("ecco dove eri arrivato") così puoi riprendere senza rileggere tutto.

Riassunto mattutino: diario di ieri, task aperti, stato del progetto e eventuali promemoria impostati da Ava. Opzionale — attivalo nelle impostazioni.

Il briefing usa la memoria per mostrare contesto rilevante ("l'ultima volta che hai lavorato sul flusso di autenticazione, hai notato che volevi rivedere la strategia dei token di aggiornamento"). Non è un feed di notizie — è un aggiornamento mirato.

Workflow

In parole semplici: insegna ad Ava una routine che fai ripetutamente, dai le un nome e lei può eseguirla tutta di nuovo su richiesta. Un "workflow" è proprio quella routine salvata — un insieme di passaggi che Ava ripete per te.

Salva una sequenza di passaggi che trovi di ripetere — rivedi PR → esegui test → scrivi note di rilascio → bozza l'email. Un workflow è un piano riutilizzabile che Ava può riprodurre con input diversi.

I workflow sono archiviati per progetto in una cartella chiamata `.ava/workflows/` all'interno del tuo progetto. Condividili con il tuo team facendo il commit della directory (salvandola nel tuo progetto condiviso così anche i colleghi la ricevono).

Eventi e notifiche

In parole semplici: mentre Ava lavori ricevi un elenco ordinato passo dopo passo di ciò che sta facendo, e un avviso quando un lavoro lungo finisce così puoi allontanarti.

Mentre Ava è in esecuzione vedi aggiornamenti strutturati, non un muro di testo. Ogni chiamata strumento, ogni passaggio tra ruoli, ogni delta in streaming è un evento discreto nell'interfaccia — espandibile per i dettagli, comprimibile per la panoramica.

Le esecuzioni in background emettono notifiche di sistema quando completano. Puoi allontanarti da una build lunga e Ava ti dirà quando è finita.

Progettista della personalità

In parole semplici: regola come Ava ti parla — chiacchierona o breve, formale o informale, più battute o meno — così suoni come preferisci.

Modula come Ava ti parla. Tono, energia, verbosità (quanto dice), formalità, umorismo. Cursori e preset — ingegnere conciso, mentor accogliente, collega asciutto, o la tua miscela personale.

La personalità influisce sul modo di esprimersi, non sulla competenza. Esegue comunque gli stessi strumenti e segue le stesse regole di autorizzazione. Il suo nome è bloccato su Ava — questo è non negoziabile.

Automazione Desktop

In parole semplici: Ava può prendere il controllo del tuo mouse e della tastiera per eseguire compiti per te — aprire un'app, fare clic sui pulsanti, compilare un modulo — mentre tu guardi e approvi qualsiasi cosa importante.

Una nuova modalità per Ava, prefisso @@. Osserva il desktop, decide cosa fare e guida l'automazione dell'interfaccia utente (controllando le app sul tuo schermo per te) per completare il compito. Esegue sulla tua macchina reale con le tue credenziali reali — non un browser cloud. Disponibile su ogni livello una volta rilasciata.

Perché un'altra soluzione

La maggior parte dei prodotti per l'automazione desktop sono semplici cliccatori che fanno esattamente quello che viene detto. Ava pianifica per prima: ti mostra i passaggi, aspetta il tuo via libera e chiede conferma prima di qualsiasi azione irreversibile — ogni volta, senza salvare nulla.

Lei ricorda anche come navigare nelle tue app tra le sessioni. Ogni altro agente deve reimpararle ogni volta. La differenza data dalla memoria si accumula con l'uso.

Come funziona

Ogni passaggio attiva un'onda a cinque ruoli: Esploratore osserva, Pianificatore sceglie l'azione successiva, Esecutore esegue, Verificatore controlla, Narratore ti spiega cosa è successo. Il sidecar sceglie il metodo di ancoraggio più economico e affidabile — UIA per le app native, Playwright per i browser, visione OmniParser quando nessun altro offre un albero utile.

Consulta le pagine dei concetti per la ontologia di sicurezza, la gerarchia di ancoraggio, gli interruttori di sicurezza e il modello di lista bianca delle sessioni.

Errori comuni

Quasi tutti gli errori hanno una causa breve e precisa. Qui trovi quelli più frequenti e come risolverli. Non preoccuparti se le parole sembrano tecniche — ogni punto qui sotto ti spiega cosa stai vedendo e cosa devi fare esattamente.

Il modello non risponde

Cosa vedi: Ava si zittisce e non risponde.

Controlla l'indicatore di stato nell'intestazione della chat. Se vedi "in collegamento", il tuo fornitore (il servizio AI con cui Ava sta parlando) è raggiungibile ma lento — aspetta trenta secondi. Se leggi "non disponibile", Ava è tornata automaticamente al modello successivo nella catena (ha cambiato su un modello di riserva). Se non appare nulla, controlla la tua chiave API nelle Impostazioni e prova la connessione. (La chiave API è la password privata che permette ad Ava di utilizzare un servizio AI a pagamento.)

Chiamata strumento fallita

Cosa vedi: uno dei passaggi di Ava (una "chiamata strumento" — mentre legge un file, esegue un comando, ecc.) mostra un errore rosso invece di completarsi.

Clicca sulla chiamata strumento fallita per vedere l'errore. Cause comuni: ha provato ad accedere a un file fuori dalla cartella del progetto, bloccato appositamente per la tua sicurezza (questo controllo si chiama protezione "path traversal" — evita che esca dalla cartella in cui stai lavorando); un comando che richiede un'altra cartella; oppure un file spostato dall'ultima volta che Ava lo ha controllato. Spiegale cosa è successo — riproverà correggendo.

Memoria non ricorda

Cosa vedi: Ava non trova qualcosa di cui sei sicuro dovrebbe ricordare.

La memoria funziona per significato, non per parole esatte (questo è il senso di "semantic"). Quindi "Cosa ho deciso sull'autenticazione?" funziona meglio di "trova la mia decisione sull'autenticazione". Se la memoria è sicuramente presente ma non appare, apri il browser della memoria e cerca — se non c'è, non è mai stata salvata.

Loop di accesso

Cosa vedi: accedi, ma Ava continua a chiederti di accedere di nuovo — un loop che non ti fa passare.

La soluzione è cancellare i dati di accesso salvati e ricominciare da zero: nell'estensione esegui "Ava: Esci" dal pannello comandi, nell'IDE vai su Impostazioni → Account → Esci, nel CLI elimina il file in ~/.ava/auth.json (un piccolo file di accesso in una cartella chiamata .ava nella tua home). Poi accedi di nuovo.

Token esauriti

Cosa vedi: un messaggio che indica che hai finito l'utilizzo gratuito del mese. (I "token" sono l'unità di misura dell'uso AI — "esauriti" significa semplicemente che hai consumato tutto il tuo credito gratuito mensile.)

Il budget mensile gratuito si azzera il 1° di ogni mese. Fino ad allora, passa a un provider BYOK (usa la tua chiave API) per continuare a lavorare. Il tuo account resta attivo — solo le richieste gratuite gestite dalla piattaforma sono sospese.

Dove trovare i log

Un "log" è semplicemente un diario che il tuo computer tiene di quanto accaduto — utile quando qualcosa si blocca e tu (o l'assistenza) dovete vedere i dettagli.

Quando hai bisogno del quadro completo — quale strumento è stato chiamato, quali informazioni ha ricevuto, cosa ha restituito il servizio AI — i log sono file di testo semplice in una cartella sul tuo computer alla posizione ~/.ava/logs/ (una cartella chiamata .ava nella tua home, contenente una cartella logs).

• ~/.ava/logs/session-<date>.log — trascrizioni per sessione incluse chiamate strumento, risposte in streaming ed errori.
• ~/.ava/logs/extension.log — log dell'host delle estensioni VS Code. Errori di attivazione, errori del pannello.
• ~/.ava/logs/ide.log — log dell'IDE desktop. Messaggi del processo sidecar, panic di Rust.
• ~/.ava/logs/cli.log — log REPL del CLI.

Nell'estensione, "Ava: Mostra Log" nel pannello comandi apre il log pertinente in una scheda dell'editor. Nell'IDE, Impostazioni → Diagnostica ha un pulsante "Apri Log". Il CLI può monitorare il proprio log con ava logs --follow.

Invio di una richiesta di supporto

In parole semplici: se qualcosa non funziona e le soluzioni indicate sopra non hanno risolto, facci sapere. Il modo più semplice è chiedere ad Ava di farlo per te.

Se il problema non rientra negli errori comuni, apri un ticket di assistenza (invia una richiesta di aiuto al nostro team). Puoi farlo direttamente in Ava (senza moduli da compilare) oppure dal sito web.

Dall'interno di Ava

Chiedile di farlo. "Ava, puoi aprire un ticket di supporto su questo?" Lei esegue la funzione support_request, allega il contesto della sessione pertinente (con le credenziali oscurate) e lo invia. È la via più rapida.

Dal sito web

Vai su avasupernova.com/support. Scegli una categoria (bug, feature, account, security, general) e descrivi cosa è accaduto. Risponderemo entro un giorno lavorativo.

Cosa includere

• Cosa stavi cercando di fare.
• Cosa è successo effettivamente.
• Quale interfaccia (estensione, IDE, CLI) e quale versione.
• Qualsiasi messaggio di errore o estratto dai log. Rimuovi le credenziali prima.

Segnalazione di problemi di sicurezza

In parole semplici: se hai individuato un modo in cui Ava potrebbe essere violata o usata impropriamente (una "vulnerabilità" — una debolezza di sicurezza), per favore comunicacelo privatamente prima, così possiamo risolverla prima che qualcuno ne approfitti. Questa pagina ti spiega come.

Hai trovato una vulnerabilità? Grazie. Prendiamo ogni segnalazione sul serio e lavoriamo insieme alla soluzione prima di qualsiasi diffusione pubblica (prima che il problema venga annunciato ufficialmente).

Come segnalare

1. Invia un'email a security@ava-supernova.com con una descrizione, i passaggi per riprodurre l'errore e il periodo di divulgazione preferito.
2. Oppure apri un ticket di supporto con categoria "security" — entra nella stessa coda di valutazione.
3. Riceverai conferma entro 24 ore.

I nostri impegni

• Divulgazione coordinata — concordiamo una tempistica con te prima che tutto diventi pubblico. Il termine predefinito è di 90 giorni.
• Riconoscimento — riceverai credito nelle note di correzione, a meno che tu non preferisca rimanere anonimo.
• Nessuna ritorsione legale — la ricerca condotta in buona fede è benvenuta. Non intraprenderemo azioni legali nei tuoi confronti.