Guida introduttiva a Google Antigravity

1. Introduzione

In questo codelab, imparerai a conoscere Google Antigravity (denominato Antigravity per il resto del documento), una piattaforma di sviluppo agentico che trasforma l'IDE nell'era incentrata sugli agenti.

A differenza degli assistenti di programmazione standard che completano automaticamente le righe, Antigravity fornisce un "Mission Control" per la gestione di agenti autonomi in grado di pianificare, programmare e persino navigare sul web per aiutarti a creare.

Antigravity è progettata come piattaforma incentrata sugli agenti. Presuppone che l'AI non sia solo uno strumento per scrivere codice, ma un attore autonomo in grado di pianificare, eseguire, convalidare e ripetere attività di ingegneria complesse con un intervento umano minimo.

Cosa imparerai a fare

Installazione e configurazione di Antigravity.
Esplorare i concetti chiave di Antigravity come Agent Manager, Editor, Browser e altro ancora.
Personalizzazione di Antigravity con regole e workflow personalizzati, oltre a considerazioni sulla sicurezza.

Che cosa ti serve

Al momento Antigravity è disponibile in anteprima per gli account Gmail personali. È dotato di una quota senza costi per l'utilizzo dei modelli di punta.

Antigravity deve essere installato localmente sul tuo sistema. Il prodotto è disponibile su Mac, Windows e distribuzioni Linux specifiche. Oltre alla tua macchina, avrai bisogno di:

Browser web Chrome.
Un account Gmail (account Gmail personale).

Questo codelab è progettato per utenti e sviluppatori di tutti i livelli (inclusi i principianti).

Problemi relativi ai report

Mentre lavori al codelab e con Antigravity, potresti riscontrare problemi.

Per problemi relativi al codelab (errori di battitura, istruzioni errate), apri un bug con il pulsante Report a mistake nell'angolo in basso a sinistra di questo codelab:

Per bug o richieste di funzionalità relativi ad Antigravity, segnala il problema all'interno di Antigravity. Puoi farlo in Agent Manager con il link Provide Feedback nell'angolo in basso a sinistra:

Puoi anche accedere all'editor tramite il link Report Issue sotto l'icona del tuo profilo:

2. Installazione

Se non hai ancora installato Antigravity, iniziamo con l'installazione. Al momento il prodotto è disponibile in anteprima e puoi utilizzare il tuo account Gmail personale per iniziare a utilizzarlo.

Vai alla pagina Download e fai clic sulla versione del sistema operativo appropriata per il tuo caso. Avvia il programma di installazione dell'applicazione e installala sul tuo computer. Una volta completata l'installazione, avvia l'applicazione Antigravity. Dovresti visualizzare una schermata simile alla seguente:

Procedi facendo clic su Next ogni volta. Di seguito sono descritti i passaggi chiave:

Scegli il flusso di configurazione:viene visualizzata l'opzione per importare le impostazioni esistenti di VS Code o Cursor. Inizieremo da zero.
Scegliere un tipo di tema dell'editor: noi sceglieremo il tema scuro, ma la decisione spetta a te.
Come vuoi usare l'agente Antigravity?

Vediamo questo aspetto in modo più dettagliato. Ricorda che le impostazioni possono essere modificate in qualsiasi momento tramite le impostazioni utente di Antigravity (Linux/Windows: Ctrl + , Mac: Cmd + ,).

Prima di esaminare le opzioni, diamo un'occhiata ad alcune proprietà specifiche (che vedi a destra della finestra di dialogo).

Policy di esecuzione del terminale

Si tratta di dare all'agente la possibilità di eseguire comandi (applicazioni/strumenti) nel terminale:

Procedi sempre:esegui sempre automaticamente i comandi del terminale (ad eccezione di quelli in un elenco di negazione configurabile).
Richiedi revisione:richiedi la revisione e l'approvazione dell'utente prima di eseguire i comandi del terminale.

Norme relative alle recensioni

Mentre l'agente svolge il suo compito, crea vari artefatti (piano delle attività, piano di implementazione e così via). Le norme relative alle recensioni sono impostate in modo da poter determinare chi decide se è necessaria una revisione. Se vuoi sempre rivederlo o lasciare che sia l'agente a decidere. Di conseguenza, anche qui sono disponibili tre opzioni.

Procedi sempre:l'agente non chiede mai una revisione.
L'agente decide:l'agente deciderà quando chiedere la revisione.
Richiedi recensione:l'agente chiede sempre una recensione.

Policy di esecuzione di JavaScript

Se attivata, l'agente può utilizzare gli strumenti del browser per aprire URL, leggere pagine web e interagire con i contenuti del browser. Questa norma consente di stabilire come viene eseguito JavaScript nel browser.

Procedi sempre:l'agente non si fermerà per chiedere l'autorizzazione a eseguire JavaScript nel browser. In questo modo, l'agente ha la massima autonomia per eseguire azioni e convalide complesse nel browser, ma è anche il più esposto agli exploit di sicurezza.
Richiedi revisione:l'agente si fermerà sempre per chiedere l'autorizzazione a eseguire il codice JavaScript nel browser.
Disattivato:l'agente non eseguirà mai codice JavaScript nel browser.

