Pierwsze kroki z Google Antigravity

1. Wprowadzenie

W tym module dowiesz się więcej o Google Antigravity (w dalszej części dokumentu określanej jako Antigravity), opartej na agentach platformie dla programistów, która wprowadza środowisko IDE w erę agentów.

W przeciwieństwie do standardowych asystentów kodowania, którzy tylko uzupełniają wiersze, Antigravity zapewnia „centrum dowodzenia” do zarządzania autonomicznymi agentami, którzy mogą planować, kodować, a nawet przeglądać internet, aby pomóc Ci w tworzeniu.

Antigravity to platforma zaprojektowana z myślą o agentach. Zakłada ona, że AI to nie tylko narzędzie do pisania kodu, ale autonomiczny podmiot zdolny do planowania, wykonywania, weryfikowania i powtarzania złożonych zadań inżynieryjnych przy minimalnej ingerencji człowieka.

Czego się nauczysz

Instalowanie i konfigurowanie Antigravity.
Poznaj kluczowe pojęcia związane z Antigravity, takie jak Menedżer agentów, Edytor, Przeglądarka i inne.
Dostosowywanie Antigravity za pomocą własnych reguł i przepływu pracy oraz kwestie związane z bezpieczeństwem.

Czego potrzebujesz

Obecnie Antigravity jest dostępna w wersji przedpremierowej na osobistych kontach Gmail. Zawiera bezpłatny limit wykorzystania modeli najwyższej jakości.

Antigravity musi być zainstalowana lokalnie w systemie. Produkt jest dostępny na komputerach Mac, Windows i wybranych dystrybucjach Linuksa. Oprócz własnego urządzenia potrzebujesz:

przeglądarki Chrome,
konto Gmail (osobiste konto Gmail);

Te warsztaty są przeznaczone dla użytkowników i deweloperów na wszystkich poziomach zaawansowania (w tym dla początkujących).

Problemy z raportowaniem

Podczas pracy z tym przewodnikiem i Antigravity możesz napotkać problemy.

Jeśli masz problemy z ćwiczeniem (literówki, nieprawidłowe instrukcje), zgłoś błąd, klikając przycisk Report a mistake w lewym dolnym rogu tego ćwiczenia:

Jeśli chcesz zgłosić błąd lub zaproponować funkcję związaną z Antigravity, zgłoś problem w Antigravity. Możesz to zrobić w Menedżerze agentów, klikając link Provide Feedback w lewym dolnym rogu:

Możesz też otworzyć edytor, klikając link Report Issue pod ikoną profilu:

2. Instalacja

Jeśli nie masz jeszcze zainstalowanej aplikacji Antigravity, zacznij od jej instalacji. Obecnie produkt jest dostępny w wersji podglądowej i możesz zacząć z niego korzystać na osobistym koncie Gmail.

Otwórz stronę pobrań i kliknij odpowiednią wersję systemu operacyjnego. Uruchom instalator aplikacji i zainstaluj ją na komputerze. Po zakończeniu instalacji uruchom aplikację Antigravity. Powinien pojawić się ekran podobny do tego:

Za każdym razem kliknij Next. Główne etapy znajdziesz poniżej:

Wybierz proces konfiguracji: pojawi się opcja importowania ustawień z dotychczasowych ustawień VS Code lub Cursor. Zaczniemy od nowa.
Wybierz typ motywu edytora: my wybierzemy ciemny motyw, ale to zależy od Ciebie.
Jak chcesz używać agenta Antigravity?

Przyjrzyjmy się temu bliżej. Pamiętaj, że ustawienia można w każdej chwili zmienić w Ustawieniach użytkownika Antigravity (Cmd + ,).

Zanim przejdziemy do opcji, przyjrzyjmy się konkretnym właściwościom (widocznym po prawej stronie okna).

Zasady wykonywania w terminalu

Chodzi o to, aby agent mógł wykonywać polecenia (aplikacje/narzędzia) w Twoim terminalu:

Zawsze kontynuuj: zawsze automatycznie wykonuj polecenia terminala (z wyjątkiem tych, które znajdują się na konfigurowalnej liście odmowy).
Poproś o sprawdzenie: poproś użytkownika o sprawdzenie i zatwierdzenie przed wykonaniem poleceń terminala.

Zasady dotyczące opinii

Podczas wykonywania zadania Agent tworzy różne artefakty (plan zadania, plan wdrożenia itp.). Zasady sprawdzania są ustawione tak, aby można było określić, kto decyduje o tym, czy należy je sprawdzić. Czy zawsze chcesz ją sprawdzać, czy chcesz pozostawić decyzję agentowi. Dostępne są 3 opcje:

Zawsze kontynuuj: agent nigdy nie prosi o sprawdzenie.
Decyzja agenta: agent zdecyduje, kiedy poprosić o opinię.
Prośba o sprawdzenie: agent zawsze prosi o sprawdzenie.

Zasady wykonywania JavaScriptu

Po włączeniu agent może używać narzędzi przeglądarki do otwierania adresów URL, czytania stron internetowych i korzystania z zawartości przeglądarki. Ta zasada określa, jak kod JavaScript jest wykonywany w przeglądarce.

