Google Antigravity'yi kullanmaya başlama

1. Giriş

Bu codelab'de, IDE'yi temsilcilerin öne çıktığı yeni bir döneme taşıyan, temsilci tabanlı geliştirme platformu Google Antigravity (belgenin geri kalanında Antigravity olarak anılacaktır) hakkında bilgi edineceksiniz.

Yalnızca satırları otomatik olarak tamamlayan standart kodlama asistanlarının aksine Antigravity, geliştirme sürecinde size yardımcı olmak için planlama, kodlama ve hatta web'de gezinme gibi işlemleri yapabilen bağımsız temsilcileri yönetmek için "Görev Kontrol Merkezi" sunar.

Antigravity, temsilci tabanlı bir platform olarak tasarlanmıştır. Bu yaklaşım, yapay zekanın yalnızca kod yazma aracı olmadığını, aynı zamanda karmaşık mühendislik görevlerini planlama, yürütme, doğrulama ve yineleme yeteneğine sahip bağımsız bir aktör olduğunu varsayar. Bu süreçte insan müdahalesi en aza indirilir.

Neler öğreneceksiniz?

Antigravity'yi yükleme ve yapılandırma
Antigravity'nin temel kavramlarını (ör. Agent Manager, Editor, Browser) keşfetme
Antigravity'yi kendi kurallarınız ve iş akışınızla birlikte güvenlik hususlarını da göz önünde bulundurarak özelleştirme

Gerekenler

Antigravity şu anda kişisel Gmail hesaplarında önizleme olarak kullanılabilir. Birinci sınıf modelleri kullanmak için ücretsiz kota sunar.

Antigravity'nin sisteminize yerel olarak yüklenmesi gerekir. Ürün Mac, Windows ve belirli Linux dağıtımlarında kullanılabilir. Kendi makinenize ek olarak aşağıdakilere ihtiyacınız olacaktır:

Chrome web tarayıcısı
Gmail hesabı (kişisel Gmail hesabı)

Bu codelab, yeni başlayanlar da dahil olmak üzere her seviyeden kullanıcı ve geliştirici için tasarlanmıştır.

Sorun bildirme

Bu codelab'i ve Antigravity'yi kullanırken sorunlarla karşılaşabilirsiniz.

Codelab ile ilgili sorunlar (yazım hataları, yanlış talimatlar) için lütfen bu codelab'in sol alt köşesindeki Report a mistake düğmesini kullanarak bir hata kaydı açın:

Antigravity ile ilgili hatalar veya özellik istekleri için lütfen sorunu Antigravity'de bildirin. Bu işlemi, sol alt köşedeki Provide Feedback bağlantısını kullanarak Agent Manager'da yapabilirsiniz:

Ayrıca, profil simgenizin altındaki Report Issue bağlantısını kullanarak da düzenleyiciye gidebilirsiniz:

2. Kurulum

Antigravity'yi henüz yüklemediyseniz Antigravity'yi yükleyerek başlayalım. Ürün şu anda önizleme sürümündedir ve kullanmaya başlamak için kişisel Gmail hesabınızı kullanabilirsiniz.

İndirilenler sayfasına gidip durumunuza uygun işletim sistemi sürümünü tıklayın. Uygulama yükleyiciyi başlatın ve uygulamayı makinenize yükleyin. Yüklemeyi tamamladıktan sonra Antigravity uygulamasını başlatın. Aşağıdakine benzer bir ekran görmeniz gerekir:

Lütfen her seferinde Next simgesini tıklayarak devam edin. Önemli adımlar aşağıda ayrıntılı olarak açıklanmıştır:

Kurulum akışını seçin: Bu seçenek, mevcut VS Code veya Cursor ayarlarınızdan içe aktarma yapmanıza olanak tanır. Yeni bir başlangıç yapacağız.
Bir düzenleyici teması türü seçin: Koyu temayı kullanacağız ancak bu tamamen size bağlıdır.
Antigravity aracını nasıl kullanmak istiyorsunuz?

Bu konuyu biraz daha ayrıntılı olarak inceleyelim. Ayarların Antigravity Kullanıcı Ayarları (Cmd + ,) üzerinden istediğiniz zaman değiştirilebileceğini unutmayın.

Seçeneklere geçmeden önce, bazı belirli özelliklere (iletişim kutusunun sağında gördüğünüz) göz atalım.

Terminal Execution policy

Bu, ajana terminalinizde komut (uygulama/araç) yürütme olanağı verme ile ilgilidir:

Her zaman devam et: Terminal komutlarını (yapılandırılabilir bir izin verilmeyenler listesindekiler hariç) her zaman otomatik olarak yürütün.
İnceleme iste: Terminal komutlarını yürütmeden önce kullanıcı incelemesi ve onayı isteyin.

Politikayı inceleme

Temsilci, görevini yerine getirirken çeşitli yapılar (görev planı, uygulama planı vb.) oluşturur. İnceleme politikası, incelenmesi gerekip gerekmediğine kimin karar vereceğini belirleyebileceğiniz şekilde ayarlanır. Her zaman incelemek mi yoksa temsilcinin bu konuda karar vermesine izin vermek mi istediğinizi seçin. Bu nedenle, burada da üç seçenek vardır.

Her Zaman Devam Et: Temsilci asla inceleme istemez.
Ajan Karar Verir: Ajan, inceleme isteğinde bulunma zamanına karar verir.
İnceleme İste: Temsilci her zaman inceleme ister.

JavaScript yürütme politikası

Bu özellik etkinleştirildiğinde, aracı URL'leri açmak, web sayfalarını okumak ve tarayıcı içeriğiyle etkileşimde bulunmak için tarayıcı araçlarını kullanabilir. Bu politika, JavaScript'in tarayıcıda nasıl yürütüleceğini kontrol eder.