Ora che abbiamo compreso le diverse norme, le quattro opzioni a sinistra non sono altro che impostazioni specifiche per le norme di esecuzione, revisione e JavaScript del terminale per tre di queste e una quarta opzione disponibile in cui possiamo controllarle in modo completamente personalizzato. Queste quattro opzioni sono disponibili per consentirci di scegliere il livello di autonomia che vuoi concedere all'agente per eseguire i comandi nel terminale e far esaminare gli artefatti prima di procedere con l'attività.

Queste quattro opzioni sono:

Modalità sicura: la modalità sicura fornisce controlli di sicurezza avanzati per l'agente, consentendoti di limitarne l'accesso a risorse esterne e operazioni sensibili. Quando la modalità sicura è attivata, vengono applicate diverse misure di sicurezza per proteggere l'ambiente.
Sviluppo basato sulla revisione (consigliato): l'agente chiederà spesso una revisione.
Sviluppo basato sull'agente: l'agente non chiederà mai una revisione.
Configurazione personalizzata

L'opzione Sviluppo basato sulla revisione è un buon compromesso ed è quella consigliata, in quanto consente all'agente di prendere una decisione e tornare dall'utente per l'approvazione.

La pagina successiva è Configura l'editor, dove puoi scegliere le tue preferenze per quanto riguarda:

Combinazioni di tasti: puoi configurare le combinazioni di tasti.
Estensioni: puoi installare le estensioni più usate per le lingue e altre estensioni consigliate.
Riga di comando: puoi installare lo strumento a riga di comando per aprire Antigravity con agy.

Ora puoi accedere a Google. Come accennato in precedenza, Antigravity è disponibile in modalità di anteprima e senza costi se hai un account Gmail personale. Accedi ora con il tuo account. Si aprirà il browser, che ti consentirà di accedere. Se l'autenticazione ha esito positivo, viene visualizzato un messaggio simile a quello riportato di seguito e si torna all'applicazione Antigravity. Segui il flusso.

Infine, i Termini e condizioni d'uso. Puoi decidere se attivare o meno l'opzione e poi fare clic su Next.

Ti troverai di fronte al momento della verità, in cui Antigravity ti aspetterà per collaborare con te.

3. Agent Manager

Siamo pronti per iniziare.

Antigravity si basa sul codice open source di Visual Studio Code (VS Code), ma modifica radicalmente l'esperienza utente per dare la priorità alla gestione degli agenti rispetto alla modifica del testo. L'interfaccia è suddivisa in due finestre principali distinte: Editor e Agent Manager. Questa separazione delle responsabilità rispecchia la distinzione tra il contributo individuale e la gestione dell'ingegneria.

Agent Manager: Mission Control

All'avvio di Antigravity, l'utente non visualizza in genere una struttura ad albero dei file, ma Agent Manager, come mostrato di seguito:

Questa interfaccia funge da dashboard Mission Control. È progettato per l'orchestrazione di alto livello, consentendo agli sviluppatori di generare, monitorare e interagire con più agenti che operano in modo asincrono in diversi spazi di lavoro o attività.

In questa visualizzazione, lo sviluppatore funge da architetto. Definiscono obiettivi di alto livello, ad esempio:

Refactoring del modulo di autenticazione
Aggiorna l'albero delle dipendenze
Genera una suite di test per l'API Billing

Come indicato nel diagramma precedente, ognuna di queste richieste genera un'istanza dell'agente dedicata. L'interfaccia utente fornisce una visualizzazione di questi flussi di lavoro paralleli, mostrando lo stato di ogni agente, gli artefatti che ha prodotto (piani, risultati, differenze) e le richieste in attesa di approvazione umana.

Questa architettura risolve una limitazione fondamentale dei precedenti IDE, che offrivano un'esperienza più simile a quella di una chat, lineare e sincrona. In un'interfaccia di chat tradizionale, lo sviluppatore deve attendere che l'AI finisca di generare il codice prima di porre la domanda successiva. Nella visualizzazione Manager di Antigravity, uno sviluppatore può inviare cinque agenti diversi a lavorare su cinque bug diversi contemporaneamente, moltiplicando di fatto il throughput.

Se fai clic su Next sopra, puoi aprire uno spazio di lavoro.

Pensa allo spazio di lavoro come lo conoscevi da VS Code e il gioco è fatto. Per aprire una cartella locale, fai clic sul pulsante e seleziona una cartella da cui iniziare. Nel mio caso, avevo una cartella nella mia home directory denominata my-agy-projects e l'ho selezionata. Puoi utilizzare una cartella completamente diversa. Tieni presente che puoi saltare completamente questo passaggio, se vuoi, e aprire uno spazio di lavoro in un secondo momento.

Una volta completato questo passaggio, si aprirà la finestra Agent Manager, mostrata di seguito:

