Antigravity CLI verwenden

Auf dieser Seite wird beschrieben, wie Sie die Antigravity-Befehlszeile (CLI) mit einer Gemini Enterprise Agent Platform Workbench-Instanz verwenden.

Dieses Dokument richtet sich an Datenanalysten, Data Scientists und Datenentwickler, die mit Agent Platform Workbench arbeiten. In diesem Dokument wird davon ausgegangen, dass Sie wissen, wie Sie Code in einer Notebook-Umgebung schreiben.

Übersicht

Antigravity CLI ist die terminalbasierte Oberfläche von Google Antigravity, einem KI-Coding-Agenten, der in einem Terminal ausgeführt wird. Weitere Informationen finden Sie unter antigravity.google.

Die Antigravity CLI ist in einem Terminal in der JupyterLab-Oberfläche Ihrer Agent Platform Workbench-Instanz verfügbar. Sie können damit Notebooks und Dateien auf Ihrer Instanz bearbeiten und Shell- und Google Cloud -Befehle ausführen, indem Sie Anweisungen in natürlicher Sprache geben.

Die Agent Platform Workbench fügt der Antigravity-Befehlszeile Folgendes hinzu:

  • Notebook-Skills, mit denen Notebooks erstellt, erklärt, bearbeitet, geprüft und ausgeführt sowie Jupyter-Kernel erstellt werden können.
  • Ein Google Cloud -Plug-in mit Dokumentation und Anleitung für gcloud-Befehle von Google Cloud .
  • Die %%agy-Cell-Magic, die den Code für eine Notebookzelle anhand Ihrer Beschreibung schreibt.

Beschränkungen

Beachten Sie die folgenden Einschränkungen, wenn Sie die Antigravity CLI mit der Agent Platform Workbench verwenden:

  • Die Antigravity CLI ist nur eine Befehlszeile. Eine grafische Chatoberfläche und erweiterte Tools im Editor sind nicht enthalten.

  • Wenn Sie die Antigravity CLI auffordern, ein Notebook zu ändern, wird die Notebook-Datei direkt auf dem Laufwerk der Instanz geändert. Daher können Sie Änderungen, die mit der Antigravity CLI vorgenommen wurden, nicht mit der Schaltfläche Rückgängig oder Strg + Z (Befehlstaste + Z unter macOS) im Notebook-Editor rückgängig machen. Sie können die Antigravity CLI jedoch bitten, eine Änderung mit einem Befehl in natürlicher Sprache rückgängig zu machen, z. B. Undo your last change.

  • Die Antigravity-Befehlszeile schreibt direkt auf das Laufwerk und kann Dateien ändern, die Sie auch in JupyterLab geöffnet haben. Wenn Sie nicht gespeicherte Änderungen in einem Notebook haben, speichern Sie diese, bevor Sie die Antigravity CLI auffordern, dieses Notebook zu ändern.

  • Die Antigravity CLI ist an die Version gebunden, die im Image Ihrer Instanz enthalten ist, und kann sich nicht selbst aktualisieren. Wenn Sie eine neuere Version verwenden möchten, führen Sie ein Upgrade Ihrer Instanz auf eine neuere Image-Version durch. Weitere Informationen finden Sie unter Umgebung einer Instanz aktualisieren.

  • Die Antigravity CLI wird mit den Anmeldedaten ausgeführt, die auf Ihrer Instanz aktiv sind. Standardmäßig sind dies die Dienstkonto-Anmeldedaten Ihrer Agent Platform Workbench-Instanz, sodass die Antigravity CLI auf dieselben Ressourcen wie die Instanz zugreifen kann. Wenn Sie eine andere Identität auf der Instanz authentifizieren (z. B. durch Ausführen von gcloud auth login oder gcloud auth application-default login), verwendet die Antigravity CLI stattdessen die Berechtigungen dieser Identität.

Hinweis

  1. Melden Sie sich in Ihrem Google Cloud -Konto an. Wenn Sie mit Google Cloudnoch nicht vertraut sind, erstellen Sie einfach ein Konto, um die Leistungsfähigkeit unserer Produkte in der Praxis sehen und bewerten zu können. Neukunden erhalten außerdem ein Guthaben von 300 $, um Arbeitslasten auszuführen, zu testen und bereitzustellen.

  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.

Erforderliche Rollen

Wenn Sie die Antigravity CLI in der Agent Platform Workbench verwenden möchten, müssen Sie dem Nutzer der Agent Platform Workbench-Instanz und dem Dienstkonto der Instanz Berechtigungen gewähren.

Dem Nutzer der Instanz Berechtigungen gewähren

Bitten Sie Ihren Administrator, Ihnen die IAM-Rolle Agent Platform User (roles/aiplatform.user) für das Projekt zuzuweisen, um die Berechtigungen zu erhalten, die Sie zum Verwenden der Antigravity CLI in einer Agent Platform Workbench-Instanz benötigen. Weitere Informationen zum Zuweisen von Rollen finden Sie unter Zugriff auf Projekte, Ordner und Organisationen verwalten.

