1. Einführung
In diesem Codelab lernen Sie die Antigravity CLI kennen, eine einfache Terminal-Benutzeroberfläche (Terminal User Interface, TUI) von Antigravity. Es bietet dieselben grundlegenden agentischen Funktionen wie Antigravity 2.0, z. B. mehrstufige Problemlösung, Bearbeitung mehrerer Dateien, Tool-Aufrufe und Unterhaltungsverlauf, direkt in Ihrem Terminal.
Lerninhalte
- Antigravity CLI installieren und konfigurieren
- Grundlegende Verwendung der Antigravity CLI
- Einige Anwendungsfälle mit der Antigravity CLI
Voraussetzungen
Sie benötigen Folgendes:
- Chrome-Webbrowser
- Ein Gmail-Konto
Dieses Codelab richtet sich an Nutzer und Entwickler aller Erfahrungsstufen (auch Anfänger). Die Anwendungsfälle im Codelab wurden in Entwickler- und Nichtentwickleraufgaben unterteilt. Die Anwendungsfälle für Entwickler zeigen, wie Sie Code mit der Antigravity CLI optimieren und mit einem GitHub-Repository arbeiten können, um gängige Entwicklungsaufgaben wie Codeerklärung/-verständnis, Generieren von Dokumentation und Beheben von Problemen auszuführen. Wir empfehlen, diese Anwendungsfälle im Codelab durchzuarbeiten. Am Ende gibt es einen optionalen Abschnitt, in dem mehrere alltägliche Aufgaben behandelt werden, die nicht auf Entwickler ausgerichtet sind.
2. Hinweis
Projekt erstellen
- Wählen Sie in der Google Cloud Console auf der Seite zur Projektauswahl ein Google Cloud-Projekt aus oder erstellen Sie eines.
- Die Abrechnung für das Cloud-Projekt muss aktiviert sein. So prüfen Sie, ob die Abrechnung für ein Projekt aktiviert ist.
- Sie verwenden Cloud Shell, eine Befehlszeilenumgebung, die in Google Cloud ausgeführt wird und in der bq vorinstalliert ist. Klicken Sie oben in der Google Cloud Console auf „Cloud Shell aktivieren“.
- Sobald die Verbindung mit der Cloud Shell hergestellt ist, können Sie mit dem folgenden Befehl prüfen, ob Sie bereits authentifiziert sind und für das Projekt schon Ihre Projekt-ID eingestellt ist:
gcloud auth list
- Führen Sie den folgenden Befehl in Cloud Shell aus, um zu prüfen, ob der gcloud-Befehl Ihr Projekt kennt.
gcloud config list project
- Wenn Ihr Projekt nicht festgelegt ist, verwenden Sie den folgenden Befehl, um es festzulegen:
gcloud config set project <YOUR_PROJECT_ID>
3. Installation
Bevor Sie die Einrichtung vornehmen und die Antigravity CLI ausführen, erstellen wir einen Ordner, der als Basisordner für alle Projekte dient, die wir darin erstellen. Dies ist ein Ausgangspunkt für die Arbeit mit der Antigravity CLI. Bei Bedarf wird aber auch auf andere Ordner in Ihrem System verwiesen, die Sie später kennenlernen.
Erstellen Sie einen Beispielordner (agy-cli-projects) und wechseln Sie mit den unten gezeigten Befehlen zu diesem Ordner. Wenn Sie einen anderen Ordnernamen verwenden möchten, können Sie das tun.
mkdir agy-cli-projects
Rufen wir diesen Ordner auf:
cd agy-cli-projects
Die Installation ist einfach und Binärdateien sind für die wichtigsten Betriebssysteme verfügbar. Die Befehle für das Terminal habe ich direkt aus dem Installationsdokument übernommen:
macOS | Linux
curl -fsSL https://antigravity.google/cli/install.sh | bash
Windows PowerShell
irm https://antigravity.google/cli/install.ps1 | iex
Windows-CMD
curl -fsSL https://antigravity.google/cli/install.cmd -o install.cmd && install.cmd && del install.cmd
Dadurch sollte die Antigravity-Befehlszeile (agy) in Ihrem System und im Pfad eingerichtet und installiert werden.
In einigen Fällen wird eine Meldung angezeigt, wenn das Binärprogramm ( agy ) nicht zum PATH hinzugefügt werden kann. Hier ist ein Beispiel für die Ausgabe auf einem Computer, auf dem das Binärprogramm nicht zum PATH hinzugefügt werden konnte. Es wird auch vorgeschlagen, was zu tun ist.
% curl -fsSL https://antigravity.google/cli/install.sh | bash
⠋ Detecting system environment...
✓ Platform detected: darwin_arm64
⠋ Querying release repository...
✓ Latest available version: 1.0.1
⠋ Downloading release package...
✓ Download complete and checksum verified.
⠋ Extracting binary from archive...
⠋ Configuring shell environment...
I0523 11:44:14.012088 76528 installer.go:27] Running Antigravity CLI setup...
Warning: /Users/neilirani/.local/bin is not present in your active PATH.
To use the 'agy' CLI globally, please manually add it to your shell profile:
echo 'export PATH="/Users/yourusername/.local/bin:$PATH"' >> ~/.zshrc && source ~/.zshrc
✅ Antigravity CLI binary placed successfully at /Users/yourusername/.local/bin/agy
Note: The binary is installed, but it is not in your active PATH. Please follow the instructions above to add it, then restart your terminal session.
Prüfen Sie die Version der Antigravity CLI mit dem folgenden Befehl (die angezeigte Version ist die zum Zeitpunkt des Schreibens dieses Codelabs):
$ agy --version
1.0.5
Wenn Sie die Antigravity CLI zum ersten Mal starten, werden Sie aufgefordert, sich anzumelden. Starten Sie agy. Es sollte in etwa so aussehen:
▄▀▀▄
▀▀▀▀▀▀
▀▀▀▀▀▀▀▀
▄▀▀ ▀▀▄
▄▀▀ ▀▀▄
Welcome to the Antigravity CLI. You are currently not signed in.
Select login method:
> 1. Google OAuth
2. Use a Google Cloud project
[Use arrow keys to navigate, Enter to select]
Verwenden Sie vorerst Ihr privates Konto. Wählen Sie 1 aus. Google OAuth ein und drücken Sie die Eingabetaste. Dadurch wird ein Browser geöffnet, in dem Sie sich mit Ihrem Google-Konto anmelden können. Nach erfolgreicher Authentifizierung und Autorisierung werden Sie aufgefordert, einen Code zu kopieren. Kehren Sie zum Antigravity CLI-Terminal zurück und fügen Sie den Code ein.
Nach erfolgreicher Anmeldung passiert Folgendes:
- Zuerst werden Sie nach dem Farbschema gefragt, das Sie für die Antigravity CLI auswählen möchten, wie unten dargestellt. Wählen Sie die gewünschte Option aus.
- Als Nächstes müssen Sie einige Nutzungsbedingungen akzeptieren. Akzeptieren Sie diese.
Schließlich müssen Sie noch Ihre Zustimmung geben, dass Sie dem Ordner vertrauen, wie unten dargestellt:
Accessing workspace:
/Users/yourusername/agy-cli-projects
Do you trust the contents of this project?
Antigravity CLI requires permission to read, edit, and execute files here.
> Yes, I trust this folder
No, exit
↑/↓ Navigate · enter Confirm
Diese Meldung wird in der Regel in jedem neuen Ordner angezeigt, in dem Sie die Antigravity CLI starten. Wir werden später in der Reihe noch genauer darauf eingehen. Klicken Sie jetzt einfach auf Yes, I trust this folder (Ja, ich vertraue diesem Ordner).
Glückwunsch! Sie sind jetzt bereit und die Antigravity CLI wartet auf Ihren Prompt.
4. Erste Interaktion mit der Antigravity CLI
Legen wir also mit der Antigravity CLI los. Geben Sie die folgende Anfrage ein:
Give me a famous quote on Artificial Intelligence and who said that?
Die erwartete Antwort lautet:
● WebSearch(famous quotes on Artificial Intelligence) (ctrl+o to expand)
Here is one of the most famous quotes on Artificial Intelligence:
│ "AI is the new electricity."
│ — Andrew Ng (Co-founder of Coursera and Google Brain, Adjunct Professor at Stanford University)
Another widely cited perspective on the potential risks of AI is:
│ "The development of full artificial intelligence could spell the end of the human race. It would take off on its
│ own, and re-design itself at an ever-increasing rate."
│ — Stephen Hawking
Sie sehen, dass Antigravity eines seiner internen Tools, WebSearch, verwendet hat, um das Zitat zu finden.
Welche verschiedenen Befehle werden von der Antigravity CLI unterstützt? Sie können sich schnell einen Überblick über die Gemini CLI und die verschiedenen unterstützten Befehle verschaffen, indem Sie /help (Schrägstrich) eingeben. Sie erhalten dann verschiedene Befehle und Tastenkombinationen: Einige der Befehle zum Zeitpunkt der Erstellung dieses Dokuments sind unten aufgeführt:
Antigravity CLI general commands shortcuts (←/→ or tab to cycle)
Available Commands
> /add-dir Add a directory to the workspace
/agents List available custom agents
/artifact View and review artifacts
/btw Ask a side question without interrupting the current task
/changelog Show release notes and changes
/clear (new) Clear conversation and start a new one
/config (settings) Open settings panel
/context Visualize current context usage
/copy Copy the last planner response to the clipboard (may require allowing clipboard ac...
/credits Show remaining G1 credits and purchase link
/diff View uncommitted changes and per-turn diffs
/exit (quit) Exit the CLI
/fast Agent will execute tasks directly. Use for simple tasks that can be completed faster
/feedback Submit qualitative feedback to improve the agent
/fork (branch) Create a branch of the current conversation at this point
/help Show available commands and keybindings
/hooks Manage hook configurations for tool events
/keybindings Set custom keybindings
/logout Log out
/mcp Manage MCP servers
/model Set a model
/open Open a file or view opened/edited files
/permissions Manage tool permissions
/planning Agent can plan before executing tasks. Use for deep research, complex tasks, or co...
<MORE_COMMANDS>
Wir beenden die Antigravity CLI jetzt. Das können Sie entweder mit dem Befehl /quit oder durch zweimaliges Drücken von ctrl+d in der interaktiven Antigravity CLI-Terminalsitzung tun.
5. Antigravity CLI – einige organisatorische Befehle
Achten Sie darauf, dass die Antigravity CLI gestartet wurde und auf Ihren Befehl wartet.
Das verwendete Modell wird unten rechts angezeigt. Die meisten Anpassungen und Einstellungen, die Sie vornehmen müssen, sind über den Befehl /config oder /settings verfügbar.
Konfiguration / Einstellungen
Rufen Sie den Befehl /config auf. Dadurch werden verschiedene Bereiche von Antigravity aufgerufen, die Sie nach Ihren Wünschen anpassen können. Dazu gehören das Farbschema, die Tool-Berechtigung, die Telemetrieeinstellungen und mehr.
Settings
Search:
────────────────────
> Animation Speed medium
Artifact Review asks for review
Color Scheme dark
Editor auto ($EDITOR)
Enable Telemetry on
Non-Workspace Access off
Notifications off
Rendering Mode native terminal (inline)
Sandbox Mode off
Show Feedback Survey on
Show Tips on
Tool Permission request-review
Use AI Credits off
Verbosity high
Wenn ich beispielsweise „Farbschema“ eingebe, werden mir die folgenden Optionen angezeigt, aus denen ich mein bevorzugtes Farbschema auswählen kann:
Color Scheme ╭─────────────────────────────────────────────────────────────╮
terminal │
light │
solarized light │
colorblind-friendly light │
> dark (current) │
solarized dark │
colorblind-friendly dark │
tokyo night
settings.json
Die Konfigurationseinstellungen müssen ja irgendwo gespeichert werden. Alle werden in der Datei ~/.gemini/antigravity-cli/settings.json gespeichert. Im Folgenden finden Sie ein -Beispiel:
{
"colorScheme": "dark",
"model": "Gemini 3.5 Flash (High)",
"statusLine": {
"type": "",
"command": "",
"enabled": true
},
"trustedWorkspaces": [
"/Users/romin/antigravity-cli-projects",
"/Users/romin/agy-cli-projects"
]
}
Sie sehen die colorScheme, die ich ausgewählt habe, das Modell und verschiedene Ordner, in denen ich Antigravity CLI gestartet und bestätigt habe, dass ich den Ordnern vertraue.
Hinweis: Sie können settings.json auch direkt ändern und die Antigravity-Befehlszeile neu starten, um die Änderungen zu sehen. Achten Sie jedoch auf die Einstellungen, da sonst beim Starten ein Fehler angezeigt wird. Wenn Sie die Datei nicht direkt bearbeiten möchten, empfiehlt es sich, den Befehl /settings oder /config in der Antigravity CLI zu verwenden.
Toolberechtigung
Eine wichtige Einstellung ist die Tool-Berechtigung. Damit wird festgelegt, ob Terminalbefehle vor der Ausführung Ihre Genehmigung benötigen. Sie können dies über den Befehl /config aufrufen.
Tool Permission
> request-review (current)
proceed-in-sandbox
always-proceed
strict
Standardmäßig ist sie auf request-review eingestellt. Sehen wir uns das genauer an. In Antigravity steuern die Einstellungen für Tool-Berechtigungen das Gleichgewicht zwischen Sicherheit (Schutz Ihres Hostsystems vor unbeabsichtigten Änderungen) und Geschwindigkeit (wie autonom der Agent arbeiten kann, ohne auf Ihre Eingabe zu warten). Sehen wir uns die Optionen an:
request-review (aktueller Standard)
In diesem Modus wird der Agent als Partner betrachtet, der sich meldet, bevor er eine Aktion ausführt, die sich auf Ihr System oder Ihre Projektdateien außerhalb der vorab genehmigten Grenzen auswirken könnte. Immer wenn der Agent versucht, einen Terminalbefehl auszuführen, eine Dateioperation (z. B. Schreiben/Löschen) durchzuführen oder einen externen Dienst aufzurufen, für den keine Genehmigung vorliegt, wird die Ausführung angehalten. Der Nutzer wird aufgefordert, die jeweilige Aktion zu genehmigen oder abzulehnen.
proceed-in-sandbox
In diesem Modus kann der Agent Terminalbefehle automatisch ausführen, jedoch in einem sicheren, isolierten Container. Der Agent kann Befehle ausführen, ohne Sie zu fragen. Diese Befehle werden jedoch in einer virtualisierten Sandbox (z. B. einem Lightweight-Container) ausgeführt. Sie können das Dateisystem Ihres tatsächlichen Hostcomputers nicht ändern und nicht auf Ihr lokales Netzwerk zugreifen.
always-proceed
Dies ist der vollständig autonome Modus, der dem KI-Agenten maximale Geschwindigkeit und Leistungsfähigkeit bietet. Der KI-Agent hat die volle Berechtigung, Befehle auszuführen und Dateien direkt auf Ihrem Hostcomputer zu schreiben. Sie werden niemals um eine Bestätigung gebeten.
strict
Dies ist ein Zero-Trust-Modus mit hoher Sicherheit. Die Funktionen des Agents sind auf die Ausführung von Lesetools beschränkt. Bei allen Tools, die nicht nur Lesezugriff benötigen, muss der Nutzer zur Aktion aufgefordert werden.
6. Antigravity CLI – Befehlsparameter
Beim Starten der Antigravity CLI können Sie einige Befehlszeilenparameter angeben. Eine vollständige Liste der Optionen erhalten Sie mit --help (siehe unten).
agy --help
Daraufhin sollte die vollständige Liste der verfügbaren Optionen angezeigt werden. Ein Beispiel finden Sie unten:
$ agy --help
Usage of agy:
--add-dir Add a directory to the workspace (repeatable) (default [])
-c Short alias for --continue
--continue Continue the most recent conversation
--conversation Resume a previous conversation by ID
--dangerously-skip-permissions Auto-approve all tool permission requests without prompting
-i Short alias for --prompt-interactive
--log-file Override CLI log file path
--model Model for the current CLI session
-p Short alias for --print
--print Run a single prompt non-interactively and print the response
--print-timeout Timeout for print mode wait (default 5m0s)
--prompt Alias for --print
--prompt-interactive Run an initial prompt interactively and continue the session
--sandbox Run in a sandbox with terminal restrictions enabled
Available subcommands:
changelog Show changelog and release notes
help Show help for subcommands
install Configure environment paths and shell settings
models List available models
plugin Manage plugins (install, uninstall, list, enable, disable)
plugins Alias for plugin
update Update CLI
Sehen wir uns einige davon an.
Nicht interaktiver Modus (autonom)
Eine interessante Option ist die Ausführung der Antigravity CLI im nicht interaktiven Modus. Das bedeutet, dass Sie den Prompt direkt eingeben und Gemini darauf antwortet, ohne dass sich das interaktive Terminal der Antigravity CLI öffnet. Das ist sehr nützlich, wenn Sie die Antigravity CLI automatisiert im Rahmen eines Skripts oder eines anderen Automatisierungsprozesses verwenden möchten.
Sie verwenden den Parameter -p, um den Prompt für die Antigravity CLI anzugeben, wie unten gezeigt:
agy -p "What is the gcloud command to deploy to Cloud Run"
So können Sie schnell Antworten erhalten. Beachten Sie jedoch, dass es keine Möglichkeit gibt, die Unterhaltung mit weiterführenden Fragen fortzusetzen.
Bestimmtes Modell auswählen
Erstens können Sie Antigravity CLI auffordern, einen bestimmten Gemini-Modus zu verwenden. Mit dem Parameter --model können Sie Antigravity CLI anweisen, nur während der aktuellen Sitzung ein bestimmtes Modell zu verwenden. Das ist sehr nützlich für den nicht interaktiven Modus, den wir im vorherigen Abschnitt erwähnt haben, in dem Sie mehrere agy-Sitzungen starten und bestimmte Modelle für bestimmte Aufgaben verwenden möchten.
Zuerst müssen Sie jedoch wissen, welche Modelle für die Antigravity CLI verfügbar sind. Dazu können Sie den Unterbefehl models verwenden, wie unten gezeigt:
$ agy models
Gemini 3.5 Flash (Medium)
Gemini 3.5 Flash (High)
Gemini 3.5 Flash (Low)
Gemini 3.1 Pro (Low)
Gemini 3.1 Pro (High)
Claude Sonnet 4.6 (Thinking)
Claude Opus 4.6 (Thinking)
Sie können einen dieser Modellnamen verwenden, um das Modell für die Sitzung anzugeben. Dazu können Sie den unten gezeigten Befehl --model verwenden:
$ agy --model "Claude Opus 4.6 (Thinking)"
Nach dem Start der Antigravity CLI können Sie entweder mit dem Befehl /model das spezifische Modell prüfen, das Sie für die Verwendung angefordert haben, oder unten rechts nachsehen, welches Modell für die Sitzung verwendet wird.
Gefährlich leben
Wenn Sie es gerne riskant mögen, können Sie nach einem sehr passend benannten Parameter namens --dangerously-skip-permissions suchen. Damit werden alle Toolberechtigungen automatisch genehmigt. Sie werden nicht aufgefordert, Berechtigungen zu erteilen. Verwenden Sie ihn also mit Bedacht.
Starten Sie die Antigravity CLI mit dem folgenden Befehl:
agy --dangerously-skip-permissions
Geben Sie dann den folgenden Prompt ein. Prüfe, ob ich nach Schreibberechtigungen für Dateien gefragt wurde.
> get the latest news and write it in a file called news.txt. Then create another file that contains the summary of that file.
● ListDir(/Users/romin/agy-cli-projects)
● WebSearch(latest world news May 24 2026 news headlines) (ctrl+o to expand)
▸ Thought for 2s, 95 tokens
Processing News Information
● Create(/Users/romin/agy-cli-projects/news.txt)
● Create(/Users/romin/agy-cli-projects/summary.txt) (ctrl+o to expand)
I have fetched the latest world news headlines and created the requested files in your workspace:
1. news.txt: Contains the detailed news headlines for today (May 24, 2026), including topics on geopolitics (U.S.-Iran negotiations, Ukraine conflict), U.S.
security incidents, the Ebola outbreak in Central Africa, and the passing of NASCAR champion Kyle Busch.
2. summary.txt: Contains a concise, structured summary of the major categories covered in the news file.
Dieser Modus kann in Szenarien nützlich sein, in denen die Dinge lokal und unter Ihrer Kontrolle sind. Sie sollten jedoch auf Überraschungen vorbereitet sein und ihn daher mit Bedacht verwenden.
7. Antigravity CLI – Shell-Modus
Jetzt ist ein guter Zeitpunkt, um zu lernen, wie Sie direkt in der Antigravity CLI mit der Shell arbeiten. Sie können den Shell-Modus aktivieren, indem Sie im Nachrichtenfeld ! eingeben. Sie wechseln dann in einen Shell-Modus. Sie können zurückkehren, indem Sie noch einmal auf ! oder auf die Taste ESC drücken.
Im Shell-Modus sehen Sie das ! am Anfang des Prompts, wie unten gezeigt:
Sie können dies direkt mit Standardbefehlen wie pwd und ls prüfen, wie unten gezeigt. Bei den Befehlen wird von einem Linux-Betriebssystem ausgegangen. Wenn Sie ein anderes Betriebssystem (Windows) verwenden, nutzen Sie bitte entsprechende Befehle wie cd, dir und type.
8. Anwendungsfälle zum Ausprobieren
Die Antigravity-Befehlszeile kann für eine Vielzahl von Anwendungsfällen verwendet werden, die sowohl für Entwickler als auch für Nicht-Entwickler relevant sind. Hier sind einige Szenarien aufgeführt, die Sie je nach Interesse ausprobieren können.
In jedem dieser Fälle wird der Prompt angegeben. Sie können dies im interaktiven Modus der Antigravity CLI ausprobieren, um besser zu verstehen, wie die Antigravity CLI ihre Aufgabe erfüllt.
Vibe Coding mit der Antigravity CLI
Wir verwenden die Antigravity CLI, um eine Anwendung zu erstellen. In dieser Aufgabe bitten Sie Antigravity CLI, eine Anwendung zu generieren, und übertragen dann die erste Version per Push in ein GitHub-Repository.
Voraussetzung
Für die Aufgaben in diesem Abschnitt gelten einige Voraussetzungen:
- Git
- Antigravity CLI
- Python 3-Umgebung
- Richten Sie
gh( GitHub CLI-Tool) ein. - Grundkenntnisse in Git und etwas Programmierwissen
Wir gehen davon aus, dass Sie die Antigravity CLI in einem bestimmten Ordner Ihrer Wahl gestartet haben. In unserem Fall haben wir die Antigravity CLI über den ursprünglichen Basisordner agy-cli-projects und einen weiteren Ordner bq-releases-notes darin gestartet.
Beginnen Sie mit einem ersten Prompt. Sie können sich das als Spezifikation für Ihre Anwendung vorstellen. Sie können sie nach Belieben anpassen. Während der Sitzung mit der Antigravity CLI werden Sie aufgefordert, Berechtigungen zum Erstellen der Dateien usw. zu erteilen. Erteilen Sie die erforderlichen Berechtigungen.
Please build a web application for me using Python Flask and plain vanilla HTML, JavaScript and CSS that fetches the BigQuery Release notes from (https://docs.cloud.google.com/feeds/bigquery-release-notes.xml) and shows them to me.
A simple refresh button with a spinner is good enough, anytime I'd like to refresh the details.
I would also like the ability to take any specific update, select it and then Tweet about it.
Die folgenden Prompts und Antworten sind ein Beispiel für einen Ablauf, der so stattgefunden hat. Die Antigravity CLI erstellt einen Plan und bittet Sie um Bestätigungen / Klarstellungen oder fährt fort. Bitte folgen Sie der Anleitung. Hier ist ein Beispiel für einen Unterhaltungs-Thread:
I will start by exploring the workspace to see if there is an existing structure or if this is a brand new project.
● ListDir(/Users/romin/agy-cli-projects/bq-release-notes) (ctrl+o to expand)
I will read the BigQuery release notes XML feed to understand its structure (Atom/RSS elements, entry/item elements, namespaces, dates, titles, content) so that we can parse it
correctly in the Python Flask backend.
● ReadURL(https://docs.cloud.google.com/feeds/bigquery-release-notes.xml) (ctrl+o to expand)
I will view the fetched feed content saved locally to understand its format and structure.
● Read(/Users/romin/.gemini/antigravity-cli/brain/116191af-e6ea-4ba5-aa23-62f995bd068a/.system_generated/steps/6/content.md) (ctrl+o to expand)
▸ Thought for 2s, 2.3k tokens
Analyzing XML Feed Structure
I will write the implementation plan detailing the architecture, design aesthetic, components, and verification steps for the BigQuery Release Notes Web Application. This plan will be
written to the artifacts directory.
● Create(/Users/romin/.gemini/antigravity-cli/brain/116191af-e6ea-4ba5-aa23-62f995bd068a/implementation_plan.md) (ctrl+o to expand)
I have created the implementation_plan.md to outline the design and architecture of the BigQuery Release Notes Web Application.
Please review the plan, especially the approach for the Twitter Composer & Preview Card, and let me know if you approve or if there are any adjustments you'd like to make!
1 artifact · /artifact to review
Es ist an der Zeit, zu verstehen, was Artefakte in Antigravity sind. Über Artefakte werden wir von der Antigravity CLI über einen Implementierungsplan, eine Liste der Aufgaben, an denen gearbeitet wird, überprüfbare Ausgaben und mehr auf dem Laufenden gehalten. Diese Dateien werden generiert und enthalten Informationen zur Arbeit von Antigravity, zum Plan, zur Aufgabenliste und mehr.
Anschließend wird gesagt: „Ich habe implementation_plan.md erstellt, um das Design und die Architektur der BigQuery-Webanwendung für Versionshinweise zu skizzieren. Bitte sehen Sie sich den Plan an, insbesondere den Ansatz für die Twitter-Composer- und Vorschaukarte, und teilen Sie mir mit, ob Sie ihn genehmigen oder ob Sie Änderungen vornehmen möchten.“
Unten rechts wird auch angezeigt, dass 1 Artefakt überprüft werden muss. In diesem Fall ist es implementation_plan.md.
Geben Sie den Befehl /artifact ein. Dadurch wird das generierte Artefakt implementation_plan.md angezeigt. Mit den Pfeiltasten können Sie es öffnen, genehmigen, ablehnen usw. Drücken Sie einfach die Esc-Taste und kehren Sie zum Prompt zurück. Hier können Sie ihn genehmigen, wenn Sie möchten.
In unserem Fall verwenden wir die generierte Antwort und genehmigen sie. Dadurch werden die nächsten Schritte eingeleitet, bei denen die Implementierung gestartet wird, d.h. es werden Dateien erstellt, einige Befehle ausgeführt usw. Sie werden aufgefordert, die Ausführung zu genehmigen und die erforderlichen Berechtigungen zu erteilen.
In unserem Fall haben wir die Genehmigung erteilt, die virtuelle Python-Umgebung zu erstellen, die Abhängigkeiten über requirements.txt zu installieren usw.
Im Hintergrund wurde auch eine task.md-Datei als Teil der Aufgaben erstellt, die auf Grundlage des Implementierungsplans erledigt werden müssen. Die einzelnen Aufgaben werden abgehakt, sobald sie erledigt sind. Sobald der Vorgang abgeschlossen ist, werden Sie darüber informiert und können die Anwendung im Browser aufrufen. Das wurde für uns generiert:
Wir können jetzt aufhören. Die Idee war, zu demonstrieren und auszuprobieren, was mit einfachen Anforderungen möglich ist.
Optional: Änderungen per Push-Befehl an ein GitHub-Repository übertragen
Wenn Sie die von uns erstellte Event-Website nicht auf GitHub übertragen möchten, können Sie diesen Abschnitt ignorieren und mit dem nächsten fortfahren.
Zuerst erstellen wir eine .gitignore-Datei. Dazu können Sie die Antigravity CLI verwenden.
Create a .gitignore file for this project.
Als Nächstes geben Sie der Antigravity CLI die Anweisung, dieses Repository unter unserem GitHub-Konto zu übertragen. Dabei sollte der GitHub-Helfer (gh) verwendet werden, der auf Ihrem Computer verfügbar und konfiguriert sein sollte.
Geben Sie einen Prompt ähnlich dem folgenden ein:
Great! I would now like to push all of this to a new repository in my GitHub account. I would like to name this repository <Your-Name>-event-talks-app
Es werden eine Reihe von Befehlen ausgeführt:
- Im Folgenden wird gezeigt, wie Sie das Repository anlegen.
- Mehrere Git-Befehle : init, add, commit werden zur Verwaltung des lokalen Git-Repositorys verwendet.
- Anschließend wird das Git-Remote-Repository eingerichtet und ein Push-Befehl ausgeführt.
Wenn alles wie geplant ausgeführt wird, haben Sie jetzt ein GitHub-Repository. Sie können die Seite des GitHub-Repositorys aufrufen. Hier ein Beispiel-Screenshot:
Sie haben für dieses Projekt noch kein README.md generiert. Das ist eine gute Übung für den nächsten Abschnitt, in dem wir mit dem gerade erstellten Repository arbeiten.
Antigravity CLI für die Arbeit mit einem Code-Repository verwenden
In diesem Anwendungsfall verwenden Sie die Antigravity CLI, um mit einem Code-Repository zu arbeiten. Sie führen mehrere Aufgaben aus, darunter:
- Codebasis verstehen
- Dokumentation erstellen
- Neue Funktion implementieren
Das sollte eine gute Grundlage sein, um dann mit Ihren Repositories zu arbeiten und die Antigravity CLI als Assistent für diese entwicklerspezifischen Aufgaben zu verwenden.
Voraussetzung
Für die Aufgaben in diesem Abschnitt benötigen Sie Folgendes:
- Antigravity CLI
- Sie sollten den vorherigen Abschnitt abgeschlossen haben und den generierten Code zur Hand haben, mit dem wir einen BigQuery-Versionshinweis-Reader erstellt haben.
Verwenden Sie weiterhin die Antigravity CLI aus dem Ordner/Verzeichnis, in dem Sie die Anwendung für BigQuery-Versionshinweise generiert haben.
Probieren Sie die folgenden Prompts aus:
Codebasis verstehen
- Ich möchte dieses Projekt im Detail verstehen. Erkläre mir die wichtigsten Funktionen und unterteile sie dann in Server- und Clientseite. Nimm einen Beispielablauf und zeige mir, wie die Anfrage und Antwort funktionieren. Es wird eine neue Datei (ein Artefakt) erstellt. Sie können alle Artefakte oder bestimmte Artefakte mit dem Befehl **
/artifact** aufrufen. - Erkläre
@app.py
README-Datei generieren
- Generiere eine
README-Datei für dieses Projekt.
Neue Funktion implementieren
- Bitte implementieren Sie zwei einfache Hilfsfunktionen: einen Button „In die Zwischenablage kopieren“ auf jeder Karte und einen Button „In CSV exportieren“.
- Implementieren Sie bitte im Header einen einfachen Ein/Aus-Schalter, mit dem das Farbschema der Seite durch Überschreiben der CSS-Root-Variablen vom dunklen in den hellen Modus geändert werden kann.
Sie sollten einen Plan erhalten, den Sie genehmigen können. Nach der Genehmigung werden die Änderungen von der Antigravity-Befehlszeile vorgenommen. Testen Sie Ihre Änderungen. Wenn Fehler auftreten (was wahrscheinlich ist), bitten Sie Antigravity CLI, sie zu beheben.
Probleme auf Grundlage vorgeschlagener Funktionen generieren
Wir probieren hier etwas Interessantes aus. Sie fragen Antigravity CLI, wie die User Experience dieser Anwendung verbessert werden kann.
Probieren Sie den folgenden Prompt aus:
- Ich möchte, dass du die Anwendung aus Nutzersicht bewertest. Dazu gehören unter anderem Benutzerfreundlichkeit, Reaktionsfähigkeit und hilfreiche Meldungen. Bitte erstelle eine Liste mit Verbesserungsvorschlägen.
Als Nächstes können Sie eines der zuvor generierten Probleme auswählen und Antigravity CLI bitten, es zu bearbeiten und zu implementieren.
(Optional) Alltägliche Aufgaben
Die unten aufgeführten Anwendungsfälle sind Aufgaben, die Sie möglicherweise regelmäßig ausführen. Dazu gehören das Organisieren von Dateien in Ordnern, das Abrufen und Zusammenfassen von Inhalten aus dem Web, das Verarbeiten von Bilddateien und das Extrahieren von Inhalten daraus, das Arbeiten mit Datenbanken und vieles mehr.
Sie können sich gern alle Anwendungsfälle ansehen, die Sie interessieren.
Dateien/Ordner organisieren
Mit der Antigravity CLI können Sie die Dateien je nach Bedarf in verschiedenen Ordnern organisieren. Rufen Sie auf Ihrem Computer einen Ordner mit mehreren Dateien auf, z. B. TXT, PNG, JPG, PDF und MP4. Das ist wahrscheinlich Ihr Desktop oder Ihr Downloadordner.
Rufen Sie diesen Ordner auf und starten Sie die Antigravity CLI. Sie werden die Antigravity CLI bitten, zuerst einige Ordner zu erstellen: „Bilder“, „Dokumente“ und „Videos“. Anschließend werden Sie die Antigravity CLI bitten, die Dateien in den Ordnern zu organisieren.
Die Antigravity CLI fordert Sie häufig um Erlaubnis, bevor Befehle ausgeführt werden, insbesondere solche, die Ihr Dateisystem ändern (z. B. Dateien schreiben, verschieben oder löschen). Prüfen Sie diese Aufforderungen immer sorgfältig, bevor Sie Berechtigungen erteilen. Das ist Ihr Sicherheitsnetz.
Create the following folders "Images","Documents","Videos"
Geben Sie dann den folgenden Prompt ein:
Go through all the files in this folder and then organize them by moving all the files ending with .jpg, .jpeg, .gif into the "Images" folder. Move all ".txt" files into the "Documents" folder. Move all the ".mp4" files in the "Videos" folder.
Ein Beispiel für die Ausführung auf unserem Computer ist unten zu sehen:
I have completed organizing your files into their respective folders. Here is a summary of the files moved:
• Images: Moved 95 files ending in .jpg or .jpeg (no .gif files were present).
• Documents: Moved 1 file ending in .txt ( 12March_Live_chat_transcript.txt ).
• Videos: Moved 26 files ending in .mp4 .
Einige weitere Szenarien zum Organisieren (die Prompts sind neben dem jeweiligen Szenario angegeben):
- Zusammenfassung:Erstelle für jedes Dokument im Ordner „Documents“ eine TXT-Datei im selben Ordner mit dem Namen „summary_ORIGINAL_FILENAME.txt“, die eine Zusammenfassung der wichtigsten Punkte des Dokuments in drei Sätzen enthält.
- Nach Typ kategorisieren:Scannen Sie alle PDF- und DOCX-Dateien in diesem Verzeichnis. Verschieben Sie alle Dateien, deren Name oder Inhalt „invoice“ (Rechnung) enthält, in den Ordner „Financial/Invoices“ (Finanziell/Rechnungen). Verschieben Sie Dateien mit „receipt“ (Beleg) in den Ordner „Financial/Receipts“ (Finanziell/Belege). Alle anderen DOCX-Dateien werden in den Ordner „Reports“ (Berichte) verschoben.
- Schlüsselinformationen extrahieren (und „taggen“): Lesen Sie für jede PDF-Datei im Ordner „Finanz/Rechnungen“ den Inhalt. Wenn Sie ein Datum finden, benennen Sie die Datei so um, dass das Datum im Format JJJJ-MM-TT enthalten ist, z.B. „rechnung_2025-07-26_ursprünglicher_name.pdf“.
Artikel zusammenfassen (lokale Dateien oder Web)
Sie können die URL, das Thema und die lokalen Dateinamen in den folgenden Szenarien nach Bedarf ändern. Die angegebenen Dateinamen sind Beispieldateinamen. Sie können sie durch Dateinamen von Dateien ersetzen, die sich auf Ihrem System befinden.
Probieren Sie eines der folgenden Szenarien aus (die Prompts sind neben dem jeweiligen Szenario angegeben):
- Webartikel zusammenfassen (einzelne URL): Rufe https://medium.com/google-cloud/antigravity-cli-tutorial-series-12b46cfe3bf2 auf und fasse die drei wichtigsten Punkte dieses Nachrichtenartikels zusammen.
- Mehrere Webartikel zusammenfassen (z.B. aus einer Suche): Suche mit Google nach den neuesten Nachrichtenartikeln zum Thema „Antigravity CLI“. Fasse die fünf wichtigsten relevanten Artikel jeweils in zwei bis drei Sätzen zusammen und liste ihre URLs auf.
- Lokale Textdatei zusammenfassen:Fasse die wichtigsten Punkte des Artikels in „my_research_paper.txt“ zusammen. Konzentriere dich dabei auf die Methodik und die Schlussfolgerungen.
- Lokales PDF zusammenfassen:Lies „financial_report_Q2_2025.pdf“. Fasse die finanzielle Leistung und die wichtigsten Herausforderungen zusammen.
Spezifische Informationen extrahieren (lokale Dateien oder Web)
Sie können die URL, das Thema und die lokalen Dateinamen in den folgenden Szenarien nach Bedarf ändern. Die angegebenen Dateinamen sind Beispieldateinamen. Sie können sie durch Dateinamen von Dateien ersetzen, die sich auf Ihrem System befinden.
Probieren Sie eines der folgenden Szenarien aus (die Prompts sind neben dem jeweiligen Szenario angegeben):
- Entitäten aus einem lokalen Artikel extrahieren:Liste alle benannten Personen und die zugehörigen wichtigen Daten aus „biography.txt“ auf.
- Daten aus einer Tabelle in einem PDF extrahieren:Extrahiere aus „quarterly_sales.pdf“ die Daten aus der Tabelle auf Seite 3, in der „Product Sales by Region“ (Produktumsatz nach Region) aufgeführt ist, und stelle sie in einer Markdown-Tabelle dar.
- Nachrichtenüberschriften und ‑quellen von einer Nachrichtenwebsite extrahieren:Rufen Sie „https://news.google.com/“ (oder eine ähnliche Nachrichtenseite) auf. Extrahieren Sie die wichtigsten Schlagzeilen von der Titelseite und die entsprechenden Nachrichtenquellen. Stelle sie als Aufzählungsliste dar.
- Produktspezifikationen von einer E-Commerce-Seite abrufen:Rufen Sie „https://www.amazon.in/Google-Cloud-Certified-Associate-Engineer/dp/1119871441“ auf (Beispiel für ein Buch). Extrahieren Sie den Buchtitel, den Autor und andere Details. Stellen Sie diese in einem strukturierten JSON-Format dar.
- Extrahieren Sie die Dauer eines Videos in einem bestimmten Format (z. B. „2h37m42s“).
Fragen basierend auf Inhalten beantworten (RAG-ähnliches Verhalten)
Sie können die URL, das Thema und die lokalen Dateinamen in den folgenden Szenarien nach Bedarf ändern. Die angegebenen Dateinamen sind Beispieldateinamen. Sie können sie durch Dateinamen von Dateien ersetzen, die sich auf Ihrem System befinden.
Probieren Sie eines der folgenden Szenarien aus (die Prompts sind neben dem jeweiligen Szenario angegeben):
- Fragen und Antworten zu einem lokalen Dokument:Ich hänge die Datei „user_manual.pdf“ an. Wie kann ich Probleme mit der Netzwerkverbindung beheben?
- Fragen und Antworten auf einer Webseite:Was sind laut WHO die primären Gesundheitsrisiken, die mit dem Klimawandel verbunden sind, wenn man die Inhalte von „https://www.who.int/news-room/fact-sheets/detail/climate-change-and-health“ zugrunde legt?
- Informationen aus mehreren Quellen vergleichen:Ich habe zwei Nachrichtenartikel: „article1.txt“ und „article2.txt“. Beide befassen sich mit den jüngsten Änderungen der Wirtschaftspolitik. Vergleichen und stellen Sie ihre Ansichten zu den potenziellen Auswirkungen auf kleine Unternehmen gegenüber.
Inhaltsgenerierung basierend auf extrahierten Informationen
Sie können die URL, das Thema und die lokalen Dateinamen in den folgenden Szenarien nach Bedarf ändern.
Probieren Sie eines der folgenden Szenarien aus (die Prompts sind neben dem jeweiligen Szenario angegeben):
- Kurzfassung eines Artikels erstellen:Lies @tech_innovation_article.txt. Schreibe eine kurze, ansprechende Meldung (ca. 150 Wörter) für einen Unternehmensnewsletter, in der die neue Technologie und ihr Potenzial hervorgehoben werden.
- E-Mail mit einer Zusammenfassung eines Besprechungstranskripts entwerfen: Hier ist eine Datei mit einem Besprechungstranskript: @meeting_transcript.txt. Entwirf eine E-Mail an das Team, in der die wichtigsten getroffenen Entscheidungen und zugewiesenen Aufgaben zusammengefasst werden. Gib auch an, wer für die einzelnen Aufgaben verantwortlich ist.
Multimodale Unterstützung für die Antigravity CLI
Die Antigravity CLI unterstützt mehrere Modelle über Gemini. Sie können sie bitten, Dateien mit unterschiedlichen Inhaltsformaten gemäß Ihren Anforderungen zu verarbeiten.
Sie werden eine Reihe von Rechnungsbildern mit der Antigravity CLI verarbeiten und wichtige Informationen daraus extrahieren. Gehen Sie dazu so vor:
- Erstellen Sie einen Ordner auf Ihrem Computer und laden Sie einige Rechnungen aus dem folgenden GitHub-Repository herunter.
- Antigravity CLI aus diesem Ordner starten
Geben Sie den folgenden Prompt ein, um Informationen aus den Rechnungen in Form einer Tabelle zu extrahieren.
The current folder contains a list of invoice files in Image format. Go through all the files in this folder and extract the following invoice information in the form of a table: Invoice No, Invoice Date, Invoice Sent By, Due Date, Due Amount.
Die Ausgabe sollte idealerweise so aussehen:
Hier ist ein weiteres Szenario, in dem Sie zusätzliche abgeleitete Spalten anfordern können. Angenommen, Sie möchten für alle Fälligkeitsdaten von Rechnungen, die in der Vergangenheit liegen, ein rotes Kreuz-Emoji anzeigen. Sie können einen Prompt so eingeben:
list all files with .png extension in this folder. Extract the invoice information from it by reading them locally and display it in a table format containing the following column headers: : Invoice No, Invoice Date, Invoice Sent By, Due Date, Due Amount. Add a column at the end of the table that shows a red cross emoji in case the due date is in the past.
Dies führt zu folgender Ausgabe:
Wenden Sie dies auf alle Ihre eigenen Dateien an, die nicht im Textformat vorliegen.
Antigravity-Befehlszeile zum Generieren von Daten verwenden
Sie können die Antigravity CLI auffordern, Daten in verschiedenen Datenformaten zu generieren. Das kann von Inhalten bis hin zu JSON-Daten reichen, die Sie möglicherweise simulieren müssen. Wir konzentrieren uns hier auf Szenarien, die für Entwickler/Tester relevant sind.
Hier sind einige Prompts, die Sie ausprobieren können:
JSON-Daten von Beispielkundenrezensionen generieren
Generate a JSON array of 3 synthetic customer reviews for a new smartphone. Each review should have 'reviewId' (string, UUID-like), 'productId' (string, e.g., 'SMARTPHONE_X'), 'rating' (integer, 1-5), 'reviewText' (string, 20-50 words), and 'reviewDate' (string, YYYY-MM-DD format).
Mock-API-Antworten (JSON) generieren
Generate a JSON array representing 7 daily sales records for a mock API endpoint. Each record should include 'date' (YYYY-MM-DD, chronologically increasing), 'revenue' (float, between 5000.00 and 20000.00), 'unitsSold' (integer, between 100 and 500), and 'region' (string, either 'North', 'South', 'East', 'West').
Beispielhafte SQL-Anweisungen zum Einfügen von Daten in Datenbanken generieren
Generate 5 SQL INSERT statements for a table named 'users' with columns: 'id' (INTEGER, primary key), 'username' (VARCHAR(50), unique), 'email' (VARCHAR(100)), 'password_hash' (VARCHAR(255)), 'created_at' (DATETIME, current timestamp). Ensure the password_hash is a placeholder string like 'hashed_password_X'.
CSV-Daten zum Laden/Analysieren von Daten generieren
Generate 10 lines of CSV data, including a header row, for customer transactions. Columns should be: 'TransactionID' (unique string), 'CustomerID' (integer), 'ItemPurchased' (string, e.g., 'Laptop', 'Monitor', 'Keyboard'), 'Quantity' (integer, 1-3), 'UnitPrice' (float, between 100.00 and 1500.00), 'TransactionDate' (YYYY-MM-DD).
Konfigurationsdatei (YAML) generieren
Generate a sample YAML configuration for a 'user_service'. Include sections for 'database' with 'host', 'port', 'username', 'password', 'database_name'. Also include a 'api_keys' section with 'payment_gateway' and 'email_service' placeholders. Use realistic default values.
Testdaten für Grenzfälle/Validierung generieren
Generate a JSON array of 8 email addresses for testing purposes. Include a mix of: 2 valid standard emails, 2 with missing '@', 2 with invalid domains (e.g., '.com1'), and 2 with special characters in the local part that are usually invalid (e.g., spaces or multiple dots).
9. Glückwunsch
Sie haben die Antigravity CLI und ihre Funktionen kennengelernt und sie in einigen Anwendungsfällen eingesetzt.