1. Giriş
Bu codelab'de, ajanların öne çıktığı bu dönemde geliştirme yapmanıza yardımcı olmak için tasarlanmış bir ajan tabanlı geliştirme platformu olan Google Antigravity hakkında bilgi edineceksiniz. Antigravity 2.0, yapay zeka temsilcilerinizin merkezi kontrol merkezi olarak işlev görür ve etkinliklerini başlatmak, izlemek ve düzenlemek için birleşik bir platform sağlar.
2.0 sürümünün kullanıma sunulmasıyla birlikte Antigravity artık yalnızca bir IDE ile entegre edilmiş bir Ajan Yöneticisi değildir. Artık, önceliğin temsilcide olduğu dönem için tasarlanmış eksiksiz bir ürün ekosistemidir:
- Antigravity: macOS, Linux ve Windows için başlıca bağımsız uygulama. Bu merkez, birden fazla yerel aracıyı paralel olarak yönetmek, planlanmış görevleri çalıştırmak ve daha fazlası için kullanabileceğiniz komuta merkezinizdir. Önceki sürümü olan Agent Manager'dan farklı olarak Antigravity 2.0, bir IDE'den bağımsız olarak çalışan bağımsız bir uygulamadır.
- Antigravity IDE: Tam özellikli, temsilci tabanlı orijinal IDE kullanılmaya devam ediyor (ve geliştiriciler için öneriliyor). Bu özellik; ajan yöneticisi, yapılar ve kod tabanınız hakkında derinlemesine bilgi içerir.
- Antigravity CLI: Terminal tabanlı aracı etkileşimleri için komut satırı arayüzü. Bu konu, bu eğitimde ele alınmayacaktır.
- Antigravity SDK: Geliştiricilerin Antigravity'yi kendi sistemlerine programatik olarak entegre etmelerini sağlayan araçlar. Bu konu, bu eğitimde ele alınmayacaktır.
- IDE'ler için Antigravity: Bu özellik kısa süre önce kullanıma sunuldu. Bu entegrasyon, Antigravity'nin bağımsız aracı özelliklerini doğrudan en sevdiğiniz düzenleyiciye entegre eder. Visual Studio Code, Jetbrains, Zed ve daha fazlası için resmi uzantılar sunar. Bu uzantılardan herhangi birini kullanmak istemiyorsanız yukarıda bahsedilen bağımsız Antigravity IDE'yi kullanabilirsiniz.
Bu codelab'de Antigravity'ye yoğun bir şekilde odaklanacak ve Antigravity IDE'ye kısaca değineceğiz. Diğer iki bileşen olan Antigravity CLI ve Antigravity SDK kapsam dışıdır.
Terminal tabanlı bir uygulama olan Antigravity CLI ile ilgili bir codelab'e göz atmak isterseniz Getting Started with Antigravity CLI (Antigravity CLI'yı Kullanmaya Başlama) başlıklı codelab'i inceleyin.
Neler öğreneceksiniz?
- Antigravity'yi yükleme ve yapılandırma
- Antigravity'nin temel kavramlarını (ör. Ajanlar ve projelerle çalışma) keşfetme
- Antigravity'yi çeşitli ayarlarla ve tercihlerinize göre özelleştirme
Gerekenler
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, her seviyeden kullanıcı ve geliştirici için tasarlanmıştır.
Raporlama sorunları
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 hata bildiriminde bulunun:
Antigravity ile ilgili hatalar veya özellik istekleri için lütfen sorunu Antigravity'de bildirin. Antigravity ürününün sol alt köşesindeki Ayarlar'ı tıklayarak ürün geri bildirimi gönderebilirsiniz. Ardından Provide Feedback seçeneğini belirleyin.
2. Kurulum
Antigravity'yi yükleme
Google Antigravity indirme sayfasına gidin. İşletim sisteminiz (macOS, Linux veya Windows) için Antigravity uygulamasını indirin.
Yükleyiciyi çalıştırın. Aşağıdaki ekran gösterilir:
2 seçeneğiniz vardır:
- Google ile devam et: Burada kişisel Google Hesabınızı kullanabilirsiniz. Antigravity, kişisel Gmail ile başlangıç paketini destekler. Google Hesabınızda Google AI Pro / Ultra paketlerini satın aldıysanız uygun Antigravity kota sınırları uygulanır.
- İşletme hesabını kullan: Bu seçenek, Google Cloud projesine sahip olduğunuz ve kuruluşunuzun lisans satın aldığı bir Enterprise projesinde kullanıyorsanız geçerlidir. Alternatif olarak, Google Cloud projesini Agent Platform ile birlikte kullandıkça öde şeklinde kullanabilirsiniz. Bu seçeneği burada kullanmayacağız.
Google ile Devam Et'i tıklayın ve Google Hesabınızla giriş yapın. Kimlik doğrulamayı tamamlayın. Aşağıdaki bilgiler gösterilmelidir:
Open Antigravity'yi (Antigravity'yi Aç) tıkladığınızda işlemin geri kalanı devam eder.
Tema, Antigravity'yi geliştirmek için kullanabileceğiniz bir veya daha fazla Google eklentisi (Şimdilik bunların hepsini göz ardı edebilirsiniz) ve Şartlar / Koşullar ekranı seçebilirsiniz. İsteği Kabul et'i tıklayın ve Bitir'i tıkladığınızda aşağıdaki gibi bir Antigravity arayüzü görmeniz gerekir:
Birazdan arayüze geçeceğiz ancak şu an için her şey hazır.
Antigravity IDE'yi yükleme
Yukarıdaki ekranda, sağ üst köşede Install Antigravity IDE (Antigravity IDE'yi yükle) düğmesini görmeniz gerekir. Bu işlem sizi Google Antigravity IDE indirme sayfasına yönlendirir. Dilerseniz doğrudan da gidebilirsiniz.
İndir düğmesini tıklayın. Bu işlem sizi, en sevdiğiniz IDE'ler (Visual Studio Code, Zed, Jetbrains vb.) için Antigravity uzantısını indirebileceğiniz veya aşağıda verilen bağımsız Antigravity IDE yükleyicisini indirebileceğiniz bir sayfaya yönlendirir:
Uygun yükleyiciyi indirin. Yükleyiciyi çalıştırın, aynı Google Hesabı ile giriş yapın ve yüklemeye devam edin. IDE, varsayılan işlemler, eklentiler ve daha fazlası gibi her adımda varsayılan ayarları kullanın.
Dock'unuzda iki simge görürsünüz: Antigravity 2.0 (beyaz arka plan) ve Antigravity IDE (siyah ızgara arka plan).
3. Antigravity 2.0 Arayüzü
Henüz yapmadıysanız Antigravity'yi başlatın. İdeal olarak, aşağıdaki gibi bir ekran görmeniz gerekir. Bağımsız Antigravity IDE'yi yüklediyseniz sağ üst köşedeki düğme IDE'yi yükle değil, Antigravity IDE'yi aç olur.
Bu eğitimin ilerleyen bölümlerinde gerektiğinde sol alt köşedeki Ayarlar seçeneğine gideceğiz.
Projeler
Öncelikle Antigravity'deki Projeler kavramını anlayalım. Bu çok önemlidir. Çünkü sağ bölmedeki arayüzde açıkça Proje Seç ifadesi yer alır. Antigravity, aracıların doğru dosyalara, araçlara ve izinlere erişebilmesini sağlamak için proje odaklı bir yaklaşım kullanır.
Proje, ortamı ve aracınızın kapsamını tanımlayan klasörlerin birleşimidir. Bir temsilciyi tek bir klasörde çalışmaya zorlamak yerine, bir proje bir veya birden fazla klasörle (ör.bir ön uç ve bir arka uç deposu) çalışabilir. Böylece, temsilcilerinize kod tabanınız için gereken tüm bağlam sağlanır. Tüm projelerin kendi izole aracı ayarları vardır. Bu sayede farklı projelerin güvenlik ayarlarını bağımsız olarak özelleştirebilirsiniz.
İlk projemizi oluşturalım. Yerel makinenizdeki ana klasörünüzde $HOME/agy2-projects/my-first-project adlı bir klasör oluşturun . Klasörün boş olması gerekmez.
Şimdi, hangi klasörlerin projeyi oluşturduğunu tanımlayarak Antigravity'de ilk projemizi oluşturacağız. Buradaki ilk örneğimizde yalnızca bir klasör ($HOME/agy2-projects/my-first-project.) olacaktır.
Soldaki gezinme çubuğunda Projeler bölümünü görürsünüz. Aşağıda gösterildiği gibi Yeni Proje Oluştur düğmesini tıklayın:
Aşağıda gösterilen seçenekleri görürsünüz. Yeni Proje'yi tıklayın:
Klasör veya Dosya Gezgini'ni açarak projeniz için bir klasör seçmenizi ister. Klasörü seçin. Bu örnekte klasör $HOME/agy2-projects/my-first-project'dır.
Şu anda my-first-project adlı bir proje tanımladık ve bu proje $HOME/agy2-projects/my-first-project adlı bir klasöre işaret ediyor.
Bir projenin yalnızca bir klasörü olup olamayacağını sorabilirsiniz. Hem ön uç kodu hem de arka uç kodu klasörleri içeren bir proje oluşturmak istersem ne yapmalıyım? Antigravity'nin projelerinizle çalışırken tam bağlama sahip olması için daha fazla klasör ekleyebilirsiniz. Belirli bir projenin Proje ayarları'nı (my-first-project) aşağıdaki resimde gösterildiği gibi tıklayın:
Bu işlem, söz konusu proje için Proje Ayarları iletişim kutusunu açar. Klasör Ekle seçeneğiyle daha fazla klasör ekleyebileceğinizi görürsünüz.
Klasör Ekle'yi kullanarak projeye daha fazla klasör ekleyebilirsiniz. Ancak şu an için bu yeterli ve Oluştur düğmesini tıklayabiliriz.
Ayarlar sayfasını kapatabilirsiniz.
Fark edeceğiniz önemli noktalardan biri, "Tüm projelerin kendi izole aracı ayarları vardır. Bu sayede farklı projelerin güvenlik ayarlarını bağımsız olarak özelleştirebilirsiniz." ifadesidir. Bu nedenle, herhangi bir zamanda belirli projeniz için Antigravity'nin davranışını değiştirmek isterseniz Proje Ayarları'na gidip belirli ayarları gerektiği gibi değiştirebilirsiniz.
Basit bir ifadeyle, her proje, ana arayüzdeki Ayarlar üzerinden erişilebilen genel bir yapılandırmadan, yapıtları inceleme, izin verilen araçlar ve MCP sunucusu yapılandırmasıyla ilgili izinleri devralır. Ancak bu izinleri ve daha fazlasını proje bazında ayrı ayrı ayarlayabilirsiniz. Böylece çok daha fazla esneklik elde edebilir, bağlamı ve araçları projenize özel olarak sade ve etkili tutabilirsiniz.
Şimdilik İlk görüşmeyi başlat'ı tıklayarak harika temsilcimize merhaba diyelim. Bunu yaptığınızda aşağıdaki ekranı ve artık hem soldaki proje listesinde hem de Chat arayüzü üzerinden mesaj verdiğinizde temsilcinin çalışacağı proje olarak görünen ilk projemizi görürsünüz. Modeli seçebileceğinizi, + işareti veya @ ya da / işlemleri aracılığıyla ek bağlam iletebileceğinizi unutmayın.
Temsilcimize bir mesajla merhaba diyelim. Temsilcimiz buna göre yanıt verecek.
Haberleri almak için başka bir isteğim var ve bu istek iyi sonuç veriyor.
Görüşmeler
Burada yaptığımız işlem, Projemizde (my-first-project) bir ileti dizisi başlatmak ve şu anda ileti dizisinde bir dizi mesaj (kullanıcı mesajı ve temsilci yanıtları) bulunuyor.
Bu ileti dizisinin tek bir ileti dizisi olarak kaldığını ve projenin altında gruplandırılmış şekilde sol tarafta göründüğünü görürsünüz.
Şimdi ilginç bir şey yapalım ve bu ileti dizisine bir ad verelim. Buna conv-introduction adını verelim.
Bunu yapmak için görüşmenin yanındaki üç dikey noktayı tıklayın. 3 seçenek gösterilir. Yeniden adlandır işlemini seçin.
Değere conv-introduction veya sizin için anlamlı olan herhangi bir adı verin.
Şimdi, projede tamamen yeni bir görüşme başlatmak istiyorsanız aşağıdaki resimde gösterildiği gibi projenin yanındaki + (Projede Yeni Görüşme) işaretini tıklayın.
Artık tamamen yeni bir görüşmeye geçtiniz.
Dünyanın dört bir yanından spor haberleri soralım. Hâlâ my-first-project yani "Dünyanın dört bir yanından spor haberleri ver" projesinde olduğumuzu unutmayın.
Bu, spor dünyasıyla ilgili bazı haberler veriyor ve artık aynı projede iki ileti dizisi olduğunu görebilirsiniz.
Bu görüşmeyi conv-sportsnews olarak yeniden adlandıralım. Şu ana kadar gerçekleşen tüm görüşmeleri görmek isterseniz aşağıdaki resimde gösterildiği gibi sol üstteki Görüşme Geçmişi'ni ziyaret edebilirsiniz:
Dilediğiniz zaman üst kısımdaki Yeni Görüşme seçeneğini kullanarak mevcut projede veya yeni bir projede yeni bir görüşme başlatabilirsiniz.
Proje Ayarları
Şimdi de daha önce bahsettiğimiz Proje Ayarları'na geri dönelim. Antigravity'de proje oluşturduğunuzda varsayılan izinler devralınır. İsterseniz bu izinleri özel olarak geçersiz kılabilirsiniz.
Belirli bir projenin proje ayarlarına gitmek için aşağıdaki resimde gösterildiği gibi sol gezinme çubuğunda ilgili projenin yanındaki ayarlar dişli simgesini tıklayın ve Proje Ayarları'nı tıklayın:
Bu işlem, sizi aşağıdaki resimde gösterildiği gibi belirli bir proje (ör. my-first-project) ayarlarına yönlendirir:
Sol taraftaki projeler bölümünde my-first-project'in seçili olduğunu göreceksiniz. Daha fazla proje varsa bunlar bu listenin altında görünür. Projelerden herhangi birini kolayca seçebilir ve ayarlarını gerektiği gibi değiştirebilirsiniz.
Şimdi sağ tarafa, my-first-project için gösterilen proje ayarlarına odaklanalım. Bu projenin, eklediğimiz tek klasörü içerdiğini göreceksiniz. Buradan daha fazla klasör de ekleyebilirsiniz.
Öncelikle listenin tamamını incelemenizi ve proje özelleştirme gereksinimlerinize göre birçok ayarı değiştirmenize yardımcı olmak için sunulan esnekliği görmenizi öneririz.
Bunlardan bazıları:
- Güvenlik Ön Ayarı: Aracı işlemlerini gerçekleştirmeden önce tüm terminal komutlarının ve dosya erişimlerinin sizin tarafınızdan incelenmesini isteyip istemediğinizi belirleyebilirsiniz.
- Temsilci Davranışı: Örneğin, planı yürütmesini istemeden önce incelemek istediğiniz implementation_plan.md gibi yapay öğeler oluşturulduğunda.
- Erişime izin verilen dosya yolları, Ajan için izin verilen veya engellenen URL'ler gibi çeşitli yerel izinler
- Hatta bu proje için hangi MCP araçlarına izin verileceğini de yapılandırabilirsiniz. Bu, genel olarak yapılandırılmış tüm MCP sunucularının bu projedeki aracıya sunulmasını önlemek için oldukça kullanışlıdır.
Not: İstediğiniz zaman Antigravity arayüzündeki ana ayarlar seçeneğini kullanarak Antigravity'nin veya proje ayarlarının bulunduğu bölüme gidebilirsiniz.
4. Eğik Çizgi Komutları
Antigravity'de kullanabileceğiniz bazı ilginç eğik çizgi / komutları vardır. Sohbet görüşmesi arayüzünüzde / yazarsanız komutları aşağıdaki gibi görürsünüz:
Modelin yürütmeden önce bir uygulama planı oluşturmasını istiyorsanız /plan komutu önemlidir.
/browser komutu, tarayıcıyı başlatmak ve bir işlem yapmasını istemek için kullanılır.
Aşağıda gösterildiği gibi bir web sitesine göz atmayı deneyin:
Bu işlem, Chrome ile bir hata ayıklama oturumu başlatmaya çalışan ve önce izninizi isteyen bir tarayıcı alt aracısı oluşturur:
İzin verdiğinizde tarayıcı siteyi ziyaret eder, en son haberleri alır ve veriler Antigravity'de size geri döndürülür.
/schedule komutu, aracının belirli aralıklarla veya bir programa göre (ör. Pazartesi ve Çarşamba günleri saat 09:00) gerçekleştirmesi için yinelenen veya tek seferlik görevler ayarlamak istiyorsanız kullanışlıdır.
Aynı zamanda, kullanıcı arayüzü üzerinden bu işlemi yapmanız için aynı olanak sağlanır. Bu olanak, sonraki adımda Komutları Planlama bölümünde ele alınır.
5. Komutları planlama
Yinelenen görevleri otomatikleştirmek veya belirli projelerinizde tek seferlik hatırlatıcılar ayarlamak için ana arayüzdeki Zamanla seçeneğini kullanabilirsiniz.
Her gün saat 18:00'deki toplantımızı hatırlatan bir günlük görev oluşturalım. Yeni'yi tıklayın ve ayrıntıları aşağıda gösterildiği gibi doldurun:
Planlanmış Görev Ekle'yi tıkladığınızda görev, aşağıda gösterildiği gibi planlanmış görevler listesine eklenir:
Her 20 dakikada bir ara vermemizi hatırlatan başka bir hatırlatıcı ekleyelim:
Aşağıda gösterildiği gibi, artık iki planlanmış görevimiz var:
Görevlerden herhangi birini devre dışı bırakabilir veya silebilirsiniz. Temel istemler kullandığımızı ancak istemlerinizin ayrıntılı olabileceğini, araçları (harici sistemlerle iletişim kurma) çağırabileceğini ve gereksinimlerinize bağlı olarak düzenli aralıklarla arka planda çok daha fazla iş yapabileceğini unutmayın.
6. Model Bağlam Protokolü (MCP) sunucuları
Model Bağlam Protokolü (MCP), aracıların harici sistemlere bağlanmasına yardımcı olan standarttır. Aracının verileriniz ve entegrasyonunuz açısından temellendirilmiş kalmasını sağlamada önemli bir rol oynarlar.
Antigravity, hem yerel hem de uzak MCP sunucularını destekler. Ayrıca, Google Cloud hizmetleriyle çalışan çeşitli MCP sunucularıyla entegrasyonlar içerir ve bunlar yalnızca birkaç yapılandırma verisiyle tek tıklamayla yüklenir.
Antigravity 2.0'ın en son sürümü, Antigravity'ye MCP sunucusu eklemeyi kolaylaştırır.
Ayarlar → Özelleştirmeler'e gidin. MCP sunucusu yapılandırmasını aşağıdaki gibi görürsünüz:
Yukarıdaki yapılandırmada, aşağıda gösterildiği gibi Yüklü MCP Sunucuları bölümüne gidin:
Open MCP Config (MCP Yapılandırmasını Aç) düğmesini tıklarsanız $HOME/.gemini/config/mcp_config.json içinde bulunan dosyaya yönlendirilirsiniz. Tüm yapılandırmanız bu dosyaya gider. MCP sunucuları yapılandırma dosyasını biliyorsanız dosyadaki içerikleri doğrudan düzenleyip kaydedebilirsiniz.
Şu anda boş olduğunu görebilirsiniz.
MCP sunucusunu yapılandırmak için MCP Ekle düğmesini tıklamanız yeterlidir.
Bu işlem, özellikle MCP sunucuları olarak paketlenmiş Google Cloud hizmetleri olmak üzere çeşitli MCP sunucuları için kullanılabilen ön yapılandırmaların yer aldığı büyük bir listeyi gösterir. Aşağıda bir ekran gösterilmektedir:
İstediğinizi ekleyebilirsiniz. Örneğin, Google Cloud Run MCP Server'ın yanındaki Ekle'yi tıkladım ve bu sunucu yüklendi.
Bu işlem, MCP sunucusunu ve MCP sunucusunun sunduğu araçları aşağıdaki gibi MCP sunucuları listesine ekler. Aşağıdaki belirli araç adı ipucunu tıklayarak bir aracı etkinleştirebilir/devre dışı bırakabilir veya açma / kapama anahtarını kullanarak tüm MCP sunucusunu devre dışı bırakabilirsiniz.
Open MCP Config (MCP Yapılandırmasını Aç) düğmesini tıklarsanız girişin aşağıdaki gibi mcp_config.json dosyasına eklendiğini görürsünüz:
{
"mcpServers": {
"cloudrun": {
"command": "npx",
"args": [
"-y",
"@google-cloud/cloud-run-mcp"
]
}
}
}
Mevcut uzaktan MCP sunucularıyla çalışıyorsanız ayrıntıları $HOME/.gemini/config/mcp_config.json dosyasına eklemeniz yeterlidir.
Yapılandırılmış MCP sunucularını kullanmak için Antigravity'ye MCP sunucusu gerektiren bir soru sorabilirsiniz. Örneğin, cloudrun-mcp sunucusunu etkinleştirip Antigravity'ye Build and deploy a Cloud Run service sorusunu sorabilirsiniz. Bu işlem, Antigravity'nin bir Cloud Run hizmetini yapılandırmak ve dağıtmak için cloudrun-mcp sunucusunu arayıp kullanmasını sağlar.
7. Yapılar
Antigravity, çalışmasını iletmek ve insandan geri bildirim almak için planlama yapıp işini tamamlarken Artifacts oluşturabilir. Bunlar; zengin markdown dosyaları, mimari diyagramlar, resimler, tarayıcı kayıtları, kod farklılıkları vb. olabilir.
Artifacts, güven açığını kapatır. Bir temsilci hatayı düzelttiğini iddia ettiğinde geliştiricinin daha önce kodu okuyarak doğrulaması gerekiyordu. Antigravity'de, temsilci bunu kanıtlamak için bir eser üretiyor.
Antigravity tarafından üretilebilecek başlıca yapılar şunlardır:
Task Lists: Ajan, kod yazmadan önce yapılandırılmış bir plan oluşturmayı seçebilir. Genellikle bu planı düzenlemeniz gerekmez ancak inceleyebilir ve gerekirse değiştirmek için yorum ekleyebilirsiniz.Implementation Plan: /plan komutu kullanıldığında bir görevi tamamlamaya başlamadan önce uygulama planı oluşturulur. Bu planlar, hangi düzeltmelerin gerekli olduğuna dair teknik ayrıntılar içerir ve Her Zaman Devam Et olarak ayarlanmış bir yapıt yorum politikası yoksa kullanıcı tarafından incelenmek üzere tasarlanmıştır.Walkthrough: Bu, değişikliklerin özeti ve nasıl test edileceği hakkında bilgi vermek için, ajan görev uygulamasını tamamladıktan sonra oluşturulabilir.Code diffs: Antigravity, teknik olarak bir yapay ürün olmasa da inceleyip yorum yapabileceğiniz kod farklılıkları da oluşturur.Screenshots: Ajan, kullanıcı arayüzünün durumunu değişiklikten önce ve sonra yakalayabilir.
Öğeleri daha iyi anlamak için aşağıdaki istemi ve /plan komutunu kullanarak yeni veya mevcut bir projeyle sohbet oluşturun:
/plan Design a Node application that I can run from the command line to get me the latest news from Google.
Temsilci, ilk yapıtımız olan Uygulama Planı ile geri dönüyor.
Sağ üst köşede gösterilen Yardımcı Bölme'yi açıp kapatarak Antigravity tarafından üretilen tüm yapay nesnelere bakabilirsiniz.
Yardımcı Bölme'yi açıp kapatırsanız 1 Yapı (Uygulama Planı) oluşturulduğunu belirten aşağıdaki çıkışı görürsünüz.
Ayrıntıları görmek için aşağıdaki resimde gösterildiği gibi Uygulama Planı'nı tıklayın:
Şimdilik planı kabul ediyoruz ve devam etmek için Devam düğmesini tıklıyoruz.
Devam etmek için izin istenebilir. Lütfen bu izni verin.
Her şey tamamlanıp test edilip Temsilci tarafından doğrulandığında, görevin tamamlandığını belirten bir mesaj alırsınız.
Görebileceğiniz bir diğer öğe de aşağıdaki gibi dosya farklılıklarıyla birlikte Walkthrough'dur.
Oluşturulan dosyaları görüntülemek için tam teşekküllü bir düzenleyici / IDE'ye ihtiyacınız olmayabilir. package.json veya index.js dosyalarını tıklayarak içeriği görebilir ve yorum yapabilirsiniz.
8. Antigravity IDE
IDE kullanmayı tercih ederseniz bu codelab'de daha önce yüklediğimiz Antigravity IDE'yi kullanabilirsiniz. Ana Antigravity arayüzünde Yardımcı Paneli açıp kapatmaya çalıştığınızda IDE'yi Aç seçeneğinin olduğunu görürsünüz.
Antigravity IDE'yi açmak için bu seçeneği tıklayın. Antigravity IDE'nin başlatılması sırasında şu uyarıyı görebilirsiniz:
Normal bir durumdur. Evet'i tıklayın. Bu işlem, daha önce IDE kullanmış olan herkesin aşina olduğu Antigravity IDE'yi açar. Oluşturulan tüm klasörleri/dosyaları, bir düzenleyiciyi ve Agent Panel'i içerir. Bu panelde, kodla ilgili olarak Agent ile sohbet edebilirsiniz (açıklama, oluşturma, düzeltme vb.).
9. Beceri
Antigravity'nin temelini oluşturan modeller güçlü genellemeler yapsa da projenizin bağlamını veya ekibinizin standartlarını bilmez. Her kuralı veya aracı aracının bağlam penceresine yüklemek, araçların şişmesine, maliyetlerin artmasına, gecikmeye ve kafa karışıklığına yol açar.
Beceriler, ilerleme durumu açıklamasıyla bu sorunu çözer. Beceri, ihtiyaç duyulana kadar kullanılmayan özel bir bilgi paketidir. Yalnızca belirli isteğiniz becerinin açıklamasıyla eşleştiğinde temsilcinin bağlamına yüklenir .
Yapı ve Kapsam
Beceriler, dizine dayalı paketlerdir. İhtiyaçlarınıza bağlı olarak bunları iki kapsamda tanımlayabilirsiniz:
- Global Kapsam (
~/.gemini/config/skills/): Tüm Antigravity ürünlerinde (Antigravity, Antigravity IDE, Antigravity CLI) ve projelerinde kullanılabilir. - Proje/Workspace Kapsamı (
<project-root>/.agents/skills/): Bu seçenek, becerinin yalnızca belirli bir proje içinde kullanılabilmesini sağlar.
Becerinin 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ının, kod değişikliklerini hatalar, stil sorunları ve en iyi uygulamalar açısından incelemesi için ayrıntılar sağlayan bir beceri oluşturalım.
Belirli bir proje klasöründe olduğunuzu varsayarsak (ör. $HOME/agy2-projects/my-skills-project)), ilk adım proje klasöründe beceriyi içerecek bir dizin oluşturmaktır.
mkdir -p .agents/skills/code-review
Yeni oluşturduğumuz proje klasöründe (ör. .agents/skills/code-review) aşağıdaki içerikle 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 üstünde meta verilerin (ad ve açıklama), ardından talimatların yer aldığını unutmayın. Aracı yüklendiğinde yalnızca becerilerin meta verilerini okur ve tam beceri talimatlarını yalnızca gerektiğinde yükler.
Kod İnceleme becerisini doğrulayalım. Antigravity'de istediğiniz bir projede bir görüşme açın ve aşağıdaki istemi girin.
code-review becerisi gösterilmelidir.
Deneyin
$HOME/agy2-projects/my-skills-project dizininde aşağıdaki içeriklerle demo_bad_code.py adlı yeni 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()
Antigravity'de belirli bir projede yeni bir görüşme açın ve şu istemi girin: review the @demo_bad_code.py file.
Ajan, code-review becerisini tanımlamalı, 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:
10. Sonuç
Tebrikler! Antigravity 2.0'ı 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 2.0'ın gerçek dünya uygulamaları oluştururken nasıl çalıştığını görmek için aşağıdaki codelab'e göz atabilirsiniz:
- Antigravity ile Google Cloud'da Derleme ve Dağıtım: Bu codelab'de, sunucusuz bir uygulamanın Google Cloud'da nasıl tasarlanacağı, oluşturulacağı ve dağıtılacağı gösterilmektedir.
Referans belgeler
- Resmi site : https://antigravity.google/
- Belgeler: https://antigravity.google/docs/home
- Kullanım alanları : https://antigravity.google/use-cases
- https://antigravity.google/download
- Google Antigravity'nin YouTube kanalı : https://www.youtube.com/@googleantigravity