Zawsze kontynuuj: agent nie będzie prosić o zezwolenie na uruchomienie JavaScriptu w przeglądarce. Zapewnia to agentowi maksymalną autonomię w zakresie wykonywania złożonych działań i weryfikacji w przeglądarce, ale też największe ryzyko wykorzystania luk w zabezpieczeniach.
Prośba o sprawdzenie: agent zawsze zatrzyma się, aby poprosić o zgodę na uruchomienie kodu JavaScript w przeglądarce.
Wyłączone: agent nigdy nie będzie uruchamiać kodu JavaScript w przeglądarce.

Po zapoznaniu się z różnymi zasadami 4 opcje po lewej stronie to nic innego jak konkretne ustawienia zasad wykonywania, sprawdzania i wykonywania JavaScriptu w przypadku 3 z nich oraz 4 opcja, w której możemy w pełni dostosować te ustawienia. Te 4 opcje są dostępne, abyśmy mogli wybrać, ile autonomii chcesz przyznać agentowi w zakresie wykonywania poleceń w terminalu i sprawdzania artefaktów przed przejściem do kolejnego etapu zadania.

Dostępne są te 4 opcje:

Tryb bezpieczny: tryb bezpieczny zapewnia ulepszone mechanizmy kontroli bezpieczeństwa agenta, umożliwiając ograniczenie jego dostępu do zasobów zewnętrznych i operacji wrażliwych. Gdy włączony jest tryb bezpieczny, w celu ochrony środowiska stosuje się kilka środków bezpieczeństwa.
Rozwój oparty na weryfikacji (zalecany): agent będzie często prosić o weryfikację.
Rozwój oparty na agentach: agent nigdy nie poprosi o sprawdzenie.
Konfiguracja niestandardowa

Opcja Rozwój oparty na weryfikacji zapewnia dobrą równowagę i jest zalecana, ponieważ umożliwia agentowi podjęcie decyzji i wrócenie do użytkownika w celu uzyskania zatwierdzenia.

Następna jest strona ustawień Skonfiguruj edytor, na której możesz wybrać preferowane ustawienia:

Powiązania klawiszy: skonfiguruj powiązania klawiszy.
Rozszerzenia: zainstaluj popularne rozszerzenia językowe i inne polecane rozszerzenia.
Wiersz poleceń: zainstaluj narzędzie wiersza poleceń, aby otworzyć Antigravity za pomocą polecenia agy.

Możesz teraz zalogować się w Google. Jak wspomnieliśmy wcześniej, Antigravity jest dostępna w wersji przedpremierowej i bezpłatna, jeśli masz osobiste konto Gmail. Zaloguj się teraz na swoje konto. Otworzy się przeglądarka, w której możesz się zalogować. Po pomyślnym uwierzytelnieniu zobaczysz komunikat podobny do tego poniżej, który przekieruje Cię z powrotem do aplikacji Antigravity. Płynąć z prądem.

Na koniec Warunki korzystania z usługi. Możesz zdecydować, czy chcesz się zarejestrować, a potem kliknąć Next.

Doprowadzi Cię to do momentu prawdy, w którym Antigravity będzie czekać na współpracę z Tobą.

3. Menedżer agentów

Zaczynamy!

Antigravity korzysta z otwartego kodu źródłowego Visual Studio Code (VS Code), ale radykalnie zmienia interfejs użytkownika, aby priorytetem było zarządzanie agentami, a nie edycja tekstu. Interfejs jest podzielony na 2 główne okna: Editor i Agent Manager. Ten podział obowiązków odzwierciedla różnicę między indywidualnym wkładem a zarządzaniem inżynieryjnym.

Menedżer agentów: Centrum dowodzenia

Po uruchomieniu Antigravity użytkownik zwykle nie widzi drzewa plików, ale Menedżera agentów, jak pokazano poniżej:

Ten interfejs działa jak Mission Control panel. Został on zaprojektowany do orkiestracji na wysokim poziomie, umożliwiając programistom tworzenie, monitorowanie i obsługiwanie wielu agentów działających asynchronicznie w różnych obszarach roboczych lub zadaniach.

W tym przypadku deweloper pełni rolę architekta. Określają one cele ogólne, np.:

Przebuduj moduł uwierzytelniania
Aktualizowanie drzewa zależności
Generowanie pakietu testów dla interfejsu Billing API

Jak widać na powyższym diagramie, każde z tych żądań powoduje utworzenie dedykowanego wystąpienia agenta. Interfejs użytkownika wizualizuje te równoległe ścieżki pracy, wyświetlając stan każdego agenta, artefakty, które wygenerował (plany, wyniki, różnice), oraz wszelkie oczekujące żądania zatwierdzenia przez człowieka.

Ta architektura rozwiązuje kluczowe ograniczenie poprzednich IDE, które bardziej przypominały chatbota i działały w sposób liniowy i synchroniczny. W tradycyjnym interfejsie czatu deweloper musi poczekać, aż AI zakończy generowanie kodu, zanim zada kolejne pytanie. W widoku menedżera w Antigravity deweloper może wysłać 5 różnych agentów do pracy nad 5 różnymi błędami jednocześnie, co skutecznie zwiększa przepustowość.

Jeśli klikniesz Next powyżej, możesz otworzyć przestrzeń roboczą.