Noterai che l'applicazione è immediatamente impostata per avviare una nuova conversazione nella cartella dello spazio di lavoro (my-agy-projects) selezionata. Puoi utilizzare le tue conoscenze esistenti sull'utilizzo di altre applicazioni AI (Cursor, Gemini CLI) e utilizzare @ e altri modi per includere ulteriore contesto durante la richiesta.

Controlla i menu a discesa Planning e Model Selection. Il menu a discesa Selezione modello ti consente di scegliere uno dei modelli disponibili al momento da utilizzare per l'agente. L'elenco è riportato di seguito:

Analogamente, l'agente sarà in modalità Planning predefinita. Ma possiamo anche scegliere la modalità Fast.

Vediamo cosa dice la documentazione in merito:

Planning: un agente può pianificare prima di eseguire le attività. Utilizzalo per ricerche approfondite, attività complesse o lavoro collaborativo. In questa modalità, l'agente organizza il suo lavoro in gruppi di attività, produce artefatti ed esegue altri passaggi per ricercare, analizzare e pianificare a fondo il suo lavoro per una qualità ottimale. Qui vedrai molti più output.
Fast: un agente eseguirà le attività direttamente. Utilizzalo per attività semplici che possono essere completate più rapidamente, ad esempio rinominare variabili, avviare alcuni comandi bash o altre attività più piccole e localizzate. Questa opzione è utile quando la velocità è un fattore importante e l'attività è abbastanza semplice da non preoccuparsi di una qualità peggiore.

Se hai familiarità con il budget di pensiero e termini simili negli agenti, considera questa funzionalità come la possibilità di controllare il pensiero dell'agente, con un impatto diretto sul budget di pensiero. Per ora utilizzeremo le impostazioni predefinite, ma ricorda che al momento del lancio, la disponibilità del modello Gemini 3 Pro è limitata a tutti, quindi riceverai messaggi appropriati che indicano se hai esaurito le quote senza costi per l'utilizzo di Gemini 3.

Dedichiamo un po' di tempo all'Agent Manager (finestra) e vediamo alcune cose, in modo da avere chiarezza sugli elementi di base, su come navigare in Antigravity e altro ancora. Di seguito viene mostrata la finestra di Agent Manager:

Fai riferimento al diagramma sopra con i numeri:

Start Conversation: fai clic qui per iniziare una nuova conversazione. Verrà visualizzato direttamente il campo di input in cui è presente la dicitura Ask anything.
Workspaces: Abbiamo parlato degli spazi di lavoro e della possibilità di lavorare in qualsiasi spazio di lavoro. Puoi aggiungere altri spazi di lavoro in qualsiasi momento e selezionarne uno quando avvii la conversazione.
Editor View: puoi passare in qualsiasi momento alla visualizzazione dell'editor. Verranno visualizzati la cartella dell'area di lavoro e tutti i file generati. Puoi modificare direttamente i file o fornire indicazioni e comandi in linea nell'editor, in modo che l'agente possa eseguire un'azione o apportare una modifica in base ai tuoi consigli/istruzioni modificati. Analizzeremo in dettaglio la visualizzazione dell'editor in una sezione successiva.

4. Browser Antigravity

Come indicato nella documentazione, quando l'agente vuole interagire con il browser, richiama un subagente del browser per gestire l'attività in questione. Il subagente del browser esegue un modello specializzato per operare sulle pagine aperte nel browser gestito da Antigravity, che è diverso dal modello selezionato per l'agente principale.

Questo subagente ha accesso a una serie di strumenti necessari per controllare il browser, tra cui fare clic, scorrere, digitare, leggere i log della console e altro ancora. Può anche leggere le pagine aperte tramite l'acquisizione DOM, gli screenshot o l'analisi markdown, nonché acquisire video.

Ciò significa che dobbiamo avviare e installare l'estensione del browser Antigravity. Vediamo come fare avviando una conversazione e seguendo i passaggi.

Avvia una nuova conversazione in uno spazio di lavoro e assegna il seguente compito: go to antigravity.google

Invia l'attività. Vedrai l'agente analizzare l'attività e potrai esaminare il processo di pensiero. A un certo punto, procederà correttamente e menzionerà la necessità di configurare l'agente del browser come mostrato di seguito. Fai clic su Setup.

Verrà visualizzato il browser e un messaggio che ti invita a installare l'estensione, come mostrato di seguito:

Continua e verrà visualizzata l'estensione di Chrome che potrai installare.

Una volta installata l'estensione, Antigravity Agent inizierà a funzionare e ti chiederà l'autorizzazione per svolgere la sua attività. Dovresti vedere alcune attività nella finestra del browser che è stata aperta:

Torna alla visualizzazione Gestore agenti e dovresti vedere quanto segue:

Questo è esattamente ciò che ci aspettavamo che accadesse, dato che abbiamo chiesto all'agente di visitare il sito web antigravity.google. Concedi l'autorizzazione e vedrai che il sito web è stato visitato in modo sicuro, come mostrato di seguito:

5. Artefatti

Antigravity crea artefatti mentre pianifica ed esegue il suo lavoro per comunicare il suo lavoro e ricevere feedback dall'utente umano. Si tratta di file Markdown avanzati, diagrammi dell'architettura, immagini, registrazioni del browser, differenze di codice e così via.