Her Zaman Devam Et: Aracı, tarayıcıda JavaScript'i çalıştırmak için izin istemek üzere durmaz. Bu, aracıya tarayıcıda karmaşık işlemler ve doğrulama gerçekleştirme konusunda maksimum özerklik sağlar ancak güvenlik açıklarına karşı en yüksek riski de beraberinde getirir.
İnceleme iste: Tarayıcıda JavaScript kodu çalıştırmak için aracı her zaman durup izin ister.
Devre dışı: Temsilci, tarayıcıda hiçbir zaman JavaScript kodu çalıştırmaz.

Farklı politikaları anladığımıza göre, soldaki 4 seçenek, 3'ü için terminal yürütme, inceleme ve JavaScript yürütme politikalarına yönelik belirli ayarlardan, 4. seçenek ise tamamen özel olarak kontrol edebileceğimiz bir seçenektir. Bu 4 seçenek, terminalde komutları yürütmek ve göreve devam etmeden önce yapay çıktıları incelemek için Ajan'a ne kadar özerklik vermek istediğinizi seçebilmeniz için sunulur.

Bu 4 seçenek şunlardır:

Güvenli mod: Güvenli mod, aracı için gelişmiş güvenlik kontrolleri sunar. Bu sayede, aracının harici kaynaklara ve hassas işlemlere erişimini kısıtlayabilirsiniz. Güvenli mod etkinleştirildiğinde ortamınızı korumak için çeşitli güvenlik önlemleri uygulanır.
İnceleme odaklı geliştirme (önerilir): Temsilci, sık sık inceleme isteğinde bulunur.
Temsilci odaklı geliştirme: Temsilci hiçbir zaman inceleme istemez.
Özel yapılandırma

İncelemeye dayalı geliştirme seçeneği, aracının karar vermesine ve onay için kullanıcıya geri dönmesine olanak tanıdığı için iyi bir denge sağlar ve önerilen seçenektir.

Ardından, aşağıdaki tercihleriniz için seçim yapabileceğiniz Editörünüzü yapılandırın ayarları sayfası gelir:

Tuş bağlamaları: Tuş bağlamalarınızı yapılandırın.
Uzantılar: Popüler dil uzantılarını ve önerilen diğer uzantıları yükleyin.
Komut Satırı: Antigravity'yi agy ile açmak için komut satırı aracını yükleyin.

Artık Google'da oturum açmaya hazırsınız. Daha önce de belirtildiği gibi, Antigravity beta sürümünde kullanılabilir ve kişisel bir Gmail hesabınız varsa ücretsizdir. Hesabınızla hemen oturum açın. Bu işlem, oturum açmanıza olanak tanıyan tarayıcıyı açar. Kimlik doğrulama başarılı olduğunda aşağıdaki mesaja benzer bir mesaj görürsünüz ve Antigravity uygulamasına yönlendirilirsiniz. Her şeyi akışına bırakın.

Son olarak, Kullanım Şartları. Kayıt olmak isteyip istemediğinize karar verip Next simgesini tıklayabilirsiniz.

Bu sizi, Antigravity'nin sizinle işbirliği yapmak için beklediği gerçek anına götürecek.

3. Temsilci Yöneticisi

Başlamaya hazırız.

Antigravity, açık kaynaklı Visual Studio Code (VS Code) temelini kullanır ancak kullanıcı deneyimini kökten değiştirerek metin düzenleme yerine aracı yönetimine öncelik verir. Arayüz, iki ayrı birincil pencereye ayrılmıştır: Editor ve Agent Manager. Bu sorumluluk ayrımı, bireysel katkı ile mühendislik yönetimi arasındaki farkı yansıtır.

Agent Manager: Mission Control

Antigravity başlatıldığında kullanıcı genellikle bir dosya ağacıyla değil, aşağıdaki resimde gösterildiği gibi Aracı Yöneticisi ile karşılaşır:

Bu arayüz, Mission Control kontrol paneli görevi görür. Üst düzey düzenleme için tasarlanmıştır. Geliştiricilerin farklı çalışma alanlarında veya görevlerde eşzamansız olarak çalışan birden fazla aracı oluşturmasına, izlemesine ve bu araçlarla etkileşime girmesine olanak tanır.

Bu görünümde geliştirici, mimar rolündedir. Üst düzey hedefler tanımlarlar. Örneğin:

Kimlik doğrulama modülünü yeniden düzenleme
Bağımlılık ağacını güncelleme
Faturalandırma API'si için test paketi oluşturma

Yukarıdaki şemada belirtildiği gibi, bu isteklerin her biri özel bir aracı örneği oluşturur. Kullanıcı arayüzü, bu paralel iş akışlarının görselleştirilmesini sağlar. Her aracının durumunu, ürettiği Artifacts'leri (planlar, sonuçlar, farklılıklar) ve insan onayı bekleyen istekleri gösterir.

Bu mimari, önceki IDE'lerin temel bir sınırlamasını (doğrusal ve eşzamanlı olan, daha çok chatbot deneyimi sunan IDE'ler) ele alıyor. Geleneksel bir sohbet arayüzünde, geliştiricinin bir sonraki soruyu sormadan önce yapay zekanın kodu oluşturmayı bitirmesini beklemesi gerekir. Antigravity'nin Yönetici Görünümü'nde bir geliştirici, beş farklı hatayı aynı anda düzeltmek için beş farklı temsilci gönderebilir ve bu sayede verimliliğini etkili bir şekilde artırabilir.

Yukarıdaki Next simgesini tıkladığınızda bir çalışma alanı açma seçeneği sunulur.

Workspace'i VS Code'dan bildiğiniz gibi düşündüğünüzde işiniz tamamlanır. Bu nedenle, düğmeyi tıklayıp başlayacağımız klasörü seçerek yerel bir klasörü açabiliriz. Benim durumumda, ana klasörümde my-agy-projects adlı bir klasör vardı ve onu seçtim. Tamamen farklı bir klasör kullanabilirsiniz. Dilerseniz bu adımı tamamen atlayabilir ve daha sonra istediğiniz zaman bir çalışma alanı açabilirsiniz.