Pomyśl o obszarze roboczym tak, jak znasz go z VS Code. Możemy otworzyć folder lokalny, klikając przycisk, a następnie wybierając folder, od którego chcemy zacząć. W moim przypadku w folderze domowym znajdował się folder o nazwie my-agy-projects, który wybrałem. Możesz użyć zupełnie innego folderu. Uwaga: jeśli chcesz, możesz całkowicie pominąć ten krok. Obszar roboczy możesz otworzyć w dowolnym momencie.

Po wykonaniu tego kroku otworzy się okno Menedżera agentów, które wygląda tak:

Zauważysz, że aplikacja jest od razu gotowa do rozpoczęcia nowej rozmowy w wybranym folderze obszaru roboczego (my-agy-projects). Możesz wykorzystać swoją wiedzę o korzystaniu z innych aplikacji AI (Cursor, interfejs wiersza poleceń Gemini) i używać @ oraz innych sposobów, aby uwzględniać dodatkowy kontekst podczas tworzenia promptów.

Sprawdź menu Planning i Model Selection. Menu wyboru modelu umożliwia wybranie jednego z aktualnie dostępnych modeli, z którego będzie korzystać Twój agent. Lista jest widoczna poniżej:

Podobnie agent będzie działać w domyślnym trybie Planning. Możemy też wybrać tryb Fast.

Zobaczmy, co na ten temat mówi dokumentacja:

Planning: agent może planować przed wykonaniem zadań. Używaj go do szczegółowych badań, złożonych zadań lub pracy zespołowej. W tym trybie agent organizuje swoją pracę w grupach zadań, tworzy artefakty i podejmuje inne działania, aby dokładnie zbadać, przemyśleć i zaplanować swoją pracę w celu uzyskania optymalnej jakości. Zobaczysz tu znacznie więcej danych wyjściowych.
Fast: agent będzie wykonywać zadania bezpośrednio. Używaj go do prostych zadań, które można wykonać szybciej, takich jak zmiana nazwy zmiennych, uruchamianie kilku poleceń bash lub inne mniejsze, lokalne zadania. Jest to przydatne, gdy szybkość jest ważnym czynnikiem, a zadanie jest wystarczająco proste, aby nie martwić się o pogorszenie jakości.

Jeśli znasz pojęcie budżetu na myślenie i podobne terminy w kontekście agentów, pomyśl o tym jako o możliwości kontrolowania procesu myślowego agenta, co ma bezpośredni wpływ na budżet na myślenie. Na razie pozostawimy ustawienia domyślne, ale pamiętaj, że w momencie wprowadzenia na rynek model Gemini 3 Pro będzie dostępny dla wszystkich w ramach limitowanych kwot. Możesz więc spodziewać się odpowiednich komunikatów informujących o wyczerpaniu tych bezpłatnych kwot na korzystanie z Gemini 3.

Poświęćmy teraz trochę czasu na omówienie Menedżera agentów (okna) i wyjaśnienie kilku kwestii, aby poznać podstawowe elementy składowe, sposób poruszania się w Antigravity i inne informacje. Poniżej znajduje się okno Menedżera agentów:

Zapoznaj się z powyższym diagramem z numerami:

Inbox: dzięki temu możesz śledzić wszystkie rozmowy w jednym miejscu. Gdy wyślesz agentów do wykonania zadań, pojawią się one w skrzynce odbiorczej. Możesz kliknąć skrzynkę odbiorczą, aby wyświetlić listę wszystkich bieżących rozmów. Kliknięcie dowolnej rozmowy spowoduje wyświetlenie wszystkich wymienionych wiadomości, stanu zadań, tego, co przygotował agent, a nawet informacji o tym, czy zadania czekają na Twoją akceptację. To świetny sposób, aby później wrócić do poprzedniego zadania, nad którym pracujesz. Bardzo przydatna funkcja.
Start Conversation: kliknij ten przycisk, aby rozpocząć nową rozmowę. Spowoduje to przejście bezpośrednio do pola, w którym widnieje symbol Ask anything.
Workspaces: wspomnieliśmy o obszarach roboczych i o tym, że możesz pracować w dowolnym obszarze roboczym. W każdej chwili możesz dodać więcej obszarów roboczych i wybrać dowolny z nich podczas rozpoczynania rozmowy.
Playground: to świetny sposób na rozpoczęcie rozmowy z agentem. Jeśli chcesz przekształcić ją w przestrzeń roboczą, w której masz większą kontrolę nad plikami itp., możesz to zrobić. Pomyśl o tym jak o obszarze roboczym.
Editor View: Jesteśmy w widoku Menedżera agentów. W dowolnym momencie możesz przełączyć się na widok edytora. Wyświetli się folder obszaru roboczego i wszystkie wygenerowane pliki. Możesz bezpośrednio edytować pliki lub nawet podać wskazówki w edytorze, aby Agent mógł coś zrobić lub zmienić zgodnie z Twoimi zmodyfikowanymi rekomendacjami lub instrukcjami. Widok edytora omówimy szczegółowo w dalszej części.
Browser: Wreszcie dochodzimy do jednego z najważniejszych wyróżników, który sprawia, że Antigravity jest bardzo potężnym narzędziem. Jest to ścisła integracja z przeglądarką Chrome. W następnej sekcji skonfigurujemy przeglądarkę.

4. Antigravity Browser

Zgodnie z dokumentacją, gdy agent chce wejść w interakcję z przeglądarką, wywołuje subagenta przeglądarki, aby wykonać bieżące zadanie. Podagent przeglądarki uruchamia model wyspecjalizowany w obsłudze stron otwartych w przeglądarce zarządzanej przez Antigravity, który różni się od modelu wybranego dla głównego agenta.