Gli artefatti colmano il "divario di fiducia". Quando un agente afferma "Ho corretto il bug", lo sviluppatore doveva leggere il codice per verificare. In Antigravity, l'agente produce un artefatto per dimostrarlo.

Di seguito sono riportati gli artefatti principali prodotti da Antigravity:

Task Lists: prima di scrivere il codice, l'agente genera un piano strutturato. In genere non è necessario modificare questo piano, ma puoi esaminarlo e, in alcuni casi, aggiungere un commento per modificarlo, se necessario.
Implementation Plan: viene utilizzato per progettare le modifiche all'interno del codebase per svolgere un'attività. Questi piani contengono dettagli tecnici sulle revisioni necessarie e devono essere esaminati dall'utente, a meno che i criteri di revisione degli artefatti non siano impostati su "Procedi sempre".
Walkthrough: viene creato una volta che l'agente ha completato l'implementazione dell'attività, come riepilogo delle modifiche e di come testarle.
Code diffs: anche se tecnicamente non è un artefatto, Antigravity produce anche differenze di codice che puoi esaminare e commentare.
Screenshots: l'agente acquisisce lo stato della UI prima e dopo una modifica.
Browser Recordings: per le interazioni dinamiche (ad es. "Fai clic sul pulsante di accesso, attendi il caricamento della rotellina, verifica che la dashboard venga caricata"), l'agente registra un video della sessione. Lo sviluppatore può guardare questo video per verificare che il requisito funzionale sia soddisfatto senza eseguire l'app.

Gli artefatti vengono prodotti e visualizzati nelle visualizzazioni Editor e Gestione agenti.

Nella visualizzazione Editor, nell'angolo in basso a destra, puoi fare clic su Artifacts:

Nella visualizzazione Gestione agenti, in alto a destra, accanto a Review changes, dovresti vedere un pulsante per attivare/disattivare gli artefatti. Se l'opzione è attiva, puoi visualizzare l'elenco degli artefatti generati:

Dovresti visualizzare la visualizzazione Artefatti come mostrato di seguito. Nel nostro caso, abbiamo chiesto all'agente di visitare la pagina antigravity.google e quindi ha acquisito lo screenshot e creato un video della stessa:

Puoi visualizzare le differenze di codice in Review Changes nella visualizzazione Editor:

Gli sviluppatori possono interagire con questi artefatti e differenze di codice utilizzando "commenti in stile Documenti Google". Puoi selezionare un'azione o un'attività specifica, fornire un comando nel modo in cui vuoi che venga eseguito e poi inviarlo all'agente. L'agente inserirà questo feedback e lo utilizzerà per migliorare il proprio lavoro. Prendi in considerazione l'utilizzo di Documenti Google interattivi, in cui fornisci un feedback all'autore e l'autore lo rielabora.

6. Editor

L'editor mantiene la familiarità di VS Code, garantendo il rispetto della memoria muscolare degli sviluppatori esperti. Include l'esplora file standard, l'evidenziazione della sintassi e l'ecosistema delle estensioni.

Puoi fare clic sul pulsante Open Editor in alto a destra in Agent Manager per andare all'editor.

Configurazione ed estensioni

In una configurazione tipica, sono visibili l'editor, il terminale e l'agente:

In caso contrario, puoi attivare/disattivare i riquadri del terminale e dell'agente nel seguente modo:

Per attivare/disattivare il riquadro del terminale, utilizza la scorciatoia Ctrl + `.
Per attivare/disattivare il riquadro dell'agente, utilizza la scorciatoia Cmd + L.

Inoltre, Antigravity può installare alcune estensioni durante la configurazione, ma a seconda del linguaggio di programmazione che utilizzi, probabilmente devi installare altre estensioni. Ad esempio, per lo sviluppo in Python, queste sono le estensioni che potresti scegliere di installare:

Editor

Completamento automatico

Mentre digiti il codice nell'editor, si attiva un completamento automatico intelligente che puoi accettare premendo il tasto Tab:

Scheda da importare

Viene visualizzato il suggerimento Scheda da importare per aggiungere le dipendenze mancanti:

Premi Tab per saltare

Ricevi suggerimenti per passare da una scheda all'altra per spostare il cursore nel punto logico successivo del codice:

Comandi

Puoi attivare i comandi con Cmd + I nell'editor o nel terminale per i completamenti in linea utilizzando il linguaggio naturale.

Nell'editor, puoi chiedere un metodo per calcolare i numeri di Fibonacci e poi accettarlo o rifiutarlo:

Nel terminale, puoi ricevere suggerimenti per i comandi del terminale:

Riquadro laterale dell'agente

Nell'editor, puoi attivare/disattivare il riquadro laterale dell'agente in diversi modi.

Apertura manuale

Puoi attivare/disattivare manualmente il pannello dell'agente a destra con la scorciatoia Cmd + L.

Puoi iniziare a fare domande, utilizzare @ per includere più contesto, ad esempio file, directory, server MCP o utilizzare / per fare riferimento a un workflow (un prompt salvato):

Puoi anche scegliere tra due modalità di conversazione: Fast o Planning :

Fast è consigliato per le attività rapide, mentre Planning è consigliato per le attività più complesse in cui l'agente crea un piano che puoi approvare.

Puoi anche scegliere modelli diversi per la conversazione:

Spiega e correggi

Un altro modo per attivare l'agente è passare il mouse sopra un problema e selezionare Explain and fix:

Invia problemi all'agente

Puoi anche andare alla sezione Problems e selezionare Send all to Agent per chiedere all'agente di provare a risolvere questi problemi:

Inviare l'output del terminale all'agente

Puoi anche selezionare una parte dell'output del terminale e inviarla all'agente con Cmd + L:

Passare da Editor ad Agent Manager

In qualsiasi momento, puoi passare dalla modalità editor alla modalità completa di gestione degli agenti tramite il pulsante Open Agent Manager in alto a destra quando ti trovi in modalità editor e viceversa facendo clic sul pulsante Open Editor in alto a destra quando ti trovi in modalità di gestione degli agenti.

In alternativa, puoi utilizzare la scorciatoia da tastiera Cmd + E per passare da una modalità all'altra.

7. Invia commenti

Il cuore di Antigravity è la sua capacità di raccogliere facilmente il tuo feedback in ogni fase dell'esperienza. Mentre l'agente lavora a un'attività, crea diversi artefatti:

Un piano di implementazione e un elenco di attività (prima della codifica)
Differenze di codice (man mano che genera il codice)
Una procedura dettagliata per verificare i risultati (dopo la codifica)

Questi artefatti sono un modo per Antigravity di comunicare i suoi piani e i suoi progressi. Ancora più importante, sono anche un modo per fornire feedback all'agente nello stile dei commenti di Documenti Google. Ciò è molto utile per indirizzare l'agente nella direzione che preferisci.

Proviamo a creare una semplice applicazione di elenco di cose da fare e vediamo come possiamo fornire feedback ad Antigravity durante il percorso.

Modalità di pianificazione

Innanzitutto, devi assicurarti che Antigravity sia in modalità Planning (anziché Fast).Puoi selezionarla nella chat del riquadro laterale dell'agente. In questo modo, Antigravity crea un piano di implementazione e un elenco di attività prima di passare al codice. Poi, prova un prompt, ad esempio: Create a todo list web app using Python. In questo modo, l'agente inizierà a pianificare e produrre un piano di implementazione.

Piano di implementazione

Un piano di implementazione è una panoramica di ciò che Antigravity intende fare, dello stack tecnologico che utilizzerà e una descrizione di alto livello delle modifiche proposte.

Implementation Plan - Python Todo App
Goal
Create a simple, functional, and aesthetically pleasing Todo List web application using Python (Flask).

Tech Stack
Backend: Python with Flask
Frontend: HTML5, CSS3 (Vanilla), Jinja2 templates
...

È anche il primo posto in cui puoi fornire un feedback. Nel nostro caso, l'agente vuole utilizzare Flask come framework web Python. Possiamo aggiungere un commento al piano di implementazione per utilizzare FastAPI. Dopo aver aggiunto il commento, invialo o chiedi ad Antigravity di Proceed con il piano di implementazione aggiornato.

Elenco di attività

Dopo l'aggiornamento del piano di implementazione, Antigravity crea un elenco di attività. Questo è un elenco concreto di passaggi che Antigravity seguirà per creare e verificare l'app.

Task Plan
 Create requirements.txt
 Create directory structure (static/css, templates)
 Create static/css/style.css
 Create templates/index.html
 Create main.py with FastAPI setup and Database logic
 Verify application

Questo è il secondo punto in cui puoi fornire un feedback.

Ad esempio, nel nostro caso d'uso, puoi aggiungere istruzioni di verifica più dettagliate aggiungendo il seguente commento: Verify application by adding, editing, and deleting a todo item and taking a screenshot.

Modifiche al codice

A questo punto, Antigravity genererà del codice in nuovi file. Puoi Accept all o Reject all queste modifiche nel riquadro laterale della chat dell'agente senza esaminare i dettagli.

Puoi anche fare clic su Review changes per visualizzare i dettagli delle modifiche e aggiungere commenti dettagliati al codice. Ad esempio, possiamo aggiungere il seguente commento in main.py: Add basic comments to all methods

È un ottimo modo per eseguire l'iterazione del codice con Antigravity.

Procedura dettagliata

Una volta terminata la codifica, Antigravity avvia il server e apre un browser per verificare l'app. Esegue alcuni test manuali, come l'aggiunta e l'aggiornamento delle attività, il tutto grazie all'estensione del browser Antigravity. Alla fine, crea un file di procedura dettagliata per riepilogare le operazioni eseguite per verificare l'app. Questo include uno screenshot o un flusso di verifica con una registrazione del browser.

Puoi anche commentare lo screenshot o la registrazione del browser nella procedura dettagliata. Ad esempio, possiamo aggiungere un commento Change the blue theme to orange theme e inviarlo. Dopo l'invio del commento, Antigravity apporta le modifiche, verifica i risultati e aggiorna la procedura dettagliata.

Annulla modifiche

Infine, dopo ogni passaggio, se non sei soddisfatto della modifica, puoi annullarla dalla chat. Basta scegliere ↩️ Undo changes up to this point nella chat.

8. Regole e workflow

Antigravity offre alcune opzioni di personalizzazione: Regole e Flussi di lavoro.

In modalità Editor, fai clic su ... nell'angolo in alto a destra e scegli Customizations. Vedrai Rules e Workflows:

Le regole aiutano a guidare il comportamento dell'agente. Queste sono linee guida che puoi fornire per assicurarti che l'agente le segua durante la generazione di codice e test. Ad esempio, potresti volere che l'agente segua un determinato stile di codice o che documenti sempre i metodi. Puoi aggiungerle come regole e l'agente le prenderà in considerazione.

I workflow sono prompt salvati che puoi attivare on demand con / mentre interagisci con l'agente. Guidano anche il comportamento dell'agente, ma vengono attivate dall'utente su richiesta.

Un buon paragone è che le Regole sono più simili alle istruzioni di sistema, mentre i workflow sono più simili a prompt salvati che puoi scegliere su richiesta.

Sia le regole che i flussi di lavoro possono essere applicati a livello globale o per spazio di lavoro e salvati nelle seguenti posizioni:

Regola globale: ~/.gemini/GEMINI.md
Flusso di lavoro globale: ~/.gemini/antigravity/global_workflows/<YOUR_WORKFLOW_NAME>.md
Regole dello spazio di lavoro: your-workspace/.agents/rules/
Workspace Workflows: your-workspace/.agents/workflows/

Aggiungiamo alcune regole e flussi di lavoro nell'area di lavoro.

Aggiungi una regola

Innanzitutto, aggiungiamo una regola di stile del codice. Vai a Rules e seleziona il pulsante +Workspace. Assegna un nome, ad esempio code-style-guide, con le seguenti regole di stile del codice:

* Make sure all the code is styled with PEP 8 style guide
* Make sure all the code is properly commented

In secondo luogo, aggiungiamo un'altra regola per assicurarci che il codice venga generato in modo modulare con esempi in una regola code-generation-guide:

* The main method in main.py is the entry point to showcase functionality.
* Do not generate code in the main method. Instead generate distinct functionality in a new file (eg. feature_x.py)
* Then, generate example code to show the new functionality in a new method in main.py (eg. example_feature_x) and simply call that method from the main method.

Le due regole vengono salvate e sono pronte:

Aggiungere un workflow

Definiamo anche un workflow per generare test delle unità. In questo modo, potremo attivare i test delle unità una volta che il codice sarà pronto (anziché farli generare continuamente dall'agente).

Vai a Workflows e seleziona il pulsante +Workspace. Assegna un nome, ad esempio generate-unit-tests, con quanto segue:

* Generate unit tests for each file and each method
* Make sure the unit tests are named similar to files but with test_ prefix

Anche il workflow è pronto:

Prova

Vediamo ora le regole e i flussi di lavoro in azione. Crea un file main.py scheletro nel tuo spazio di lavoro:

def main():
    pass

if __name__ == "__main__":
    main()

Ora vai alla finestra della chat con l'agente e chiedi: Implement binary search and bubble sort.

Dopo un minuto o due, dovresti ricevere tre file nello spazio di lavoro: main.py, bubble_sort.py, binary_search.py. Noterai anche che tutte le regole sono implementate: il file principale non è ingombrante e contiene il codice di esempio, ogni funzionalità è implementata nel proprio file, tutto il codice è documentato e in buono stile:

from binary_search import binary_search, binary_search_recursive
from bubble_sort import bubble_sort, bubble_sort_descending


def example_binary_search():
    """
    Demonstrate binary search algorithm with various test cases.
    """
    ...

def example_bubble_sort():
    """
    Demonstrate bubble sort algorithm with various test cases.
    """
    ...

def main():
    """
    Main entry point to showcase functionality.
    """
    example_binary_search()
    example_bubble_sort()
    print("\n" + "=" * 60)


if __name__ == "__main__":
    main()

Ora che siamo soddisfatti del codice, vediamo se possiamo attivare il workflow per la generazione di test delle unità.

Vai alla chat e inizia a digitare /generate. Antigravity conosce già il nostro workflow:

Seleziona generate-unit-tests e inserisci. Dopo alcuni secondi, nel tuo spazio di lavoro verranno visualizzati nuovi file: test_binary_search.py, test_bubble_sort.py con una serie di test già implementati.

Bene!

9. Competenze

Sebbene i modelli sottostanti di Antigravity (come Gemini) siano generalisti potenti, non conoscono il contesto specifico del tuo progetto o gli standard del tuo team . Il caricamento di ogni singola regola o strumento nella finestra contestuale dell'agente comporta un "eccesso di strumenti", costi più elevati, latenza e confusione.

Le competenze Antigravity risolvono questo problema tramite la divulgazione progressiva. Una competenza è un pacchetto specializzato di conoscenze che rimane inattivo finché non è necessario. Viene caricato nel contesto dell'agente solo quando la tua richiesta specifica corrisponde alla descrizione della skill .

Struttura e ambito

Le skill sono pacchetti basati su directory. Puoi definirli in due ambiti a seconda delle tue esigenze:

Ambito globale (~/.gemini/antigravity/skills/): disponibile in tutti i tuoi progetti (ad es. "Formatta JSON", "Revisione generale del codice").
Ambito dello spazio di lavoro (<workspace-root>/.agents/skills/): disponibile solo all'interno di un progetto specifico (ad es. "Esegui il deployment in questo staging dell'app", "Genera boilerplate per questo framework specifico").

Anatomia di una competenza

Un tipico elenco di competenze ha questo aspetto :

my-skill/
├── SKILL.md    #(Required) metadata & instructions.
├── scripts/    # (Optional) Python or Bash scripts for execution.
├── references/ # (Optional) text, documentation, or templates.
└── assets/     # (Optional) Images or logos.

Ora aggiungiamo alcune competenze.

Competenza di revisione del codice

Si tratta di un'abilità solo con istruzioni, ovvero dobbiamo creare solo il file SKILL.md, che conterrà i metadati e le istruzioni dell'abilità. Creiamo una skill globale che fornisca all'agente i dettagli per esaminare le modifiche al codice alla ricerca di bug, problemi di stile e best practice.

Innanzitutto, crea la directory che conterrà questa skill globale.

mkdir -p ~/.gemini/antigravity/skills/code-review

Crea un file SKILL.md nella directory precedente con il contenuto mostrato di seguito:

---
name: code-review
description: Reviews code changes for bugs, style issues, and best practices. Use when reviewing PRs or checking code quality.
---

# Code Review Skill

When reviewing code, follow these steps:

## Review checklist

1. **Correctness**: Does the code do what it's supposed to?
2. **Edge cases**: Are error conditions handled?
3. **Style**: Does it follow project conventions?
4. **Performance**: Are there obvious inefficiencies?

## How to provide feedback

- Be specific about what needs to change
- Explain why, not just what
- Suggest alternatives when possible

Tieni presente che il file SKILL.md riportato sopra contiene i metadati (nome e descrizione) nella parte superiore e poi le istruzioni. Quando viene caricato, l'agente legge solo i metadati delle skill che hai configurato e carica le istruzioni per la skill solo se necessario.

Prova

Crea un file denominato demo_bad_code.py con i contenuti mostrati di seguito:

import time

def get_user_data(users, id):
   # Find user by ID
   for u in users:
       if u['id'] == id:
            return u
   return None

def process_payments(items):
   total = 0
   for i in items:
       # Calculate tax
       tax = i['price'] * 0.1
       total = total + i['price'] + tax
       time.sleep(0.1) # Simulate slow network call
  
   return total

def run_batch():
   users = [{'id': 1, 'name': 'Alice'}, {'id': 2, 'name': 'Bob'}]
   items = [{'price': 10}, {'price': 20}, {'price': 100}]
  
   u = get_user_data(users, 3)
   print("User found: " + u['name']) # Will crash if None
  
   print("Total: " + str(process_payments(items)))

if __name__ == "__main__":
   run_batch()

Chiedi all'agente: review the @demo_bad_code.py file. L'agente deve identificare l'abilità code-review, caricare i dettagli ed eseguire l'azione in base alle istruzioni fornite nel file code-review/SKILL.md.

Di seguito è riportato un output di esempio:

La competenza Modello di intestazione del codice

A volte una skill deve utilizzare un blocco di testo statico di grandi dimensioni (ad esempio un'intestazione di licenza). Inserire questo testo direttamente nel prompt è uno spreco. Invece, lo inseriamo in una cartella resources/ e chiediamo all'agente di leggerlo solo quando necessario .

Per prima cosa, crea la directory che conterrà questa skill per lo spazio di lavoro.

mkdir -p .agents/skills/license-header-adder/resources

Crea .agents/skills/license-header-adder/resources/HEADER.txt con il testo della licenza:

/*
 * Copyright (c) 2026 YOUR_COMPANY_NAME LLC.
 * All rights reserved.
 * This code is proprietary and confidential.
 */

Crea un file .agents/skills/license-header-adder/SKILL.md con i contenuti mostrati di seguito:

---
name: license-header-adder
description: Adds the standard corporate license header to new source files.
---

# License Header Adder

This skill ensures that all new source files have the correct copyright header.

## Instructions
1. **Read the Template**: Read the content of `resources/HEADER.txt`.
2. **Apply to File**: When creating a new file, prepend this exact content.
3. **Adapt Syntax**: 
   - For C-style languages (Java, TS), keep the `/* */` block.
   - For Python/Shell, convert to `#` comments.

