Utilizza Antigravity CLI

Questa pagina descrive come utilizzare l'interfaccia a riga di comando (CLI) di Antigravity con un'istanza di Gemini Enterprise Agent Platform Workbench.

Questo documento è rivolto ad analisti di dati, data scientist e sviluppatori di dati che lavorano con Agent Platform Workbench. Questo documento presuppone che tu sappia come scrivere codice in un ambiente notebook.

Panoramica

Antigravity CLI è la superficie terminal-first di Google Antigravity, un agente di programmazione AI che viene eseguito in un terminale. Per saperne di più, visita il sito antigravity.google.

L'interfaccia a riga di comando Antigravity è disponibile in un terminale nell'interfaccia JupyterLab dell'istanza Agent Platform Workbench. Puoi utilizzarlo per lavorare con i notebook e i file della tua istanza e per eseguire comandi della shell e comandi Google Cloud fornendo istruzioni in linguaggio naturale.

Agent Platform Workbench aggiunge quanto segue all'interfaccia a riga di comando Antigravity:

Limitazioni

Tieni presente le seguenti limitazioni quando utilizzi l'interfaccia a riga di comando Antigravity con Agent Platform Workbench:

  • Antigravity CLI è solo un'interfaccia a riga di comando. Non sono incluse un'interfaccia di chat grafica e strumenti avanzati nell'editor.

  • Quando chiedi all'interfaccia a riga di comando Antigravity di modificare un notebook, il file del notebook viene modificato direttamente sul disco dell'istanza. Di conseguenza, non puoi annullare le modifiche apportate dall'interfaccia a riga di comando Antigravity utilizzando il pulsante Annulla dell'editor del notebook o Ctrl+Z (Comando+Z su macOS). Tuttavia, puoi chiedere all'interfaccia a riga di comando di Antigravity di annullare una modifica utilizzando un comando in linguaggio naturale, ad esempio Undo your last change.

  • L'interfaccia a riga di comando Antigravity scrive direttamente sul disco e può modificare i file che hai aperto anche in JupyterLab. Se hai modifiche non salvate in un notebook, salvale prima di chiedere all'interfaccia a riga di comando Antigravity di modificare lo stesso notebook.

  • L'interfaccia a riga di comando Antigravity è bloccata alla versione inclusa nell'immagine dell'istanza e non può aggiornarsi autonomamente. Per utilizzare una versione più recente, esegui l'upgrade dell'istanza a una versione immagine più recente. Per saperne di più, consulta Esegui l'upgrade dell'ambiente di un'istanza.

  • L'interfaccia a riga di comando Antigravity viene eseguita con le credenziali attive sulla tua istanza. Per impostazione predefinita, si tratta delle credenziali del account di servizio dell'istanza di Agent Platform Workbench, in modo che l'interfaccia a riga di comando Antigravity possa accedere alle stesse risorse dell'istanza. Se autentichi un'identità diversa nell'istanza (ad esempio eseguendo gcloud auth login o gcloud auth application-default login), l'interfaccia a riga di comando Antigravity utilizza le autorizzazioni di quell'identità.

Prima di iniziare

  1. Accedi al tuo account Google Cloud . Se non conosci Google Cloud, crea un account per valutare le prestazioni dei nostri prodotti in scenari reali. I nuovi clienti ricevono anche 300 $di crediti senza costi per l'esecuzione, il test e il deployment dei workload.

  2. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

    Roles required to select or create a project

    • Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
    • Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

    Go to project selector

  3. Verify that billing is enabled for your Google Cloud project.

  4. Enable the Compute Engine, Notebooks, and Agent Platform APIs, if any are not already enabled.

    Roles required to enable APIs

    To enable APIs, you need the serviceusage.services.enable permission. If you created the project, then you likely already have this permission through the Owner role (roles/owner). Otherwise, you can get this permission through the Service Usage Admin role (roles/serviceusage.serviceUsageAdmin). Learn how to grant roles.

    Enable the APIs

  5. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

    Roles required to select or create a project

    • Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
    • Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

    Go to project selector

  6. Verify that billing is enabled for your Google Cloud project.

  7. Enable the Compute Engine, Notebooks, and Agent Platform APIs, if any are not already enabled.

    Roles required to enable APIs

    To enable APIs, you need the serviceusage.services.enable permission. If you created the project, then you likely already have this permission through the Owner role (roles/owner). Otherwise, you can get this permission through the Service Usage Admin role (roles/serviceusage.serviceUsageAdmin). Learn how to grant roles.

    Enable the APIs

    8.

Ruoli obbligatori

