Guida introduttiva a Google Antigravity

1. Introduzione

In questo codelab imparerai a conoscere Google Antigravity, una piattaforma di sviluppo agentica progettata per aiutarti a sviluppare in questa era di agenti. Antigravity 2.0 funge da centro di comando centrale degli agenti AI, fornendo una piattaforma unificata per avviare, monitorare e orchestrare le loro attività.

Con il lancio della versione 2.0, Antigravity non è più solo un Agent Manager integrato con un IDE. Ora è un ecosistema completo di prodotti progettati per l'era degli agenti:

• Antigravity: l'applicazione autonoma di punta per macOS, Linux e Windows. Questo è il tuo centro di comando per gestire più agenti locali in parallelo, eseguire attività pianificate e altro ancora. A differenza della versione precedente, Agent Manager, Antigravity 2.0 è un'applicazione autonoma che funziona indipendentemente da un IDE.
• Antigravity IDE: l'IDE agentico originale e completo di funzionalità rimane disponibile (ed è consigliato agli sviluppatori). È dotato di un gestore degli agenti, artefatti e una profonda comprensione del tuo codebase.
• Antigravity CLI: un'interfaccia a riga di comando per le interazioni degli agenti basate sul terminale. Questo argomento non verrà trattato in questo tutorial.
• Antigravity SDK: strumenti per gli sviluppatori per integrare Antigravity nei propri sistemi in modo programmatico. Questo argomento non verrà trattato in questo tutorial.

In questo codelab ci concentreremo molto su Antigravity e accenneremo brevemente all'Antigravity IDE. Gli altri due componenti, Antigravity CLI e Antigravity SDK, non sono coperti.

Se ti interessa un codelab su Antigravity CLI, un'applicazione basata su terminale, consulta il codelab: Getting Started with Antigravity CLI.

Cosa imparerai a fare

• Installazione e configurazione di Antigravity.
• Esplorare i concetti chiave di Antigravity, come lavorare con gli agenti, gli spazi di lavoro e altro ancora.
• Personalizzare Antigravity tramite varie impostazioni e in base alle tue preferenze.

Che cosa ti serve

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 quanto segue:

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

Questo codelab è pensato per utenti e sviluppatori di tutti i livelli.

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. Per segnalare un feedback sul prodotto, fai clic su Impostazioni, disponibile nell'angolo in basso a sinistra del prodotto Antigravity. e poi scegliendo l'opzione Provide Feedback.

2. Installazione

Installazione di Antigravity

Vai alla pagina di download di Google Antigravity. Scarica l'applicazione Antigravity per il tuo sistema operativo (macOS, Linux o Windows).

Esegui il programma di installazione. Viene visualizzata la seguente schermata:

Accedi con il tuo Account Google. Completa l'autenticazione e dovresti visualizzare quanto segue:

Fai clic su Apri Antigravity. Verranno visualizzate le norme relative alla sicurezza e all'utilizzo dei dati. Fai clic su Avanti.

Seleziona un tema che ti piace:

Antigravity include un insieme di plug-in che funzionano con vari strumenti per sviluppatori di Google. Questi plug-in installano un insieme di competenze che aiutano Antigravity a funzionare con vari strumenti per sviluppatori di Google. Di seguito è riportato un elenco di plug-in che puoi scegliere di installare. Non tratteremo questi plug-in nel codelab. Fai clic su Fine.

Dovresti vedere l'interfaccia di Antigravity come segue:

Installa Antigravity IDE

Se vuoi, puoi scegliere di installare l'IDE Antigravity. Vai alla pagina di download di Google Antigravity. Vai alla sezione Download dell'IDE Antigravity.

Una volta installati correttamente sia Antigravity che Antigravity IDE, vedrai due icone nel dock: Antigravity (sfondo bianco) e Antigravity IDE (sfondo nero a griglia).

3. Interfaccia Antigravity

Siamo pronti per iniziare. Concentriamoci innanzitutto sull'utilizzo di Antigravity. La schermata iniziale di Antigravity è simile a questa:

Nel corso di questo tutorial, vedremo l'opzione Impostazioni nell'angolo in basso a sinistra, in base alle nostre esigenze.

Progetti

Vediamo prima il concetto di Progetti in Antigravity. Questo è fondamentale perché se noti l'interfaccia nel riquadro di destra, è chiaramente indicato Seleziona progetto e Antigravity utilizza un approccio incentrato sul progetto per garantire che gli agenti abbiano accesso ai file, agli strumenti, alle autorizzazioni e altro ancora giusti.

Un progetto è una combinazione di cartelle che definiscono l'ambiente e l'ambito del tuo agente. Invece di costringere un agente a operare all'interno di una singola cartella, un progetto può funzionare con una o più cartelle (ad es. un repository frontend e uno backend), fornendo agli agenti tutto il contesto necessario per la tua base di codice. Tutti i progetti hanno impostazioni dell'agente isolate, il che ti consente di personalizzare le impostazioni di sicurezza di diversi progetti in modo indipendente.

Creiamo il nostro primo progetto. Nella tua cartella Home sulla macchina locale, crea una cartella denominata $HOME/agy2-projects/my-first-project . Tieni presente che non deve essere una cartella vuota.

Ora creeremo il nostro primo progetto in Antigravity definendo le cartelle che lo compongono. Nel nostro caso iniziale, sarà una cartella.

Fai clic su Seleziona progetto → Nuovo progetto come mostrato di seguito:

Come previsto, ti chiede di Selezionare cartelle, come mostrato di seguito:

Fai clic su Aggiungi cartella e seleziona la cartella specifica, ad esempio $HOME/agy2-projects/my-first-project.

Puoi comunque aggiungere altre cartelle al progetto, come puoi notare (tramite Aggiungi cartella), ma per ora possiamo fare clic sul pulsante Avanti.

Viene visualizzata una finestra di dialogo come mostrato di seguito. Tutti i progetti hanno impostazioni dell'agente isolate, il che ti consente di personalizzare in modo indipendente le diverse impostazioni di sicurezza del progetto.

Ogni progetto eredita le autorizzazioni relative alla revisione degli artefatti, agli strumenti consentiti e alla configurazione del server Model Context Protocol (MCP) da una configurazione globale disponibile tramite Impostazioni nell'interfaccia principale. Tuttavia, puoi impostare individualmente queste autorizzazioni e altre per progetto, ottenendo così molta più flessibilità e mantenendo il contesto e gli strumenti snelli ed efficaci per il tuo progetto specifico.

Per ora, scegli l'opzione Predefinito.

Puoi anche assegnare un nome al progetto nella finestra di dialogo successiva e fare clic su Crea:

Ora vedrai la seguente schermata. Il progetto viene visualizzato nell'elenco dei progetti e anche nell'interfaccia della chat, come mostrato. Tieni presente che puoi selezionare il modello, passare un contesto aggiuntivo tramite i simboli + o @ o le azioni /, e altro ancora.

Dopo aver salutato l'agente con un messaggio, quest'ultimo risponde di conseguenza.

Abbiamo un'altra richiesta per ricevere le notizie e funziona bene.

Conversazioni

Nel nostro progetto (my-first-project), abbiamo avviato un thread di conversazione e attualmente nel thread è presente una serie di messaggi (messaggio dell'utente e risposte dell'agente).

Vedrai questo thread di conversazione sul lato sinistro raggruppato nel progetto.

Ora facciamo qualcosa di interessante e diamo un nome a questo thread di conversazione. Chiamiamola conv-introduction.

Per farlo, fai clic sui tre puntini verticali accanto alla conversazione. Verranno visualizzate tre opzioni. Scegli l'azione Rinomina.

Assegna il valore conv-introduction o qualsiasi nome che ti sembri opportuno.

Ora, se vuoi avviare una conversazione completamente nuova nel progetto, fai clic sul segno + (Nuova conversazione nel progetto) accanto al progetto, come mostrato di seguito.

Ora ti trovi in una conversazione completamente nuova.