Prova

Chiedi all'agente quanto segue: Create a new Python script named data_processor.py that prints 'Hello World'.

L'agente leggerà il modello, convertirà i commenti in stile C in stile Python e li anteporrà automaticamente al nuovo file.

Creando queste competenze, hai trasformato il modello Gemini generalista in uno specialista per il tuo progetto. Hai codificato le tue best practice, ad esempio seguendo le linee guida per la revisione del codice o le intestazioni delle licenze. Invece di chiedere ripetutamente all'AI di "ricordarsi di aggiungere la licenza" o di "correggere il formato del commit", l'agente ora sa istintivamente come lavorare nel tuo team.

10. Fissare l'agente

Concedere a un agente AI l'accesso al terminale e al browser è un'arma a doppio taglio. Consente il debug e il deployment autonomi, ma apre anche vettori per l'iniezione di prompt e l'esfiltrazione di dati.

Antigravity risolve questo problema tramite un sistema di autorizzazioni granulare basato su policy di esecuzione automatica dei comandi del terminale, elenchi consentiti ed elenchi bloccati.

Quando configuri Antigravity per la prima volta o tramite il menu delle impostazioni, devi selezionare un criterio Terminal Command Auto Execution. Questa impostazione determina l'autonomia dell'agente in merito ai comandi della shell. Per visualizzare le impostazioni attuali, vai alla pagina Antigravity — Settings. Dovresti visualizzare la sezione Terminal e le norme Terminal Command Auto Execution con le seguenti opzioni:

Modalità Norme	Descrizione
Richiedi una revisione	L'agente chiede sempre la conferma prima di eseguire i comandi del terminale (ad eccezione di quelli inclusi nella lista consentita)
Procedi sempre	L'agente non chiede mai la conferma prima di eseguire i comandi del terminale (ad eccezione di quelli nell'elenco Negati). In questo modo, l'agente può operare per lunghi periodi senza intervento, ma presenta anche il rischio più elevato di esecuzione di un comando del terminale non sicuro.

Configurare la lista consentita

L'elenco consentito viene utilizzato principalmente con il criterio Richiedi revisione. Rappresenta un modello di sicurezza positivo, il che significa che tutto è vietato a meno che non sia espressamente consentito. Questa è la configurazione più sicura.

Configurazione passo passo

Imposta l'impostazione Esecuzione automatica del comando terminale su Richiedi revisione.
Aggiungi il seguente comando in Comandi del terminale consentiti facendo clic sul pulsante Aggiungi accanto : ls -al . Se vuoi, puoi aggiungere anche altri comandi del terminale.

Test della lista consentita

Chiedi all'agente: List the files in this directory.
L'agente viene eseguito automaticamente ls.
Chiedi all'agente: Delete the <some file>
L'agente tenterà di eseguire rm <filepath>, ma Antigravity lo bloccherà e forzerà una revisione dell'utente perché rm non è nella lista consentita. Prima di eseguire il comando, Antigravity dovrebbe chiederti l'autorizzazione.