Ten podagent ma dostęp do różnych narzędzi niezbędnych do sterowania przeglądarką, w tym do klikania, przewijania, pisania, odczytywania dzienników konsoli i innych. Może też odczytywać otwarte strony za pomocą przechwytywania DOM, zrzutów ekranu lub analizowania Markdowna, a także nagrywać filmy.

Oznacza to, że musimy uruchomić i zainstalować rozszerzenie przeglądarki Antigravity. Zrobimy to, rozpoczynając rozmowę w Playground i wykonując kolejne kroki.

Kliknij Playground i przypisz agentowi to zadanie go to antigravity.google, jak pokazano poniżej:

Prześlij zadanie. Zobaczysz, jak agent analizuje zadanie, i będziesz mieć wgląd w jego proces myślowy. W pewnym momencie proces zostanie prawidłowo przeprowadzony i wyświetli się informacja o konieczności skonfigurowania agenta przeglądarki, jak pokazano poniżej. Kliknij Setup.

Spowoduje to otwarcie przeglądarki i wyświetlenie komunikatu o konieczności zainstalowania rozszerzenia, jak pokazano poniżej:

Następnie przejdziesz do rozszerzenia Chrome, które możesz zainstalować.

Po zainstalowaniu rozszerzenia Antigravity Agent zacznie działać i poinformuje, że oczekuje od Ciebie zezwolenia na wykonanie zadania. W otwartym oknie przeglądarki powinna być widoczna aktywność:

Wróć do widoku Menedżera agentów. Powinny być widoczne te informacje:

Tego właśnie oczekiwaliśmy, ponieważ poprosiliśmy Agenta o odwiedzenie witryny antigravity.google. Przyznaj mu uprawnienia, a zobaczysz, że witryna została bezpiecznie otwarta (jak pokazano poniżej):

5. Artefakty

Antigravity tworzy artefakty podczas planowania i wykonywania pracy, aby komunikować się z użytkownikiem i otrzymywać od niego opinie. Są to pliki Markdown z formatowaniem, diagramy architektury, obrazy, nagrania z przeglądarki, różnice w kodzie itp.

Artefakty rozwiązują problem „braku zaufania”. Gdy agent zgłasza „Błąd został naprawiony”, deweloper musi wcześniej przeczytać kod, aby to sprawdzić. W przypadku Antygrawitacji agent tworzy artefakt, aby to udowodnić.

Oto główne artefakty generowane przez Antigravity:

Task Lists: przed napisaniem kodu agent generuje plan strukturalny. Zwykle nie musisz edytować tego planu, ale możesz go sprawdzić i w razie potrzeby dodać komentarz, aby go zmienić.
Implementation Plan: służy do projektowania zmian w bazie kodu w celu wykonania zadania. Plany te zawierają szczegóły techniczne dotyczące niezbędnych zmian i są przeznaczone do sprawdzenia przez użytkownika, chyba że zasady sprawdzania artefaktów są ustawione na „Zawsze kontynuuj”.
Walkthrough: jest tworzony po zakończeniu przez agenta wdrażania zadania jako podsumowanie zmian i sposobu ich testowania.
Code diffs: Chociaż nie jest to artefakt, Antigravity generuje też różnice w kodzie, które możesz sprawdzić i skomentować.
Screenshots: agent rejestruje stan interfejsu przed zmianą i po niej.
Browser Recordings: w przypadku interakcji dynamicznych (np. „Kliknij przycisk logowania, poczekaj na spinner, sprawdź, czy panel się wczytał”), agent nagrywa film z sesji. Deweloper może obejrzeć ten film, aby sprawdzić, czy wymaganie funkcjonalne zostało spełnione, bez konieczności uruchamiania aplikacji.

Artefakty są generowane i wyświetlane w widokach Menedżera agentów i Edytora.

W widoku Edytor w prawym dolnym rogu możesz kliknąć Artifacts:

W widoku Menedżer agentów w prawym górnym rogu obok ikony Review changes powinien być widoczny przycisk do przełączania artefaktów. Jeśli jest włączony, możesz zobaczyć listę wygenerowanych artefaktów:

Powinien pojawić się widok artefaktów, jak pokazano poniżej. W tym przypadku agent otrzymał instrukcję, aby odwiedzić stronę antigravity.google, dlatego zrobił zrzut ekranu i utworzył film:

Różnice w kodzie możesz zobaczyć w Review Changes w widoku edytora:

Deweloperzy mogą wchodzić w interakcje z tymi artefaktami i różnicami w kodzie za pomocą „komentarzy w stylu Dokumentów Google”. Możesz wybrać konkretne działanie lub zadanie, podać polecenie w odpowiedni sposób, a następnie przesłać je do agenta. Agent przetworzy te opinie i odpowiednio je wykorzysta. Zastanów się nad użyciem interaktywnych Dokumentów Google, w których możesz przekazywać autorowi informacje zwrotne, a on może je uwzględniać.

6. Ponowne otwarcie skrzynki odbiorczej