Per utilizzare l'interfaccia a riga di comando Antigravity in Agent Platform Workbench, devi concedere le autorizzazioni all'utente dell'istanza Agent Platform Workbench e al account di servizio dell'istanza.

Concedi le autorizzazioni all'utente dell'istanza

Per ottenere le autorizzazioni necessarie per utilizzare l'interfaccia a riga di comando Antigravity in un'istanza di Agent Platform Workbench, chiedi all'amministratore di concederti il ruolo IAM Agent Platform User (roles/aiplatform.user) sul progetto. Per saperne di più sulla concessione dei ruoli, consulta Gestisci l'accesso a progetti, cartelle e organizzazioni.

Potresti anche riuscire a ottenere le autorizzazioni richieste tramite i ruoli personalizzati o altri ruoli predefiniti.

Concedi un'autorizzazione al account di servizio dell'istanza

Per assicurarti che il account di servizio account dell'istanza Agent Platform Workbench disponga dell'autorizzazione necessaria per consentire l'esecuzione di Antigravity CLI in un'istanza Agent Platform Workbench, chiedi all'amministratore di concedere il ruolo IAM Agent Platform User (roles/aiplatform.user) al account di servizio account dell'istanza Agent Platform Workbench nel progetto.

Per saperne di più sulla concessione dei ruoli, consulta Gestisci l'accesso a progetti, cartelle e organizzazioni.

Questo ruolo predefinito contiene l'autorizzazione aiplatform.endpoints.predict, necessaria per abilitare l'esecuzione di Antigravity CLI in un'istanza di Agent Platform Workbench.

L'amministratore potrebbe anche essere in grado di concedere al service account dell'istanza di Agent Platform Workbench questa autorizzazione tramite ruoli personalizzati o altri ruoli predefiniti.

Abilita l'interfaccia a riga di comando Antigravity

L'interfaccia a riga di comando Antigravity è disponibile solo nelle istanze Agent Platform Workbench che utilizzano un'immagine Debian 12 (workbench-instances-2603) o versioni successive. Non è installato sulle istanze che utilizzano l'immagine Debian 11 (workbench-instances).

Nelle nuove istanze, l'interfaccia a riga di comando Antigravity è attivata per impostazione predefinita. Se non imposti la chiave dei metadati dell'istanza enable-antigravity quando crei un'istanza, Agent Platform Workbench la imposta su true.

Per attivare o disattivare l'interfaccia a riga di comando Antigravity per un'istanza, imposta la chiave dei metadati dell'istanza enable-antigravity su false o true, quindi arresta e avvia l'istanza. L'istanza applica l'impostazione all'avvio. Per saperne di più, consulta Gestisci le funzionalità tramite i metadati.

Utilizza Antigravity CLI

  1. Nella console Google Cloud , vai alla pagina Istanze.

    Vai a Istanze

  2. Accanto al nome di un'istanza di Agent Platform Workbench, fai clic su Apri JupyterLab.

  3. In JupyterLab, fai clic su File > Nuovo avviatore.

  4. Nella scheda Avvio app, nella sezione Altro, fai clic sul riquadro Antigravity CLI.

    Si apre un terminale e viene avviata l'interfaccia a riga di comando di Antigravity. Puoi anche inserire agy in qualsiasi terminale JupyterLab.

  5. Inserisci un prompt, ad esempio "Crea un nuovo notebook denominato 'test-notebook'". Per altri esempi, consulta Prompt di esempio.

  6. Quando l'interfaccia a riga di comando di Antigravity propone un'azione, ad esempio la modifica di un file o l'esecuzione di un comando shell, esaminala e approvala o rifiutala. Per saperne di più, consulta Approva le azioni dello strumento.

Skill del notebook e plug-in Google Cloud

Le competenze sono istruzioni e script che l'interfaccia a riga di comando di Antigravity utilizza per un tipo di attività. Quando l'interfaccia a riga di comando Antigravity è attiva, Agent Platform Workbench le fornisce le seguenti competenze per i notebook:

  • Targeter del notebook: trova il notebook aperto in JupyterLab, in modo che tu possa fare riferimento a "questo notebook".
  • Spiegazione del notebook: riassume le celle di un notebook e i relativi output di testo.
  • Modificatore di notebook: aggiunge e modifica le celle. Modifica solo la cella di destinazione e mantiene il notebook nel formato utilizzato da JupyterLab.
  • Strumento di convalida dei notebook: verifica che un notebook sia valido. Ti chiede conferma prima di riparare un notebook che era già non valido.
  • Autore del notebook: crea un notebook con un kernel disponibile nell'istanza.
  • Esecutore di notebook: esegue un notebook sui kernel dell'istanza e salva gli output. Se una cella non funziona, viene indicato il nome della cella.
  • Kernel creator: crea un ambiente Python e un kernel Jupyter con i pacchetti che richiedi.