Bu adımı tamamladığınızda, aşağıda gösterilen Agent Manager penceresine yönlendirilirsiniz:

Uygulamanın, seçilen çalışma alanı klasöründe (my-agy-projects) yeni bir sohbet başlatmaya hemen hazır olduğunu fark edeceksiniz. Diğer yapay zeka uygulamalarıyla (Cursor, Gemini CLI) çalışma konusundaki mevcut bilginizi kullanabilir ve istem oluştururken ek bağlam dahil etmek için @ ile diğer yöntemlerden yararlanabilirsiniz.

Hem Planning hem de Model Selection açılır listelerine göz atın. Model Seçimi açılır menüsünden, Agent'ınızın kullanması için şu anda kullanılabilen modellerden birini seçebilirsiniz. Liste aşağıda gösterilmektedir:

Benzer şekilde, aracının varsayılan Planning modunda olacağını görüyoruz. Ancak Fast modunu da kullanabiliriz.

Bu konuyla ilgili belgelerde neler söylendiğine bakalım:

Planning: Bir Temsilci, görevleri yürütmeden önce plan yapabilir. Derinlemesine araştırma, karmaşık görevler veya ortak çalışmalar için kullanın. Bu modda, ajan çalışmasını görev grupları halinde düzenler, yapay içerikler üretir ve en iyi kalite için çalışmasını kapsamlı bir şekilde araştırmak, düşünmek ve planlamak üzere diğer adımları atar. Burada çok daha fazla çıktı göreceksiniz.
Fast: Agent, görevleri doğrudan yürütür. Değişkenleri yeniden adlandırma, birkaç bash komutunu başlatma veya diğer küçük ve yerel görevler gibi daha hızlı tamamlanabilecek basit görevler için kullanın. Bu yöntem, hızın önemli bir faktör olduğu ve görevin, kalitenin düşmesi konusunda endişelenmeyecek kadar basit olduğu durumlarda faydalıdır.

Ajanlardaki düşünme bütçesi ve benzer terimlere aşinaysanız bunu, ajanın düşünme sürecini kontrol etme ve dolayısıyla düşünme bütçesini doğrudan etkileme yeteneği olarak düşünebilirsiniz. Şimdilik varsayılan ayarları kullanacağız ancak lansman sırasında Gemini 3 Pro modelinin herkes için sınırlı kotalar dahilinde kullanılabileceğini unutmayın. Gemini 3 kullanımına yönelik ücretsiz kotalarınızı tükettiyseniz bu durumu belirten mesajlar alırsınız.

Şimdi biraz zamanımızı buradaki Agent Manager (pencere) üzerinde geçirelim ve temel yapı taşları, Antigravity'de nasıl gezineceğiniz ve daha fazlası hakkında net bir fikir edinmek için birkaç şeyi anlayalım. Temsilci Yöneticisi penceresi aşağıda gösterilmiştir:

Lütfen yukarıdaki numaralı diyagrama bakın:

Inbox: Bu özelliği, tüm görüşmelerinizi tek bir yerden takip etme yöntemi olarak düşünebilirsiniz. Görevlere gönderdiğiniz Agent'lar Gelen Kutusu'nda görünür. Gelen Kutusu'nu tıklayarak mevcut tüm görüşmelerin listesini alabilirsiniz. İletişimlerin herhangi birine dokunduğunuzda, gönderilen tüm mesajlara, görevlerin durumuna, aracının ürettiği içeriklere ve hatta görevlerle ilgili onayınızı bekleyip beklemediğine yönlendirilirsiniz. Bu, üzerinde çalıştığınız önceki bir göreve daha sonra geri dönmenin harika bir yoludur. Çok kullanışlı bir özellik.
Start Conversation: Yeni bir görüşme başlatmak için bunu tıklayın. Bu işlem sizi doğrudan Ask anything yazan girişe yönlendirir.
Workspaces: Çalışma alanlarından ve istediğiniz çalışma alanında çalışabileceğinizden bahsettik. İstediğiniz zaman daha fazla çalışma alanı ekleyebilir ve sohbete başlarken herhangi bir çalışma alanını seçebilirsiniz.
Playground: Bu, temsilciyle kolayca sohbet başlatabileceğiniz ve ardından dosyalar üzerinde daha sıkı kontrol sahibi olmak için bu sohbeti çalışma alanına dönüştürebileceğiniz harika bir yöntemdir. Bunu bir karalama alanı olarak düşünebilirsiniz.
Editor View: Şu ana kadar Temsilci Yöneticisi görünümündeyiz. İsterseniz istediğiniz zaman Düzenleyici görünümüne geçebilirsiniz. Bu işlem, çalışma alanı klasörünüzü ve oluşturulan tüm dosyaları gösterir. Dosyaları doğrudan düzenleyebilir veya düzenleyicide satır içi rehberlik sağlayabilir, komut verebilirsiniz. Böylece Aracı, değiştirilen önerilerinize/talimatlarınıza göre işlem yapabilir veya değişiklik yapabilir. Düzenleyici Görünümü'nü ilerleyen bölümlerde ayrıntılı olarak ele alacağız.
Browser: Son olarak, Antigravity'yi çok güçlü kılan ve onu diğerlerinden ayıran net özelliklerden birine geliyoruz: Chrome Tarayıcı ile yakın entegrasyonu. Bir sonraki bölümde tarayıcıyı ayarlamaya başlayalım.

4. Antigravity Browser

Belgelere göre, temsilci tarayıcıyla etkileşim kurmak istediğinde, söz konusu görevi yerine getirmek için bir tarayıcı alt temsilcisi çağırır. Tarayıcı alt aracısı, Antigravity tarafından yönetilen tarayıcıda açık olan sayfalarda çalışmak üzere uzmanlaşmış bir model kullanır. Bu model, ana aracı için seçtiğiniz modelden farklıdır.