Sie können die erforderlichen Berechtigungen auch über benutzerdefinierte Rollen oder andere vordefinierte Rollen erhalten.

Dem Dienstkonto Ihrer Instanz eine Berechtigung gewähren

Damit das Dienstkonto Ihrer Agent Platform Workbench-Instanz die erforderliche Berechtigung hat, um die Antigravity CLI in einer Agent Platform Workbench-Instanz auszuführen, bitten Sie Ihren Administrator, dem Dienstkonto Ihrer Agent Platform Workbench-Instanz die IAM-Rolle Agent Platform User (roles/aiplatform.user) für das Projekt zuzuweisen.

Weitere Informationen zum Zuweisen von Rollen finden Sie unter Zugriff auf Projekte, Ordner und Organisationen verwalten.

Diese vordefinierte Rolle enthält die Berechtigung aiplatform.endpoints.predict, die erforderlich ist, um die Antigravity CLI in einer Agent Platform Workbench-Instanz auszuführen.

Ihr Administrator kann dem Dienstkonto Ihrer Agent Platform Workbench-Instanz möglicherweise auch diese Berechtigung mit benutzerdefinierten Rollen oder anderen vordefinierten Rollen erteilen.

Antigravity CLI aktivieren

Die Antigravity CLI ist nur auf Agent Platform Workbench-Instanzen verfügbar, die ein Debian 12-Image (workbench-instances-2603) oder höher verwenden. Er ist nicht auf Instanzen installiert, die das Debian 11-Image (workbench-instances) verwenden.

Bei neuen Instanzen ist die Antigravity CLI standardmäßig aktiviert. Wenn Sie den Instanzmetadatenschlüssel enable-antigravity beim Erstellen einer Instanz nicht festlegen, wird er von Agent Platform Workbench auf true gesetzt.

Wenn Sie die Antigravity-Befehlszeile für eine Instanz deaktivieren oder aktivieren möchten, setzen Sie den Instanzmetadatenschlüssel enable-antigravity auf false oder true und beenden und starten Sie die Instanz dann. Die Instanz wendet die Einstellung beim Start an. Weitere Informationen finden Sie unter Features über Metadaten verwalten.

Antigravity CLI verwenden

  1. Rufen Sie in der Google Cloud Console die Seite Instanzen auf.

    Zur Seite „VM-Instanzen“

  2. Klicken Sie neben dem Namen einer Agent Platform Workbench-Instanz auf JupyterLab öffnen.

  3. Klicken Sie in JupyterLab auf Datei > Neuer Launcher.

  4. Klicken Sie auf dem Tab Launcher im Abschnitt Sonstiges auf die Kachel Antigravity CLI.

    Ein Terminal wird geöffnet und die Antigravity CLI wird gestartet. Sie können auch agy in ein beliebiges JupyterLab-Terminal eingeben.

  5. Geben Sie einen Prompt ein, z. B. „Erstelle ein neues Notebook mit dem Namen ‚test-notebook‘“. Weitere Beispiele finden Sie unter Beispiel-Prompts.

  6. Wenn die Antigravity CLI eine Aktion vorschlägt, z. B. das Bearbeiten einer Datei oder das Ausführen eines Shell-Befehls, prüfen Sie sie und genehmigen oder lehnen Sie sie ab. Weitere Informationen finden Sie unter Toolaktionen genehmigen.

Notebook-Skills und das Google Cloud -Plug-in

Skills sind Anweisungen und Scripts, die die Antigravity CLI für einen bestimmten Aufgabentyp verwendet. Wenn die Antigravity CLI aktiviert ist, erhält sie von Agent Platform Workbench die folgenden Notebook-Fähigkeiten:

  • Notebook-Targeter: Findet das Notebook, das Sie in JupyterLab geöffnet haben, sodass Sie es als „dieses Notebook“ bezeichnen können.
  • Notebook-Erklärer: fasst die Zellen eines Notebooks und ihre Textausgaben zusammen.
  • Notebook-Bearbeiter: Fügt Zellen hinzu und bearbeitet sie. Es wird nur die Zielzelle geändert und das Notebook bleibt im von JupyterLab verwendeten Format.
  • Notebook-Validator: Prüft, ob ein Notebook gültig ist. Sie werden gefragt, bevor ein Notebook repariert wird, das bereits ungültig war.
  • Notebook-Ersteller: Erstellt ein Notebook mit einem Kernel, der auf der Instanz verfügbar ist.
  • Notebook-Executor: Führt ein Notebook auf den Kerneln der Instanz aus und speichert die Ausgaben. Wenn eine Zelle fehlschlägt, wird sie benannt.
  • Kernel-Ersteller: Erstellt eine Python-Umgebung und einen Jupyter-Kernel mit den von Ihnen angeforderten Paketen.