Antigravity CLI include anche il plug-in google-cloud-developer del marketplace dei plug-in Antigravity. Il plug-in fornisce alla CLI Antigravity indicazioni per i comandi gcloud, assistenza per l'autenticazione, Google Cloud documentazione e competenze per prodotti come Cloud Logging, Cloud Monitoring e Agent Platform.

L'interfaccia a riga di comando Antigravity utilizza una skill o il plug-in quando il prompt lo richiede. Non è necessario nominarli nel prompt.

Prompt di esempio

Per avere idee su come utilizzare l'interfaccia a riga di comando di Antigravity, consulta i seguenti prompt di esempio:

  • "Spiega questo notebook."

  • "Aggiungi una cella a questo notebook che tracci la distribuzione della colonna 'age'."

  • "Crea un notebook che carichi bigquery-public-data.ml_datasets.census_adult_income in un DataFrame pandas, quindi eseguilo."

  • "Crea un kernel denominato 'forecast' con pandas e prophet."

  • "Verifica che ogni notebook in questa directory sia un notebook valido."

  • "Esegui una query sulla tabella bigquery-public-data.ml_datasets.census_adult_income per trovare il numero di persone con una fascia di reddito superiore a 50.000."

Utilizza il comando magico per celle %%agy

Per fare in modo che l'interfaccia a riga di comando di Antigravity scriva il codice per una cella del tuo notebook, segui questi passaggi:

  1. Nella prima riga di una nuova cella di un notebook Python, inserisci %%agy.
  2. Nelle righe successive della stessa cella, descrivi il codice che vuoi.
  3. Esegui la cella.

L'interfaccia a riga di comando Antigravity aggiunge una nuova cella sotto con il codice. Esamina il codice prima di eseguirlo.

Il comando magico per celle %%agy è progettato esclusivamente per la generazione di codice. A differenza dell'interfaccia del terminale, il comando magico della cella non può chiederti l'approvazione, quindi rifiuta automaticamente qualsiasi azione che richiede l'approvazione, ad esempio l'esecuzione di un comando della shell.

Il comando magico di cella %%agy è disponibile ogni volta che l'interfaccia a riga di comando di Antigravity è abilitata.

Approva le azioni dello strumento

Per impostazione predefinita, l'interfaccia a riga di comando Antigravity in Agent Platform Workbench chiede la tua approvazione prima di intraprendere qualsiasi azione, ad esempio modificare un file, eseguire un comando shell o recuperare un URL. Esamina ogni azione proposta prima di approvarla.

Questa impostazione predefinita protegge dal prompt injection. Un notebook, uno script o una pagina web letti dall'interfaccia a riga di comando Antigravity potrebbero contenere istruzioni nascoste che tentano di far eseguire all'agente comandi non previsti, ad esempio l'invio dei tuoi dati a un indirizzo esterno. L'interfaccia a riga di comando Antigravity viene eseguita con le credenziali della tua istanza, quindi la richiesta di approvazione ti dà l'opportunità di visualizzare e interrompere un'azione di questo tipo prima che venga eseguita.

Per questo motivo, l'opzione per saltare i prompt di approvazione è disabilitata per l'interfaccia a riga di comando Antigravity nelle istanze di Agent Platform Workbench.

Controlla l'accesso all'interfaccia a riga di comando Antigravity

Puoi controllare l'accesso all'interfaccia a riga di comando Antigravity in Agent Platform Workbench utilizzando i seguenti metodi:

  • Un amministratore può impostare la chiave dei metadati dell'istanza enable-antigravity su false. Il riquadro Antigravity CLI, le competenze del notebook, il plug-in e il comando magico della cella %%agy vengono quindi rimossi al successivo avvio dell'istanza. Il comando agy rimane installato. Per impedire le chiamate ai modelli, utilizza i metodi seguenti.

  • Un amministratore può configurare una policy dell'organizzazione per limitare l'utilizzo di modelli specifici a livello di organizzazione, cartella o progetto. Consulta Controlla l'accesso ai modelli di Model Garden.

  • Se non concede l'autorizzazione aiplatform.endpoints.predict, un amministratore può impedire ad alcune identità di utilizzare gli endpoint del modello per l'inferenza.

Passaggi successivi