Bu alt aracı, tarayıcınızı kontrol etmek için gerekli olan çeşitli araçlara erişebilir. Bunlar arasında tıklama, kaydırma, yazma, konsol günlüklerini okuma ve daha fazlası yer alır. Ayrıca, DOM yakalama, ekran görüntüleri veya Markdown ayrıştırma yoluyla açık sayfalarınızı okuyabilir ve video çekebilir.

Bu nedenle, Antigravity tarayıcı uzantısını başlatıp yüklememiz gerekir. Bunu yapmak için Playground'da bir sohbet başlatalım ve adımları inceleyelim.

Playground simgesini seçin ve aşağıda gösterildiği gibi Temsilci'ye şu görevi go to antigravity.google verin:

Görevi gönderin. Temsilcinin görevi analiz ettiğini görürsünüz ve düşünce sürecini inceleyebilirsiniz. Bir noktada doğru şekilde devam edecek ve tarayıcı aracısını aşağıda gösterildiği gibi ayarlaması gerektiğini belirtecek. Setup simgesini tıklayın.

Bu işlemle tarayıcı açılır ve aşağıdaki gibi bir mesaj gösterilerek uzantının yüklenmesi istenir:

Devam ettiğinizde, yükleyebileceğiniz Chrome uzantısına yönlendirilirsiniz.

Uzantıyı başarıyla yükledikten sonra Antigravity Agent çalışmaya başlar ve görevini yapabilmek için izin vermenizi beklediğini belirtir. Açılan tarayıcı penceresinde bazı etkinlikler görmeniz gerekir:

Temsilci Yöneticisi görünümüne geri döndüğünüzde aşağıdakileri görmeniz gerekir:

Agent'tan antigravity.google web sitesini ziyaret etmesini istediğimiz için tam olarak beklediğimiz şey oldu. İzni verdiğinizde, web sitesine güvenli bir şekilde gidildiğini görürsünüz (aşağıda gösterildiği gibi):

5. Yapılar

Antigravity, çalışmalarını planlayıp tamamladıkça Artifacts oluşturur. Bu sayede çalışmalarını paylaşır ve kullanıcıdan geri bildirim alır. Bunlar; zengin markdown dosyaları, mimari diyagramlar, resimler, tarayıcı kayıtları, kod farklılıkları vb.

Yapay nesneler, "güven boşluğunu" kapatır. Bir temsilci "Hatayı düzelttim" dediğinde geliştiricinin doğrulamak için kodu okuması gerekiyordu. Antigravity'de (Yerçekimsiz) ajan, bunu kanıtlamak için bir eser üretiyor.

Antigravity tarafından üretilen başlıca yapay nesneler şunlardır:

Task Lists: Temsilci, kod yazmadan önce yapılandırılmış bir plan oluşturur. Bu planı genellikle düzenlemeniz gerekmez ancak inceleyebilir ve gerekirse değiştirmek için yorum ekleyebilirsiniz.
Implementation Plan: Bu, bir görevi tamamlamak için kod tabanınızdaki değişiklikleri tasarlamak amacıyla kullanılır. Bu planlar, hangi revizyonların gerekli olduğuna dair teknik ayrıntılar içerir ve yapay ürün inceleme politikanız "Her Zaman Devam Et" olarak ayarlanmadığı sürece kullanıcı tarafından incelenmek üzere tasarlanmıştır.
Walkthrough: Bu, aracının görev uygulamasını tamamlamasının ardından, değişikliklerin özeti ve nasıl test edileceği hakkında bilgi vermek için oluşturulur.
Code diffs: Antigravity, teknik olarak bir yapay ürün olmasa da inceleyip yorum yapabileceğiniz kod farklılıkları da üretir.
Screenshots: Temsilci, kullanıcı arayüzünün değişikliğin öncesindeki ve sonrasındaki durumunu yakalar.
Browser Recordings: Dinamik etkileşimler (ör. "Giriş düğmesini tıklayın, yükleme çarkının görünmesini bekleyin, kontrol panelinin yüklendiğini doğrulayın") gibi bir görev verildiğinde oturumunun videosunu kaydeder. Geliştirici, uygulamayı kendisi çalıştırmadan işlevsel şartın karşılandığını doğrulamak için bu videoyu izleyebilir.

Yapay ürünler hem Aracı Yöneticisi hem de Düzenleyici görünümlerinde oluşturulur ve gösterilir.

Düzenleyici görünümünün sağ alt köşesinde Artifacts simgesini tıklayabilirsiniz:

Aracı Yöneticisi görünümünde, sağ üstte Review changes simgesinin yanında, yapay nesneleri açıp kapatabileceğiniz bir düğme veya yapay nesneler açıksa oluşturulan yapay nesnelerin listesini görebilirsiniz:

Aşağıda gösterildiği gibi Artifacts (Yapılar) görünümünü görmeniz gerekir. Buradaki örneğimizde, Aracı'ya antigravity.google sayfasını ziyaret etmesi talimatını verdik. Bu nedenle, ekran görüntüsü alındı ve aynı ekran görüntüsünün videosu oluşturuldu:

Kod farklılıklarını düzenleyici görünümündeki Review Changes bölümünde görebilirsiniz:

Geliştiriciler, "Google Dokümanlar tarzı yorumlar" kullanarak bu yapıtlarla ve kod farklılıklarıyla etkileşimde bulunabilir. Belirli bir işlemi veya görevi seçebilir, komutu istediğiniz şekilde verebilir ve ardından bunu aracıya gönderebilirsiniz. Ardından temsilci bu geri bildirimi alıp buna göre yineleme yapar. Yazara geri bildirimde bulunduğunuz ve yazarın bu geri bildirimi yinelediği etkileşimli Google Dokümanlar'ı kullanmayı düşünebilirsiniz.