Die Antigravity CLI enthält auch das google-cloud-developer-Plug-in aus dem Antigravity-Plug-in-Marktplatz. Das Plug-in bietet der Antigravity CLI Anleitungen für gcloud-Befehle, Hilfe bei der Authentifizierung, Dokumentation zu Google Cloud und Funktionen für Produkte wie Cloud Logging, Cloud Monitoring und Agent Platform.

Die Antigravity CLI verwendet einen Skill oder das Plug-in, wenn Ihr Prompt dies erfordert. Sie müssen sie nicht in Ihrem Prompt nennen.

Beispiel-Prompts

In den folgenden Beispiel-Prompts finden Sie Ideen zur Verwendung der Antigravity CLI:

  • „Erkläre mir dieses Notebook.“

  • „Füge diesem Notebook eine Zelle hinzu, die die Verteilung der Spalte ‚age‘ darstellt.“

  • „Erstelle ein Notebook, das bigquery-public-data.ml_datasets.census_adult_income in einen Pandas-DataFrame lädt, und führe es dann aus.“

  • „Erstelle einen Kernel mit dem Namen ‚forecast‘ mit pandas und prophet.“

  • „Prüfen Sie, ob jedes Notebook in diesem Verzeichnis ein gültiges Notebook ist.“

  • „Frage die Tabelle bigquery-public-data.ml_datasets.census_adult_income ab, um die Anzahl der Personen mit einer Einkommensklasse von >50K zu ermitteln.“

Verwenden Sie die Zell-Magie %%agy.

So lassen Sie die Antigravity CLI den Code für eine Zelle in Ihrem Notebook schreiben:

  1. Geben Sie in der ersten Zeile einer neuen Zelle in einem Python-Notebook %%agy ein.
  2. Beschreiben Sie in den nächsten Zeilen derselben Zelle den gewünschten Code.
  3. Führen Sie die Zelle aus.

Die Antigravity CLI fügt darunter eine neue Zelle mit dem Code hinzu. Überprüfen Sie den Code, bevor Sie ihn ausführen.

Die Cell Magic %%agy ist ausschließlich für die Codegenerierung vorgesehen. Im Gegensatz zur Terminaloberfläche kann die Cell Magic Sie nicht um Genehmigung bitten. Daher werden alle Aktionen, die eine Genehmigung erfordern, z. B. das Ausführen eines Shell-Befehls, automatisch abgelehnt.

Die Cell Magic %%agy ist immer verfügbar, wenn die Antigravity CLI aktiviert ist.

Tool-Aktionen genehmigen

Standardmäßig bittet die Antigravity CLI in der Agent Platform Workbench um Ihre Genehmigung, bevor sie eine Aktion ausführt, z. B. das Bearbeiten einer Datei, das Ausführen eines Shell-Befehls oder das Abrufen einer URL. Prüfen Sie jede vorgeschlagene Aktion, bevor Sie sie genehmigen.

Diese Standardeinstellung schützt vor Prompt Injections. Ein Notebook, ein Script oder eine Webseite, die von der Antigravity CLI gelesen wird, könnte versteckte Anweisungen enthalten, die versuchen, den Agenten dazu zu bringen, Befehle auszuführen, die Sie nicht beabsichtigt haben, z. B. das Senden Ihrer Daten an eine externe Adresse. Die Antigravity CLI wird mit den Anmeldedaten Ihrer Instanz ausgeführt. Wenn Sie eine Genehmigung anfordern, können Sie eine solche Aktion sehen und beenden, bevor sie ausgeführt wird.

Aus diesem Grund ist die Option zum Überspringen von Genehmigungsaufforderungen für die Antigravity CLI auf Agent Platform Workbench-Instanzen deaktiviert.

Zugriff auf die Antigravity CLI steuern

Sie können den Zugriff auf die Antigravity CLI in Agent Platform Workbench mit den folgenden Methoden steuern:

  • Ein Administrator kann den Instanzmetadatenschlüssel enable-antigravity auf false festlegen. Die Kachel Antigravity CLI, die Notebook-Skills, das Plug-in und die Cell Magic %%agy werden dann beim nächsten Start der Instanz entfernt. Der Befehl agy bleibt installiert. Verwenden Sie die folgenden Methoden, um Modellaufrufe zu verhindern.

  • Ein Administrator kann eine Organisationsrichtlinie einrichten, um die Verwendung bestimmter Modelle auf Organisations-, Ordner- oder Projektebene einzuschränken. Weitere Informationen finden Sie unter Zugriff auf Model Garden-Modelle steuern.

  • Wenn die Berechtigung aiplatform.endpoints.predict nicht gewährt wird, kann ein Administrator verhindern, dass bestimmte Identitäten Modellendpunkte für die Inferenz verwenden.

Nächste Schritte