Jeśli masz już kilka rozmów z agentami, sprawdź teraz Inbox w oknie Agent Manager. Wyświetlą się wszystkie rozmowy. Kliknij dowolną rozmowę, aby zobaczyć jej historię, wygenerowane artefakty i inne informacje. W naszym przypadku po przeprowadzeniu pierwszej rozmowy w skrzynce odbiorczej pojawi się wątek, jak pokazano poniżej:

Kliknięcie tej rozmowy spowoduje wyświetlenie szczegółów:

Możesz też kontynuować rozmowę w tym miejscu.

7. Edytor

Edytor zachowuje znajomy interfejs VS Code, dzięki czemu doświadczeni deweloperzy mogą korzystać z wypracowanych nawyków. Obejmuje standardowy eksplorator plików, wyróżnianie składni i ekosystem rozszerzeń.

Aby przejść do edytora, w prawym górnym rogu Menedżera agentów kliknij przycisk Open Editor.

Konfiguracja i rozszerzenia

W typowym przypadku widoczne są edytor, terminal i agent:

Jeśli tak nie jest, możesz przełączać panele terminala i agenta w ten sposób:

Aby przełączać panel terminala, użyj skrótu Ctrl + `.
Aby przełączać panel agenta, użyj skrótu Cmd + L.

Antigravity może zainstalować niektóre rozszerzenia podczas konfiguracji, ale w zależności od używanego języka programowania prawdopodobnie trzeba będzie zainstalować więcej rozszerzeń. Na przykład w przypadku programowania w Pythonie możesz zainstalować te rozszerzenia:

Edytor

Autouzupełnianie

Podczas pisania kodu w edytorze włącza się inteligentne autouzupełnianie, które możesz po prostu włączyć za pomocą klawisza Tab:

Aby zaimportować, naciśnij Tab

Otrzymasz sugestię karty do importowania, aby dodać brakujące zależności:

Skakanie za pomocą klawisza Tab

Otrzymujesz sugestie przejścia za pomocą klawisza Tab, które przenoszą kursor do następnego logicznego miejsca w kodzie:

Polecenia

Możesz wywoływać polecenia za pomocą znaku Cmd + I w edytorze lub terminalu, aby uzyskać uzupełnienia w tekście w języku naturalnym.

W edytorze możesz poprosić o metodę obliczania liczb Fibonacciego, a następnie ją zaakceptować lub odrzucić:

W terminalu możesz uzyskać sugestie dotyczące poleceń:

Panel boczny agenta

W edytorze możesz włączać i wyłączać panel boczny agenta na kilka sposobów.

Otwieranie ręczne

Panel pracownika obsługi klienta po prawej stronie możesz włączać i wyłączać ręcznie za pomocą skrótu Cmd + L.

Możesz zacząć zadawać pytania, używać @, aby dodać więcej kontekstu, np. pliki, katalogi, serwery MCP, lub używać /, aby odwoływać się do przepływu pracy (zapisanego prompta):

Możesz też wybrać jeden z 2 trybów rozmowy: Fast lub Planning :

Fast jest zalecany w przypadku szybkich zadań, a Planning – w przypadku bardziej złożonych zadań, w których agent tworzy plan, który możesz zatwierdzić.

Możesz też wybrać różne modele rozmowy:

Wyjaśnij i popraw

Innym sposobem wywołania agenta jest najechanie kursorem na problem i kliknięcie Explain and fix:

Wysyłanie problemów do agenta

Możesz też przejść do sekcji Problems i kliknąć Send all to Agent, aby poprosić agenta o rozwiązanie tych problemów:

Wysyłanie danych wyjściowych terminala do agenta

Możesz nawet wybrać część danych wyjściowych terminala i wysłać ją do agenta za pomocą Cmd + L:

Przełączanie się między edytorem a menedżerem agentów

W dowolnym momencie możesz przełączać się między trybem edytora a trybem pełnego menedżera agentów. W trybie edytora kliknij przycisk Open Agent Manager w prawym górnym rogu, a w trybie menedżera agentów kliknij przycisk Open Editor w prawym górnym rogu.

Możesz też użyć skrótu klawiszowego Cmd + E, aby przełączać się między tymi dwoma trybami.

8. Prześlij opinię

Podstawą Antigravity jest możliwość łatwego zbierania opinii na każdym etapie korzystania z usługi. Podczas wykonywania zadania agent tworzy różne artefakty:

Plan wdrożenia i lista zadań (przed kodowaniem)
Różnice w kodzie (podczas generowania kodu)
Sprawdzanie wyników (po zakodowaniu)

Te artefakty to sposób, w jaki Antigravity komunikuje swoje plany i postępy. Co ważniejsze, możesz też przekazywać agentowi informacje zwrotne w formie komentarzy w Dokumentach Google. Jest to bardzo przydatne, aby skutecznie kierować agentem w wybranym przez siebie kierunku.

Spróbujmy stworzyć prostą aplikację z listą zadań do wykonania i zobaczmy, jak po drodze możemy przekazywać opinie zespołowi Antigravity.

Tryb planowania

Najpierw upewnij się, że Antigravity jest w trybie Planning (zamiast Fast).Możesz to zrobić w czacie w panelu bocznym agenta. Dzięki temu zespół Antigravity przed rozpoczęciem kodowania tworzy plan wdrożenia i listę zadań. Następnie wypróbuj prompta, np. Create a todo list web app using Python. Spowoduje to rozpoczęcie planowania przez agenta i utworzenie planu wdrożenia.

Plan wdrożenia

Plan wdrożenia to ogólny opis działań, które Antigravity zamierza podjąć, stosu technologicznego, którego będzie używać, oraz proponowanych zmian.

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

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

To także pierwsze miejsce, w którym możesz przesłać opinię. W naszym przypadku agent chce używać Flask jako platformy internetowej w języku Python. Możemy dodać do planu wdrożenia komentarz, aby zamiast tego użyć FastAPI. Po dodaniu komentarza prześlij go lub poproś Antigravity o Proceed z aktualnym planem wdrożenia.

Lista zadań

Po zaktualizowaniu planu wdrożenia Antigravity tworzy listę zadań. To konkretna lista czynności, które Antigravity wykona, aby utworzyć i zweryfikować aplikację.

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

To drugie miejsce, w którym możesz przesłać opinię.

W naszym przypadku możesz dodać bardziej szczegółowe instrukcje weryfikacji, dodając ten komentarz: Verify application by adding, editing, and deleting a todo item and taking a screenshot.

Zmiany w kodzie

W tym momencie Antigravity wygeneruje kod w nowych plikach. Możesz Accept all lub Reject all te zmiany w panelu bocznym czatu z agentem bez zagłębiania się w szczegóły.

Możesz też kliknąć Review changes, aby wyświetlić szczegóły zmian i dodać szczegółowe komentarze do kodu. Na przykład w main.py możemy dodać ten komentarz: Add basic comments to all methods

To świetny sposób na iteracyjne tworzenie kodu za pomocą Antigravity.

Przewodnik

Gdy Antigravity skończy kodowanie, uruchomi serwer i otworzy przeglądarkę, aby zweryfikować aplikację. Przeprowadzi testy ręczne, takie jak dodawanie i aktualizowanie zadań. Wszystko to dzięki rozszerzeniu przeglądarki Antigravity. Na koniec tworzy plik z instrukcjami, który podsumowuje działania podjęte w celu zweryfikowania aplikacji. Zawiera on zrzut ekranu lub proces weryfikacji z nagraniem z przeglądarki.

Możesz też skomentować zrzut ekranu lub nagranie z przeglądarki w przewodniku. Możemy na przykład dodać komentarz Change the blue theme to orange theme i przesłać go. Po przesłaniu komentarza zespół Antigravity wprowadza zmiany, weryfikuje wyniki i aktualizuje przewodnik.

Cofanie zmian

Na koniec, jeśli po wykonaniu danego kroku nie jesteś zadowolony(-a) ze zmiany, możesz ją cofnąć w czacie. Wystarczy, że w czacie wybierzesz ↩️ Undo changes up to this point.

9. Reguły i przepływy pracy

Antigravity ma kilka opcji dostosowywania: Reguły i Przepływy pracy.

W trybie edytora kliknij ... w prawym górnym rogu i wybierz Customizations. Zobaczysz Rules i Workflows:

Reguły pomagają określać zachowanie agenta. Są to wytyczne, które możesz podać, aby mieć pewność, że agent będzie się do nich stosować podczas generowania kodu i testów. Możesz na przykład chcieć, aby agent przestrzegał określonego stylu kodu lub zawsze dokumentował metody. Możesz dodać je jako reguły, a agent weźmie je pod uwagę.

Workflows to zapisane prompty, które możesz wywoływać na żądanie za pomocą / podczas interakcji z agentem. Kierują one też działaniem agenta, ale są wywoływane przez użytkownika na żądanie.

Dobre porównanie to reguły, które przypominają instrukcje systemowe, i przepływy pracy, które są podobne do zapisanych promptów, które możesz wybrać na żądanie.

Zarówno reguły, jak i przepływy pracy można stosować globalnie lub w poszczególnych obszarach roboczych i zapisywać w tych lokalizacjach:

Reguła globalna: ~/.gemini/GEMINI.md
Globalny przepływ pracy: ~/.gemini/antigravity/global_workflows/global-workflow.md
Reguły obszaru roboczego: your-workspace/.agent/rules/
Przepływy pracy w Workspace: your-workspace/.agent/workflows/

Dodajmy do obszaru roboczego reguły i przepływy pracy.

Dodaj regułę

Najpierw dodajmy regułę stylu kodu. Kliknij Rules i wybierz przycisk +Workspace. Nadaj mu nazwę, np. code-style-guide, i zastosuj te reguły stylu kodu:

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

Po drugie dodajmy kolejną regułę, aby mieć pewność, że kod jest generowany w sposób modułowy z przykładami w regule code-generation-guide:

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

Obie reguły zostaną zapisane i będą gotowe do użycia:

Dodawanie przepływu pracy

Zdefiniujmy też przepływ pracy, który będzie generować testy jednostkowe. Dzięki temu będziemy mogli uruchamiać testy jednostkowe, gdy będziemy zadowoleni z kodu (zamiast generować je przez cały czas).

Kliknij Workflows i wybierz przycisk +Workspace. Nadaj mu nazwę, np. generate-unit-tests, i wpisz te informacje:

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

Przepływ pracy jest już gotowy do działania:

Wypróbuj

Zobaczmy teraz, jak działają reguły i przepływy pracy. Utwórz w obszarze roboczym plik szkieletowy main.py:

def main():
    pass

if __name__ == "__main__":
    main()

Teraz otwórz okno czatu z agentem i zapytaj go: Implement binary search and bubble sort.

Po minucie lub dwóch w przestrzeni roboczej powinny pojawić się 3 pliki: main.py, bubble_sort.py i binary_search.py. Zauważysz też, że wszystkie reguły zostały wdrożone: główny plik nie jest zagracony i zawiera przykładowy kod, każda funkcja jest zaimplementowana w osobnym pliku, a cały kod jest udokumentowany i ma dobrą formę:

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


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

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

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


if __name__ == "__main__":
    main()

Skoro kod jest już gotowy, sprawdźmy, czy możemy uruchomić proces generowania testu jednostkowego.

Otwórz czat i zacznij pisać /generate. Antigravity zna już nasz przepływ pracy:

Kliknij generate-unit-tests i wpisz. Po kilku sekundach w obszarze roboczym pojawią się nowe pliki: test_binary_search.py, test_bubble_sort.py z już zaimplementowanymi testami.

Super!

10. Umiejętności

Modele bazowe Antigravity (takie jak Gemini) są wprawdzie wszechstronne, ale nie znają kontekstu Twojego projektu ani standardów zespołu . Wczytywanie każdej reguły lub narzędzia do okna kontekstowego agenta prowadzi do „przeładowania narzędziami”, wyższych kosztów, opóźnień i zamieszania.

Antigravity Skills rozwiązuje ten problem dzięki stopniowemu odkrywaniu. Umiejętność to specjalistyczny pakiet wiedzy, który pozostaje nieaktywny do momentu, gdy jest potrzebny. Jest ona wczytywana do kontekstu agenta tylko wtedy, gdy Twoja konkretna prośba pasuje do opisu umiejętności .

Struktura i zakres

Umiejętności to pakiety oparte na katalogach. Możesz je zdefiniować w 2 zakresach w zależności od potrzeb:

Zakres globalny (~/.gemini/antigravity/skills/): dostępny we wszystkich projektach (np. „Format JSON”, „General Code Review”) .
Zakres obszaru roboczego (<workspace-root>/.agent/skills/): dostępny tylko w określonym projekcie (np. „Wdróż w wersji testowej tej aplikacji”, „Wygeneruj kod początkowy dla tej platformy”) .

Anatomia odznaki

Typowy katalog umiejętności wygląda tak :

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.

Dodajmy teraz kilka umiejętności.

Umiejętność weryfikacji kodu

Jest to umiejętność oparta wyłącznie na instrukcjach, tzn. musimy tylko utworzyć plik SKILL.md, który będzie zawierać metadane i instrukcje dotyczące umiejętności. Utwórzmy umiejętność globalną, która dostarcza agentowi szczegółowe informacje do sprawdzenia zmian w kodzie pod kątem błędów, problemów ze stylem i sprawdzonych metod.

Najpierw utwórz katalog, który będzie zawierać tę umiejętność globalną.

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

W katalogu powyżej utwórz plik SKILL.md z treścią podaną poniżej:

---
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

Zwróć uwagę, że w pliku SKILL.md powyżej u góry znajdują się metadane (nazwa i opis), a potem instrukcje. Po wczytaniu agent odczyta tylko metadane skonfigurowanych przez Ciebie umiejętności i wczyta instrukcje dotyczące umiejętności tylko wtedy, gdy będzie to konieczne.

Wypróbuj

Utwórz plik o nazwie demo_bad_code.py z treścią podaną poniżej:

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()

Zapytaj agenta: review the @demo_bad_code.py file. Agent powinien zidentyfikować umiejętność code-review, wczytać szczegóły, a następnie wykonać działanie zgodnie z instrukcjami podanymi w pliku code-review/SKILL.md.

Przykładowe dane wyjściowe są widoczne poniżej:

Umiejętność szablonu nagłówka kodu

Czasami usługa wymaga użycia dużego bloku tekstu statycznego (np. nagłówka licencji). Wpisywanie tego tekstu bezpośrednio w prompcie jest nieefektywne. Zamiast tego umieszczamy go w folderze resources/ i instruujemy agenta, aby odczytywał go tylko w razie potrzeby .

Najpierw utwórz katalog, który będzie zawierać ten element obszaru roboczego.

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

Utwórz .agent/skills/license-header-adder/resources/HEADER.txt z tekstem licencji:

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

Utwórz plik .agent/skills/license-header-adder/SKILL.md o treści jak poniżej:

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

# License Header Adder

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

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

Wypróbuj

Zadaj agentowi te pytania: Create a new Python script named data_processor.py that prints 'Hello World'.

Agent odczyta szablon, przekonwertuje komentarze w stylu C na styl Pythona i automatycznie doda je na początku nowego pliku.

Tworząc te umiejętności, przekształcasz ogólny model Gemini w specjalistę w zakresie Twojego projektu. Masz skodyfikowane sprawdzone metody, np. przestrzeganie wytycznych dotyczących weryfikacji kodu lub nagłówków licencji. Zamiast wielokrotnie prosić AI o „dodanie licencji” lub „poprawienie formatu zatwierdzenia”, agent instynktownie wie, jak pracować w Twoim zespole.

11. Zabezpieczanie agenta

Przyznanie agentowi AI dostępu do terminala i przeglądarki jest mieczem obosiecznym. Umożliwia to autonomiczne debugowanie i wdrażanie, ale otwiera też wektory do wstrzykiwania promptów i eksfiltracji danych.

Antigravity rozwiązuje ten problem za pomocą szczegółowego systemu uprawnień opartego na zasadach automatycznego wykonywania poleceń terminala, listach dozwolonych i listach zabronionych.

Podczas pierwszej konfiguracji Antigravity lub w menu ustawień musisz wybrać Terminal Command Auto Executionzasadę. To ustawienie określa autonomię agenta w zakresie poleceń powłoki.

Aby sprawdzić bieżące ustawienia, otwórz Antigravity — Settings, a potem Advanced Settings. Powinna się wyświetlić sekcja Terminal z ustawieniami agenta. Jeśli chcesz zmienić to ustawienie, pamiętaj o tej tabeli:

Tryb zasad	Opis
Wył.	Agent nigdy nie wykonuje automatycznie poleceń terminala, chyba że jest to wyraźnie dozwolone.
Automatyczna	Agent decyduje, czy wykonać działanie, na podstawie wewnętrznych modeli bezpieczeństwa. Prosi o uprawnienia do wykonywania ryzykownych poleceń.
Turbo	Agent zawsze automatycznie wykonuje polecenia, chyba że wyraźnie mu tego zabronisz.

Konfigurowanie listy dozwolonych

Lista dozwolonych jest używana głównie w przypadku zasady Wyłączone. Jest to model bezpieczeństwa pozytywnego, co oznacza, że wszystko jest zabronione, chyba że jest wyraźnie dozwolone. Jest to najbezpieczniejsza konfiguracja.

Szczegółowa instrukcja konfiguracji

Ustaw opcję Automatyczne wykonywanie poleceń terminala na Wyłączone.
Dodaj to polecenie w sekcji Allow List Terminal Commands (Polecenia terminala na liście dozwolonych), klikając przycisk Add (Dodaj) obok niego : ls -al . Możesz też dodać inne polecenia terminala.

Testowanie listy dozwolonych

Zapytaj agenta: List the files in this directory.
Agent uruchamia się ls automatycznie.
Zapytaj agenta: Delete the <some file>
Agent spróbuje rm <filepath>, ale Antigravity zablokuje tę próbę i wymusi opinię użytkownika, ponieważ rm nie znajduje się na liście dozwolonych. Przed uruchomieniem polecenia Antigravity powinien poprosić Cię o zezwolenie.

Konfigurowanie listy odrzuconych

Lista odmów to zabezpieczenie zasad Turbo (a czasami Automatycznych). Jest to model bezpieczeństwa negatywnego, co oznacza, że wszystko jest dozwolone, chyba że jest wyraźnie zabronione. Wymaga to od programisty przewidzenia każdego możliwego zagrożenia, co jest ryzykowne, ale zapewnia maksymalną szybkość.

Szczegółowa instrukcja konfiguracji

Ustaw opcję Automatyczne wykonywanie poleceń terminala na Turbo.
Dodaj te polecenia w sekcji Polecenia terminala listy zablokowanych, klikając przycisk Dodaj obok niej.
rm
sudo
curl
wget

Testowanie listy odrzuconych

Zapytaj agenta: Check the version of python.
Agent uruchamia się python --version automatycznie.
Zapytaj agenta: Download www.google.com home page.
Agent próbuje curl. Antigravity wykrywa curl na liście zablokowanych i blokuje wykonanie, prosząc o ręczne zatwierdzenie.

Bezpieczeństwo przeglądarki

Możliwość przeglądania internetu to supermoc Antigravity, ale też słaby punkt. Agent odwiedzający przejętą witrynę z dokumentacją może napotkać atak typu „wstrzykiwanie kodu”.

Aby temu zapobiec, możesz wdrożyć listę dozwolonych adresów URL przeglądarki dla agenta przeglądarki.

Aby wyświetlić bieżące ustawienia, otwórz Antigravity — Settings, a potem Advanced Settings. W sekcji Ustawienia przeglądarki powinna być widoczna sekcja Lista dozwolonych adresów URL przeglądarki, jak pokazano poniżej:

Kliknij Otwórz plik listy dozwolonych, aby otworzyć plik w folderze HOME/.gemini/antigravity/browserAllowlist.txt.. Możesz mieć pewność, że wpisane są tu tylko zaufane domeny.

12. Podsumowanie i dalsze kroki

Gratulacje! Udało Ci się zainstalować Antigravity, skonfigurować środowisko i nauczyć się sterować agentami.

Co dalej? Aby zobaczyć, jak Antigravity działa w praktyce, możesz zapoznać się z tymi samouczkami:

Tworzenie aplikacji za pomocą Google Antigravity: w tym laboratorium kodowania pokazujemy, jak utworzyć kilka aplikacji, w tym dynamiczną witrynę konferencyjną i aplikację zwiększającą produktywność.
Tworzenie i wdrażanie w Google Cloud za pomocą Antigravity: ten moduł praktyczny pokazuje, jak zaprojektować, utworzyć i wdrożyć aplikację bezserwerową w Google Cloud.

Dokumentacja

Oficjalna strona : https://antigravity.google/
Dokumentacja: https://antigravity.google/docs
Przykłady zastosowań : https://antigravity.google/use-cases
Pobierz : https://antigravity.google/download
Kanał YouTube Google Antigravity : https://www.youtube.com/@googleantigravity