6. Gelen kutusunu tekrar ziyaret etme

Aracılarla birkaç görüşme başlattıysanız artık Agent Manager penceresindeki Inbox bölümüne göz atabilirsiniz. Bu işlem, tüm görüşmeleri gösterir. Görüşme geçmişini, üretilen öğeleri ve daha fazlasını görmek için görüşmelerden birini tıklayın. Bizim durumumuzda, ilk ileti dizisini çalıştırdıktan sonra gelen kutumuzda aşağıdaki gibi listelenen ileti dizisi gösteriliyor:

Bu görüşmeyi tıkladığınızda ayrıntılar gösterilir:

Sohbete buradan da devam edebilirsiniz.

7. Düzenleyici

Düzenleyici, VS Code'un alışkanlıklarını koruyarak deneyimli geliştiricilerin kas hafızasına saygı gösterir. Standart dosya gezgini, söz dizimi vurgulama ve uzantı ekosistemi içerir.

Düzenleyici'ye gitmek için Agent Manager'ın sağ üst kısmındaki Open Editor düğmesini tıklayabilirsiniz.

Kurulum ve Uzantılar

Normal bir kurulumda düzenleyici, terminal ve aracı görünür durumda olur:

Bu durum geçerli değilse terminal ve aracı panellerini aşağıdaki şekilde değiştirebilirsiniz:

Terminal panelini açıp kapatmak için Ctrl + ` kısayolunu kullanın.
Aracı panelini açıp kapatmak için Cmd + L kısayolunu kullanın.

Ayrıca Antigravity, kurulum sırasında bazı uzantıları yükleyebilir ancak kullandığınız programlama diline bağlı olarak muhtemelen daha fazla uzantı yüklemeniz gerekir. Örneğin, Python geliştirme için yüklemeyi seçebileceğiniz uzantılar şunlardır:

Düzenleyici

Otomatik tamamla

Düzenleyiciye kod yazarken, sekme tuşuna basarak kolayca kullanabileceğiniz akıllı bir otomatik tamamlama özelliği devreye girer:

İçe aktarmak için Tab tuşuna basın.

Eksik bağımlılıkları eklemek için içe aktarma sekmesi önerisini alırsınız:

Sekme tuşuyla atlama

İmleci kodda bir sonraki mantıksal yere taşımak için sekme tuşuna basarak atlama önerileri alırsınız:

Komutlar

Doğal dil kullanarak satır içi tamamlama için düzenleyicide veya terminalde Cmd + I ile komutları tetikleyebilirsiniz.

Düzenleyicide, Fibonacci sayılarını hesaplama yöntemi isteyebilir ve ardından bunu kabul edebilir veya reddedebilirsiniz:

Terminalde terminal komutu önerileri alabilirsiniz:

Temsilci Yan Paneli

Düzenleyicide, aracı yan panelini çeşitli şekillerde açıp kapatabilirsiniz.

Manuel açma

Sağdaki temsilci panelini Cmd + L kısayoluyla manuel olarak açıp kapatabilirsiniz.

Soru sormaya başlayabilir, @ kullanarak dosya, dizin, MCP sunucusu gibi daha fazla bağlam ekleyebilir veya / kullanarak bir iş akışına (kaydedilmiş bir istem) başvurabilirsiniz:

Ayrıca iki sohbet modu arasından seçim yapabilirsiniz: Fast veya Planning :

Fast, hızlı görevler için önerilirken Planning, temsilcinin onaylayabileceğiniz bir plan oluşturduğu daha karmaşık görevler için önerilir.

Ayrıca, görüşme için farklı modeller de seçebilirsiniz:

Açıkla ve düzelt

Aracıyı tetiklemenin bir başka yolu da bir sorunun üzerine gelip Explain and fix simgesini seçmektir:

Sorunları temsilciye gönderme

Ayrıca, Problems bölümüne gidip Send all to Agent seçeneğini belirleyerek temsilcinin bu sorunları düzeltmesini sağlayabilirsiniz:

Terminal çıkışını temsilciye gönderme

Hatta terminal çıkışının bir bölümünü seçip Cmd + L ile aracıya gönderebilirsiniz:

Düzenleyici ve Temsilci Yöneticisi arasında geçiş yapma

Dilediğiniz zaman, düzenleyici modundayken sağ üstteki Open Agent Manager düğmesini tıklayarak düzenleyici modu ile tam aracı yöneticisi modu arasında geçiş yapabilir, aracı yöneticisi modundayken sağ üstteki Open Editor düğmesini tıklayarak da geri dönebilirsiniz.

Alternatif olarak, iki mod arasında geçiş yapmak için Cmd + E klavye kısayolunu da kullanabilirsiniz.

8. Geri Bildirim Gönder

Antigravity'nin temelinde, deneyimin her aşamasında geri bildirimlerinizi kolayca toplama özelliği yer alır. Aracı bir görev üzerinde çalışırken süreç içinde farklı eserler oluşturur:

Uygulama planı ve görev listesi (kodlamadan önce)
Kod farklılıkları (kod oluştururken)
Sonuçları doğrulama (kodlamadan sonra)

Bu yapıtlar, Antigravity'nin planlarını ve ilerleme durumunu paylaşma yöntemidir. Daha da önemlisi, Google Dokümanlar tarzı yorumlarla aracıya geri bildirimde bulunabilirsiniz. Bu, aracı istediğiniz yöne etkili bir şekilde yönlendirmek için çok yararlıdır.

Basit bir yapılacaklar listesi uygulaması oluşturmayı deneyelim ve bu süreçte Antigravity'ye nasıl geri bildirim sağlayabileceğimizi görelim.

Planlama modu

Öncelikle Antigravity'nin Planning modunda (Fast modu yerine) olduğundan emin olmanız gerekir. Bu modu, aracı tarafı panel sohbetinde seçebilirsiniz. Bu sayede Antigravity, kod yazmaya başlamadan önce bir uygulama planı ve görev listesi oluşturur. Ardından, aşağıdaki gibi bir istem deneyin: Create a todo list web app using Python. Bu, temsilcinin planlamaya başlamasını ve bir uygulama planı oluşturmasını sağlar.

Uygulama planı

Uygulama planı, Antigravity'nin ne yapmayı planladığına, hangi teknoloji yığınını kullanacağına ve önerilen değişikliklerin üst düzey bir açıklamasına dair genel bir bakış sunar.

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

Geri bildirim gönderebileceğiniz ilk yer de burasıdır. Örneğimizde, aracı Python web çerçevesi olarak Flask'ı kullanmak istiyor. Bunun yerine FastAPI kullanmak için uygulama planına bir yorum ekleyebiliriz. Yorumu ekledikten sonra yorumu gönderin veya Antigravity'den güncellenmiş uygulama planıyla Proceed yapmasını isteyin.

Görev listesi

Uygulama planı güncellendikten sonra Antigravity bir görev listesi oluşturur. Bu, Antigravity'nin uygulamayı oluşturmak ve doğrulamak için uygulayacağı adımların somut bir listesidir.

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

Bu, geri bildirimde bulunabileceğiniz ikinci yerdir.

Örneğin, kullanım alanımızda aşağıdaki yorumu ekleyerek daha ayrıntılı doğrulama talimatları ekleyebilirsiniz: Verify application by adding, editing, and deleting a todo item and taking a screenshot.

Kod değişiklikleri

Bu noktada Antigravity, yeni dosyalarda bazı kodlar oluşturur. Ayrıntılara bakmadan temsilci sohbeti yan panelinde bu değişiklikleri Accept all veya Reject all yapabilirsiniz.

Değişikliklerin ayrıntılarını görmek ve koda ayrıntılı yorumlar eklemek için Review changes simgesini de tıklayabilirsiniz. Örneğin, main.py dosyasına şu yorumu ekleyebiliriz: Add basic comments to all methods

Bu, Antigravity ile kod üzerinde yineleme yapmanın harika bir yoludur.

Adım adım açıklamalı kılavuz

Antigravity kodlamayı tamamladıktan sonra sunucuyu başlatır ve uygulamayı doğrulamak için bir tarayıcı açar. Görev ekleme, görev güncelleme gibi bazı manuel testler yapar. Tüm bunlar Antigravity tarayıcı uzantısı sayesinde gerçekleşir. Son olarak, uygulamayı doğrulamak için yaptığı işlemleri özetleyen bir açıklama dosyası oluşturur. Bu dosyada, tarayıcı kaydı içeren bir ekran görüntüsü veya doğrulama akışı yer alır.

Ayrıca, ekran görüntüsüne veya tarayıcı kaydına yorum da ekleyebilirsiniz. Örneğin, Change the blue theme to orange theme yorumunu ekleyip gönderebiliriz. Yorum gönderildikten sonra Antigravity değişiklikleri yapar, sonuçları doğrular ve adım adım açıklamayı günceller.

Değişiklikleri geri al

Son olarak, her adımdan sonra değişiklikten memnun kalmazsanız sohbetten geri alma seçeneğini kullanabilirsiniz. Sohbette ↩️ Undo changes up to this point simgesini seçmeniz yeterlidir.

9. Kurallar ve İş Akışları

Antigravity'de birkaç özelleştirme seçeneği bulunur: Kurallar ve İş Akışları.

Düzenleyici modundayken sağ üst köşedeki ... simgesini tıklayın ve Customizations seçeneğini belirleyin. Rules ve Workflows simgelerini görürsünüz:

Kurallar, aracının davranışını yönlendirmeye yardımcı olur. Bunlar, aracının kod oluşturup test ederken uymasını sağlamak için sağlayabileceğiniz yönergelerdir. Örneğin, aracının belirli bir kod stilini izlemesini veya yöntemleri her zaman belgelemesini isteyebilirsiniz. Bunları kural olarak ekleyebilirsiniz. Ajan, bu kuralları dikkate alır.

İş akışları, temsilciyle etkileşim kurarken / ile isteğe bağlı olarak tetikleyebileceğiniz kayıtlı istemlerdir. Ayrıca aracının davranışını yönlendirirler ancak kullanıcı tarafından talep üzerine tetiklenirler.

Kurallar, sistem talimatlarına benzerken iş akışları, istediğiniz zaman seçebileceğiniz kayıtlı istemlere benzer.

Hem Kurallar hem de İş Akışları global olarak veya çalışma alanı başına uygulanabilir ve aşağıdaki konumlara kaydedilebilir:

Genel kural: ~/.gemini/GEMINI.md
Global iş akışı: ~/.gemini/antigravity/global_workflows/global-workflow.md
Çalışma alanı kuralları: your-workspace/.agent/rules/
Workspace iş akışları: your-workspace/.agent/workflows/

Çalışma alanına bazı kurallar ve iş akışları ekleyelim.

Kural ekle

Öncelikle bir kod stili kuralı ekleyelim. Rules simgesine gidin ve +Workspace düğmesini seçin. Aşağıdaki kod stili kurallarıyla birlikte code-style-guide gibi bir ad verin:

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

İkinci olarak, kodun code-generation-guide kuralındaki örneklerle modüler bir şekilde oluşturulmasını sağlamak için başka bir kural ekleyelim:

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

İki kural kaydedilir ve hazır hale gelir:

İş akışı ekleyin

Ayrıca birim testleri oluşturmak için bir iş akışı tanımlayalım. Bu sayede, koddan memnun olduğumuzda birim testlerini tetikleyebiliriz (temsilcinin sürekli olarak birim testleri oluşturması yerine).

Workflows simgesine gidin ve +Workspace düğmesini seçin. Aşağıdaki bilgilerle birlikte generate-unit-tests gibi bir ad verin:

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

İş akışı da artık kullanıma hazır:

Deneyin

Şimdi kuralları ve iş akışlarını uygulamalı olarak görelim. Çalışma alanınızda bir iskelet main.py dosyası oluşturun:

def main():
    pass

if __name__ == "__main__":
    main()

Şimdi temsilci sohbet penceresine gidin ve temsilciye şunu sorun: Implement binary search and bubble sort.

Bir veya iki dakika sonra çalışma alanında üç dosya görürsünüz: main.py, bubble_sort.py, binary_search.py. Ayrıca tüm kuralların uygulandığını da fark edeceksiniz: Ana dosya karmaşık değil ve örnek kodu içeriyor, her özellik kendi dosyasında uygulanıyor, tüm kodlar belgelenmiş ve iyi bir tarzda yazılmış:

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

Koddan memnun olduğumuza göre şimdi birim testi oluşturma iş akışını tetikleyip tetikleyemeyeceğimize bakalım.

Sohbete gidin ve /generate yazmaya başlayın. Antigravity, iş akışımız hakkında bilgi sahibidir:

generate-unit-tests simgesini seçip girin. Birkaç saniye sonra çalışma alanınızda yeni dosyalar (test_binary_search.py, test_bubble_sort.py) görünür. Bu dosyalarda, halihazırda uygulanmış bir dizi test bulunur.

Güzel!

10. Beceri

Antigravity'nin temelini oluşturan modeller (ör. Gemini) güçlü genellemeciler olsa da projenizin bağlamını veya ekibinizin standartlarını bilmezler. Her kuralı veya aracı aracının bağlam penceresine yüklemek "araç şişmesine", daha yüksek maliyetlere, gecikmeye ve kafa karışıklığına yol açar.

Antigravity Skills, bu sorunu Progressive Disclosure (İlerleme Durumu Açıklaması) ile çözer. Beceri, ihtiyaç duyulana kadar kullanılmayan özel bir bilgi paketidir. Yalnızca belirli isteğiniz becerinin açıklamasıyla eşleştiğinde aracının bağlamına yüklenir .

Yapı ve Kapsam

Beceriler, dizine dayalı paketlerdir. İhtiyaçlarınıza bağlı olarak bunları iki kapsamda tanımlayabilirsiniz:

Genel Kapsam (~/.gemini/antigravity/skills/): Tüm projelerinizde kullanılabilir (ör. "Format JSON", "General Code Review") .
Çalışma alanı kapsamı (<workspace-root>/.agent/skills/): Yalnızca belirli bir proje (ör. "Deploy to this app's staging" (Bu uygulamanın hazırlık sürümüne dağıt), "Generate boilerplate for this specific framework" (Bu çerçeve için standart kod oluştur) gibi seçenekler bulunur.

Beceri Anatomisi

Tipik bir beceri dizini şu şekilde görünür :

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.

Şimdi bazı beceriler ekleyelim.

Kod İnceleme Becerisi

Bu, yalnızca talimat içeren bir beceridir. Yani yalnızca meta verileri ve beceri talimatlarını içeren SKILL.md dosyasını oluşturmamız gerekir. Aracıya, kod değişikliklerini hatalar, stil sorunları ve en iyi uygulamalar açısından incelemesi için ayrıntılar sağlayan bir global beceri oluşturalım.

Öncelikle bu global beceriyi içerecek dizini oluşturun.

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

Yukarıdaki dizinde aşağıdaki içeriğe sahip bir SKILL.md dosyası oluşturun:

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

Yukarıdaki SKILL.md dosyasının en üstte meta verileri (ad ve açıklama), ardından talimatları içerdiğini unutmayın. Yüklendiğinde aracı yalnızca yapılandırdığınız becerilerin meta verilerini okur ve beceri talimatlarını yalnızca gerekirse yükler.

Deneyin

İçeriği aşağıda gösterildiği gibi olan demo_bad_code.py adlı bir dosya oluşturun:

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

Aracıya sorun: review the @demo_bad_code.py file. Temsilci, code-review becerisini belirlemeli, ayrıntıları yüklemeli ve ardından code-review/SKILL.md dosyasında verilen talimatlara göre işlemi gerçekleştirmelidir.

Örnek bir çıkış aşağıda gösterilmektedir:

Code Header Template Skill

Bazen bir becerinin büyük bir statik metin bloğu (ör. lisans başlığı) kullanması gerekir. Bu metni doğrudan isteme girmek gereksizdir. Bunun yerine, dosyayı resources/ klasörüne yerleştiririz ve aracıya yalnızca gerektiğinde okumasını söyleriz .

İlk olarak, bu çalışma alanı becerisini içerecek dizini oluşturun.

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

Lisans metninizle .agent/skills/license-header-adder/resources/HEADER.txt oluşturun:

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

Aşağıdaki içeriklere sahip bir .agent/skills/license-header-adder/SKILL.md dosyası oluşturun:

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

Deneyin

Temsilciye şunları sorun: Create a new Python script named data_processor.py that prints 'Hello World'.

Temsilci, şablonu okur, C tarzı yorumları Python tarzına dönüştürür ve bunları yeni dosyanıza otomatik olarak ekler.

Bu becerileri oluşturarak genel amaçlı Gemini modelini projeniz için uzman bir modele dönüştürmüş olursunuz. Kod inceleme yönergelerinizi veya lisans başlıklarınızı takip etmek gibi en iyi uygulamalarınızı kodladınız. Artık "lisansı eklemeyi unutma" veya "commit biçimini düzelt" gibi istemleri yapay zekaya tekrar tekrar göndermek yerine, aracı ekibinizle nasıl çalışacağını içgüdüsel olarak biliyor.

11. Aracıyı Güvenli Hale Getirme

Yapay zeka temsilcisine terminalinize ve tarayıcınıza erişim izni vermek iki ucu keskin bir bıçaktır. Bağımsız hata ayıklama ve dağıtım olanağı sunar ancak istem ekleme ve veri sızdırma için de vektörler açar.

Antigravity, Terminal Komutu Otomatik Yürütme politikaları, izin verilenler listeleri ve engellenenler listeleri etrafında dönen ayrıntılı bir izin sistemiyle bu sorunu ele alır.

Antigravity'yi ilk kez yapılandırırken veya ayarlar menüsünden bir Terminal Command Auto Execution politikası seçmeniz gerekir. Bu ayar, aracının kabuk komutlarıyla ilgili özerkliğini belirler.

Bu ayarla ilgili mevcut ayarlarınızı görüntülemek için Antigravity — Settings, ardından Advanced Settings bölümüne gidin. Aracı ayarları için Terminal bölümünü görmeniz gerekir. Bu ayarı başka bir değere değiştirmek isterseniz aşağıdaki tabloyu göz önünde bulundurun:

Politika Modu	Açıklama
Kapalı	Aracı, açıkça izin verilmediği sürece terminal komutlarını hiçbir zaman otomatik olarak yürütmez.
Otomatik	Aracı, dahili güvenlik modellerine göre yürütme işleminin yapılıp yapılmayacağına karar verir. Riskli komutlar için izin ister.
Turbo	Aracı, açıkça reddedilmediği sürece komutları her zaman otomatik olarak yürütür.

İzin verilenler listesini yapılandırma

İzin verilenler listesi, öncelikle Kapalı politikasıyla birlikte kullanılır. Bu, olumlu bir güvenlik modelini temsil eder. Yani açıkça izin verilmediği sürece her şey yasaktır. Bu en güvenli yapılandırmadır.

Adım adım yapılandırma

Terminal Command Auto Execution (Terminal Komutunun Otomatik Yürütülmesi) ayarını Off (Kapalı) olarak ayarlayın.
Yanındaki Add (Ekle) düğmesini tıklayarak Allow List Terminal Commands (İzin Verilen Terminal Komutları Listesi) bölümüne aşağıdaki komutu ekleyin : ls -al . İsterseniz başka terminal komutları da ekleyebilirsiniz.

İzin verilenler listesini test etme

Aracıya sorun: List the files in this directory.
Aracı ls otomatik olarak çalışır.
Aracıya sorun: Delete the <some file>
Aracı rm <filepath> deneyecek ancak Antigravity, rm izin verilenler listesinde olmadığı için bunu engelleyecek ve kullanıcı incelemesi yapmaya zorlayacaktır. Antigravity, komutu çalıştırmadan önce sizden izin istemelidir.

Reddetme listesini yapılandırma

Reddetme Listesi, Turbo (ve bazen Otomatik) politikasının korumasıdır. Bu, açıkça yasaklanmadığı sürece her şeye izin verildiği anlamına gelen negatif bir güvenlik modelini temsil eder. Bu yöntem, geliştiricinin olası tüm tehlikeleri tahmin etmesine dayanır. Bu riskli bir öneri olsa da maksimum hızı sunar.

Adım adım yapılandırma

Terminal Command Auto Execution (Terminal Komutunun Otomatik Yürütülmesi) ayarını Turbo olarak belirleyin.
Yanındaki Ekle düğmesini tıklayarak İzin Verilmeyenler Listesi Terminal Komutları'na aşağıdaki komutları ekleyin.
rm
sudo
curl
wget

Reddedilenler listesini test etme

Aracıya sorun: Check the version of python.
Aracı python --version otomatik olarak çalışır.
Temsilciye sorun: Download www.google.com home page.
Temsilci, curl işlemini yapmaya çalışır. Antigravity, kara listede curl karakterini algılar ve yürütmeyi engelleyerek manuel onay ister.

Tarayıcı güvenliği

Antigravity'nin web'e göz atma yeteneği hem bir süper güç hem de bir güvenlik açığıdır. Güvenliği ihlal edilmiş bir doküman sitesini ziyaret eden bir temsilci, istem enjeksiyonu saldırısıyla karşılaşabilir.

Bunu önlemek için tarayıcı aracısı için Tarayıcı URL'si İzin Verilenler Listesi'ni uygulayabilirsiniz.

Bu ayarla ilgili mevcut ayarlarınızı görüntülemek için Antigravity — Settings ve ardından Advanced Settings seçeneğine gidin. Tarayıcı ayarları için aşağıdaki gibi Tarayıcı URL'si İzin Verilenler Listesi bölümünü görmeniz gerekir:

İzin verilenler listesi dosyasını aç'ı tıklayın. Bu işlem, dosyayı klasörde açar. HOME/.gemini/antigravity/browserAllowlist.txt. Yalnızca güvenilen alanların girildiğinden emin olabilirsiniz.

12. Sonuç ve Sonraki Adımlar

Tebrikler! Antigravity'yi başarıyla yüklediniz, ortamınızı yapılandırdınız ve aracılarınızı nasıl kontrol edeceğinizi öğrendiniz.

Sırada ne var? Antigravity'nin gerçek dünya uygulamaları oluştururken nasıl kullanıldığını görmek için aşağıdaki codelab'lere göz atabilirsiniz:

Building with Google Antigravity: Bu codelab'de, dinamik bir konferans web sitesi ve bir üretkenlik uygulaması da dahil olmak üzere çeşitli uygulamaların nasıl oluşturulacağı gösterilmektedir.
Antigravity ile Google Cloud'da Derleme ve Dağıtım: Bu codelab'de, sunucusuz bir uygulamanın nasıl tasarlanacağı, derleneceği ve Google Cloud'da nasıl dağıtılacağı gösterilmektedir.

Referans belgeler

Resmi site : https://antigravity.google/
Belgeler: https://antigravity.google/docs
Kullanım alanları : https://antigravity.google/use-cases
İndirme : https://antigravity.google/download
Google Antigravity'nin YouTube kanalı : https://www.youtube.com/@googleantigravity