Chiediamo alcune notizie sportive da tutto il mondo. Tieni presente che ci troviamo ancora in my-first-project.

In questo modo ricevo notizie dal mondo dello sport e puoi notare che ora abbiamo due thread di conversazione nello stesso progetto.

Rinominiamo questa conversazione in conv-sportsnews. Se vuoi visualizzare tutte le conversazioni avvenute finora, puoi visitare la cronologia delle conversazioni in alto a sinistra, come mostrato di seguito:

In qualsiasi momento, puoi avviare una nuova conversazione nel progetto corrente o in un nuovo progetto tramite l'opzione Nuova conversazione nella parte superiore.

Impostazioni progetto

Torniamo ora alle impostazioni del progetto di cui abbiamo parlato in precedenza. Quando crei un progetto in Antigravity, questo eredita le autorizzazioni predefinite, che puoi sostituire in modo specifico, se vuoi.

Per accedere alle impostazioni progetto per un progetto specifico, fai clic sull'icona a forma di ingranaggio delle impostazioni accanto a ogni progetto nella barra di navigazione a sinistra.

Verranno visualizzate le impostazioni del progetto specifico (ad es. my-first-project), come mostrato di seguito:

Nota che a sinistra, nella sezione dei progetti, è selezionato my-first-project. Se ci fossero altri progetti, questi sarebbero visibili sotto questo elenco e potresti selezionarne facilmente uno e modificarne le impostazioni in base alle tue esigenze.

Ora concentriamoci sul lato destro, sulle impostazioni progetto mostrate per my-first-project. Noterai che contiene la singola cartella che abbiamo aggiunto a questo progetto. Da qui puoi aggiungere anche altre cartelle.

Ti suggerisco di esaminare prima l'intero elenco e di verificare la flessibilità ora fornita per aiutarti a modificare una serie di impostazioni in base ai requisiti di personalizzazione del progetto.

tra cui:

• Preset di sicurezza: determina se tutti i comandi del terminale e gli accessi ai file devono essere esaminati prima che l'agente possa eseguire azioni.
• Comportamento dell'agente: determina se l'agente esegue il piano di implementazione con o senza la tua revisione.
• Varie autorizzazioni locali Percorsi di file, URL e così via consentiti o bloccati per l'agente.
• Puoi anche configurare quali strumenti MCP specifici sono consentiti per questo progetto. Ciò è molto utile per impedire che tutti i server MCP configurati a livello globale vengano resi disponibili all'agente in questo progetto.

Nota: in qualsiasi momento, puoi accedere alle impostazioni di Antigravity o anche alle impostazioni dei progetti tramite l'opzione delle impostazioni principali nell'interfaccia di Antigravity.

4. Comandi slash

In Antigravity sono disponibili alcuni comandi slash / interessanti. Nell'interfaccia di chat della conversazione, se digiti / , dovresti visualizzare i comandi come mostrato di seguito:

Prendi in considerazione il comando /browser. È un comando esplicito per avviare il browser e chiedergli di fare qualcosa. Per avviare una sessione di debug, sono necessari Google Chrome e l'autorizzazione in Google Chrome.

Viene generato un sub-agente del browser che tenta di avviare una sessione di debug con Chrome e chiede prima la tua autorizzazione:

Una volta consentito, chiede le autorizzazioni necessarie e ottiene i dettagli.

Il comando /schedule è utile se vuoi configurare attività ricorrenti o una tantum da eseguire a intervalli fissi o in base a una pianificazione (ad es. alle 9:00 di lunedì e mercoledì).

Allo stesso tempo, ti viene fornita la stessa funzionalità per farlo tramite l'interfaccia utente, descritta nella sezione Comandi di pianificazione del passaggio successivo.

5. Comandi di pianificazione

Puoi utilizzare l'opzione Pianifica nell'interfaccia principale per automatizzare le attività ricorrenti o impostare promemoria singoli nei tuoi progetti specifici.

Creiamo un'attività giornaliera che ci ricordi la riunione quotidiana delle 18:00. Fai clic su Nuovo e compila i dettagli come mostrato di seguito:

Fai clic su Aggiungi attività pianificata e l'attività verrà aggiunta all'elenco delle attività pianificate, come mostrato di seguito:

Aggiungiamone un altro che ci ricordi di fare una pausa ogni 20 minuti:

Ora abbiamo due attività pianificate, come mostrato di seguito:

Puoi disattivare o eliminare una qualsiasi delle attività. Ricorda che abbiamo utilizzato prompt di base, ma i tuoi prompt potrebbero essere dettagliati, potrebbero richiamare strumenti (comunicare con sistemi esterni) e svolgere molto più lavoro dietro le quinte a intervalli regolari, in base ai tuoi requisiti.

6. Server Model Context Protocol (MCP)

Il Model Context Protocol (MCP) è diventato lo standard per connettere gli agenti a sistemi esterni. Svolgono un ruolo chiave nel garantire che l'agente rimanga basato sui tuoi dati e sulla tua integrazione.

Antigravity supporta i server MCP, sia locali che remoti. Viene inoltre fornito con integrazioni a diversi server MCP che funzionano con i servizi Google Cloud e sono installazioni con un solo clic con pochi dati di configurazione.

Innanzitutto, vediamo l'elenco delle opzioni del server MCP preconfigurate. Vai a Impostazioni → Personalizzazioni e poi fai clic sul pulsante Aggiungi MCP+ per aggiungere un nuovo server. Viene visualizzata una finestra di dialogo in cui puoi vedere l'elenco completo dei server:

Fai clic sul pulsante +Aggiungi per aggiungere un server MCP. A seconda del server MCP, dovrai fornire alcune informazioni, come l'ID progetto e i dettagli del database.

Aggiungere server MCP esistenti

Dietro le quinte, i server MCP sono configurati nel file $HOME/.gemini/config/mcp_config.json. Se hai lavorato con server MCP remoti esistenti, puoi semplicemente aggiungere i dettagli a questo file. Consulta la sezione sulla configurazione dei server MCP personalizzati qui.

Dopo aver aggiunto i server MCP remoti e salvato il file, puoi andare alla sezione dei server MCP in Antigravity nel seguente modo:

1. Nell'interfaccia principale di Antigravity, fai clic su Settings (Impostazioni).
2. Vai a Personalizzazioni. Fai clic su Aggiorna se ancora non vedi i server MCP.

3. Puoi disattivare uno qualsiasi dei server MCP tramite il pulsante Attiva/Disattiva. In alternativa, puoi fare clic su uno qualsiasi dei server MCP e visualizzare gli strumenti esposti dal server.

Per utilizzare i server MCP configurati, puoi chiedere ad Antigravity qualcosa che richiede un server MCP. Ad esempio, puoi attivare il server cloudrun-mcp e chiedere ad Antigravity: Build and deploy a Cloud Run service. In questo modo, Antigravity dovrebbe cercare e utilizzare il server cloudrun-mcp per configurare ed eseguire il deployment di un servizio Cloud Run.

7. Artefatti

Antigravity crea artefatti mentre pianifica e svolge 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 di aver corretto un bug, lo sviluppatore doveva leggere il codice per verificarlo. 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 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 le norme relative alle recensioni degli artefatti non siano impostate su Procedi sempre.
• Walkthrough: viene creato una volta completata l'implementazione dell'attività dell'agente, 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.

Per comprendere meglio gli artefatti, crea una conversazione con un progetto nuovo o esistente con il seguente prompt:

Write a node application that I can run from the command line to get me the latest news from Google.

L'agente decolla e torna con il nostro primo artefatto: il piano di implementazione.

Puoi esaminare uno qualsiasi degli artefatti prodotti da Antigravity attivando/disattivando il riquadro ausiliario mostrato nell'angolo in alto a destra.

Se attivi/disattivi il riquadro ausiliario, viene visualizzato il seguente output, che indica che è stato generato un artefatto (piano di implementazione).

Fai clic sul piano di implementazione per visualizzare i dettagli, come mostrato di seguito:

Per ora, il piano va bene, quindi fai clic sul pulsante Procedi per andare avanti.

Ora, mentre lavora, crea un altro artefatto, il piano delle attività,e altri file. Puoi visualizzare tutto nel riquadro ausiliario, come mostrato di seguito:

Se fai clic sull'artefatto Attività, vedrai un elenco di attività passo passo per raggiungere l'obiettivo che hai identificato, insieme ai passaggi completati e a quelli ancora da completare.

Infine, quando tutto è stato completato, testato e verificato dall'agente, riceverai un messaggio che ti comunica che l'attività è stata completata. È ora disponibile un altro artefatto chiamato Procedura dettagliata. Puoi visualizzare l'elenco finale come mostrato di seguito:

Alcune cose da notare: non ci sono solo artefatti (attività, procedura dettagliata e piano di implementazione), ma anche file di origine (package.json , index.js).

Potresti non aver bisogno di un editor / IDE completo per visualizzare i file generati. Puoi fare clic sui file package.json o index.js per visualizzarne il contenuto e commentarlo.

8. Antigravity IDE

Se preferisci un IDE, puoi scegliere di utilizzare l'IDE Antigravity che abbiamo installato in precedenza in questo codelab. Noterai che quando attivi/disattivi il pannello ausiliario nell'interfaccia principale di Antigravity, è presente un'opzione Apri IDE.

Fai clic per aprire l'IDE Antigravity. All'avvio dell'IDE Antigravity, potresti visualizzare un avviso simile al seguente:

È normale. Procedi e fai clic su Sì. Verrà visualizzato l'IDE Antigravity, che dovrebbe essere familiare a chiunque abbia già utilizzato un IDE. Contiene tutte le cartelle/i file generati, un editor e un pannello dell'agente, in cui puoi chattare con l'agente del codice (spiegare, generare, correggere e così via).

9. Skill

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

Le skill risolvono questo problema tramite la divulgazione progressiva. Una competenza è un pacchetto specializzato di conoscenze che rimane inattivo fino a quando 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/config/skills/): disponibile in tutti i prodotti Antigravity (Antigravity, Antigravity IDE, Antigravity CLI) e progetti.
• Ambito progetto/workspace (<project-root>/.agents/skills/): in questo modo, la skill sarà disponibile solo all'interno di un progetto specifico.

Anatomia di una competenza

Una tipica directory delle skill 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.

Aggiungiamo alcune skill.

Competenza di revisione del codice

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

Supponendo che tu ti trovi in una cartella di progetto specifica (ad es. $HOME/agy2-projects/my-skills-project)), il primo passaggio è creare una directory nella cartella di progetto che conterrà la skill.

mkdir -p .agents/skills/code-review

Crea un file SKILL.md nella cartella del progetto, ad esempio .agents/skills/code-review, che abbiamo appena creato, 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 l'agente viene caricato, legge solo i metadati delle skill e carica le istruzioni complete solo quando necessario.

Convalidiamo la competenza Revisione del codice. Apri una conversazione in Antigravity in un progetto specifico a tua scelta e fornisci il seguente prompt.

Dovrebbe mostrare la skill code-review.

Prova

Crea un nuovo file denominato demo_bad_code.py nella directory $HOME/agy2-projects/my-skills-project 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()

Apri una nuova conversazione in un progetto specifico in Antigravity e inserisci il seguente prompt: review the @demo_bad_code.py file.

L'agente deve identificare l'intent 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:

10. Conclusione

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

Ottieni il badge Agenti AI di Kaggle in 5 giorni

Hai completato questo lab nell'ambito del corso intensivo di programmazione 5-Day AI Agents: Intensive Vibe Coding Course with Google di Kaggle? Richiedi il badge di completamento: ottieni il badge Agenti AI di 5 giorni.

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

• 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/home
• Casi d'uso : https://antigravity.google/use-cases
• Download : https://antigravity.google/download
• Canale YouTube di Google Antigravity : https://www.youtube.com/@googleantigravity