Configurazione dell'elenco valori non consentiti

L'elenco di negazione è la salvaguardia per il criterio Procedi sempre. Rappresenta un modello di sicurezza negativo, il che significa che tutto è consentito, a meno che non sia espressamente vietato. Ciò si basa sulla previsione di ogni possibile pericolo da parte dello sviluppatore, il che è rischioso, ma offre la massima velocità.

Configurazione passo passo

Imposta l'impostazione Esecuzione automatica comandi terminale su Procedi sempre.
Aggiungi i seguenti comandi in Comandi del terminale della lista bloccata facendo clic sul pulsante Aggiungi accanto.
rm
sudo
curl
wget

Test dell'elenco valori non consentiti

Chiedi all'agente: Check the version of python.
L'agente viene eseguito automaticamente python --version.
Chiedi all'agente: Download www.google.com home page.
L'agente tenta di curl. Antigravity rileva curl nella denylist e ne blocca l'esecuzione, richiedendo l'approvazione manuale.

Sicurezza del browser

La capacità di Antigravity di navigare sul web è un superpotere, ma anche una vulnerabilità. Un agente che visita un sito di documentazione compromesso potrebbe imbattersi in un attacco di prompt injection. Per evitare questo problema, puoi implementare una lista consentita di URL del browser per l'agente browser.

Per visualizzare le impostazioni attuali, vai a Antigravity — Settings e poi a Browser. Dovresti visualizzare la sezione Browser URL Allowlist in cui puoi aggiungere altri URL:

11. Conclusioni e passaggi successivi

Complimenti! Ora hai installato correttamente Antigravity, configurato l'ambiente e imparato a controllare gli agenti.

Passaggi successivi Per vedere Antigravity in azione nella creazione di applicazioni reali, puoi consultare i seguenti codelab:

Building with Google Antigravity: questo codelab mostra come creare diverse applicazioni, tra cui un sito web dinamico per conferenze e un'app di produttività.
Crea ed esegui il deployment su Google Cloud con Antigravity: questo codelab mostra come progettare, creare ed eseguire il deployment di un'applicazione serverless su Google Cloud.

Documentazione di riferimento

Sito ufficiale : https://antigravity.google/
Documentazione: https://antigravity.google/docs
Casi d'uso : https://antigravity.google/use-cases
Download : https://antigravity.google/download
Canale YouTube di Google Antigravity : https://www.youtube.com/@googleantigravity