Google Antigravity'yi kullanmaya başlama

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 komuta merkezi olarak görev yapar 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 Agent Manager 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 temel bağımsız uygulama. Bu, birden fazla yerel aracıyı paralel olarak yönetmek, planlanmış görevleri çalıştırmak ve daha fazlası için kullanabileceğiniz komuta merkezinizdir. Antigravity 2.0, önceki sürümü olan Agent Manager'dan farklı olarak bir IDE'den bağımsız çalışan tek başına 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ın derinlemesine anlaşılmasıyla birlikte gelir.
  • 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.

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ışındadır.

Terminal tabanlı bir uygulama olan Antigravity CLI ile ilgili bir codelab'e göz atmak isterseniz Antigravity CLI'yı Kullanmaya Başlama adlı codelab'i inceleyin.

Neler öğreneceksiniz?

  • Antigravity'yi yükleme ve yapılandırma
  • Antigravity'nin temel kavramlarını (ör. Agent'larla ve Workspace'lerle çalışma) keşfetme
  • Yerçekimsizliği ç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ı.
  • Bir Gmail hesabı (kişisel Gmail hesabı).

Bu codelab, her seviyeden kullanıcı ve geliştirici için tasarlanmıştır.

Raporlama sorunları

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:

e7d8a6055a16a773.png

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.

31e6370c1744fe73.png

Yükleyiciyi çalıştırın. Aşağıdaki ekran gösterilir:

4783c8ff21fbc6e7.png

Google Hesabınızla giriş yapın. Kimlik doğrulama işlemini tamamlayın. Aşağıdaki bilgiler gösterilmelidir:

12fa8752446a0458.png

Open Antigravity'yi (Antigravity'yi aç) tıklayın. Güvenlik ve Veri Kullanımı Politikası gösterilir. Sonraki'yi tıklayın.

8f2fe904767c34b.png

Beğendiğiniz bir temayı seçin:

cc2466b518c241c9.png

Antigravity, çeşitli Google Geliştirici Araçları ile çalışan bir dizi eklentiyle birlikte gelir. Bu eklentiler, Antigravity'nin Google'ın çeşitli geliştirici araçlarıyla çalışmasına yardımcı olan bir dizi beceri yükler. İsteğe bağlı olarak yükleyebileceğiniz eklentilerin listesini aşağıda bulabilirsiniz. Bu eklentiler, codelab'de ele alınmayacaktır. Son'u tıklayın.

3919ac5f462a5dfc.png

Antigravity arayüzünü aşağıdaki gibi görmeniz gerekir:

319cf98d41231a82.png

Antigravity IDE'yi yükleme

İsteğe bağlı olarak Antigravity IDE'yi yükleyebilirsiniz. Google Antigravity indirme sayfasına gidin. Antigravity IDE indirmeleri bölümüne gidin.

6d05924ef8098ae.png

Hem Antigravity hem de Antigravity IDE başarıyla yüklendikten sonra dock'unuzda iki simge görürsünüz: Antigravity (beyaz arka plan) ve Antigravity IDE (siyah ızgara arka plan).

97b7906262ed8246.png

3. Antigravity Arayüzü

Başlamaya hazırız. Öncelikle Antigravity'yi kullanmaya odaklanalım. İlk Antigravity ekranı şuna benzer:

4b2ebaf5bbaa6a27.png

Bu eğitimde ilerledikçe sol alt köşedeki Ayarlar seçeneğine ihtiyacımız oldukça değineceğiz.

Projeler

Öncelikle Antigravity'de 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şebilmesi 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 daha fazla klasörle (ör.ön uç ve 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. İlk örneğimizde tek bir klasör olacaktır.

Aşağıda gösterildiği gibi Proje Seç → Yeni Proje'yi tıklayın:

8fb15004219d1d6d.png

Beklendiği gibi, aşağıda gösterildiği şekilde Klasör seçin seçeneğini tıklamanızı ister:

3b194f9234cbf9ca.png

Klasör Ekle'yi tıklayın ve belirli bir klasörü seçmek için klasöre gidin. Örneğin: $HOME/agy2-projects/my-first-project

f907f3b64cf0d6a0.png

Klasör Ekle'yi kullanarak projeye daha fazla klasör ekleyebilirsiniz ancak şimdilik Sonraki düğmesini tıklayabiliriz.

Bu işlem, aşağıda gösterildiği gibi bir iletişim kutusu açar. Tüm projelerin kendi izole aracı ayarları vardır. Bu sayede, farklı proje güvenlik ayarlarını bağımsız olarak özelleştirebilirsiniz.

45a29e5c40bf3ae7.png

Her proje, ana arayüzdeki Ayarlar üzerinden erişilebilen genel bir yapılandırmadan, yapay nesneleri inceleme, izin verilen araçlar ve Model Context Protocol (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 Varsayılan seçeneğini belirleyin.

Ayrıca, projenizi sonraki iletişim kutusunda adlandırabilir ve Oluştur'u tıklayabilirsiniz:

529d6c23ef880f5.png

Şimdi aşağıdaki ekranı görürsünüz. Proje, proje listesinde ve gösterildiği gibi sohbet arayüzünde görünür. Modeli seçebileceğinizi, + işareti veya @ ya da / işlemleri aracılığıyla ek bağlam iletebileceğinizi ve daha fazlasını yapabileceğinizi unutmayın.

f2bfdb27bc878643.png

Temsilciye mesajla merhaba dediğinizde temsilci buna göre yanıt verir.

7e4027bd7a9505e3.png

Haberleri almak için başka bir isteğimiz var ve bu istek iyi sonuç veriyor.

a5b751531e25f2d3.png

Görüşmeler

Projemizde (my-first-project) bir ileti dizisi başlattık ve şu anda dizide bir dizi ileti (kullanıcı iletisi ve aracı yanıtları) bulunuyor.

Soldaki bu ileti dizisinin proje altında gruplandırıldığını görürsünüz.

e650cbd24d8b66ca.png

Şimdi de ilginç bir şey yapalım ve bu ileti dizisine bir ad verelim. Buna conv-introduction (dönüşüm tanıtımı) 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.

244d0bd0fce7a213.png

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.

7b834450020d8c03.png

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 içinde olduğumuzu unutmayın.

4b3208b40a03b6d1.png

Bu, spor dünyasıyla ilgili bazı haberler veriyor. Aynı projede artık iki ileti dizisi olduğunu görebilirsiniz.

aaf65af4b2791423.png

Bu görüşmeyi conv-sportsnews olarak yeniden adlandıralım. Şimdiye 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:

3ed91bba75d70871.png

İstediğ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 geçersiz kılabilirsiniz.

Belirli bir projenin proje ayarlarına gitmek için sol gezinme çubuğunda her projenin yanındaki ayarlar dişli simgesini tıklayın.

7f7158d07780eba9.png

Bu işlem, sizi aşağıda gösterildiği gibi belirli bir proje (ör. my-first-project) ayarlarına yönlendirir:

d73f96c9f4f8f61b.png

Sol tarafta, projeler bölümünde my-first-project'in seçili olduğunu göreceksiniz. Daha fazla proje olsaydı bunlar bu listenin altında görünürdü. 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 projeye eklediğimiz tek klasörün burada olduğunu göreceksiniz. Buradan daha fazla klasör de ekleyebilirsiniz.

Öncelikle listenin tamamını incelemenizi ve proje özelleştirme gereksinimlerinize göre çok sayıda ayarı değiştirmenize yardımcı olmak için artık sunulan esnekliği görmenizi öneririz.

Bunlardan bazıları:

  • Güvenlik Ön Ayarı: Aracının işlem yapabilmesi için tüm terminal komutlarının ve dosya erişimlerinin sizin tarafınızdan incelenip incelenmeyeceğini belirler.
  • Aracının Davranışı: Aracının, uygulama planını incelemenizle birlikte mi yoksa incelemeniz olmadan mı yürüteceğini belirler.
  • Çeşitli Yerel İzinler Dosya yolları, URL'ler vb. aracının erişimine izin verilir veya engellenir.
  • 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 veya proje ayarlarına gidebilirsiniz.

9632f5815b5f00c5.png

4. Eğik Çizgi Komutları

Antigravity'de eğik çizgiyle / başlayan bazı ilginç komutlar vardır. Sohbet görüşmesi arayüzünüzde / yazarsanız komutları aşağıdaki gibi görürsünüz:

a6b3198f2b693d8d.png

/browser komutunu kullanabilirsiniz. Tarayıcıyı başlatmak ve bir işlem yapmasını istemek için kullanılan açık bir komuttur. Hata ayıklama oturumu başlatmak için Google Chrome ve Google Chrome'da izin gerekir.

1a23771f8cc1f7d2.png

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:

1380710b74477b94.png

İzin verdiğinizde, gerektiğinde izin ister ve ayrıntıları alır.

8620b739bc192f7.png

6d592e977d54337b.png

/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ştireceği yinelenen veya tek seferlik görevler ayarlamak istediğinizde kullanışlıdır.

Aynı zamanda, bu işlemi kullanıcı arayüzü üzerinden 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. Planlama Komutları

Tekrarlayan görevleri otomatikleştirmek veya belirli projelerinizde tek seferlik hatırlatıcılar ayarlamak için ana arayüzdeki Planla seçeneğini kullanabilirsiniz.

4749901a164cd1ad.png

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:

41865ad9a5242407.png

Zamanlanmış Görev Ekle'yi tıkladığınızda görev, aşağıda gösterildiği gibi zamanlanmış görevler listesine eklenir:

a4cecc4896c59893.png

Her 20 dakikada bir ara vermemizi hatırlatacak başka bir hatırlatıcı ekleyelim:

e3b75ee01010eb9.png

Aşağıda gösterildiği gibi artık iki planlanmış görevimiz var:

6d122472143e48f3.png

Görevlerin 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 Context Protocol (MCP) sunucuları

Model Context Protocol (MCP), aracıların harici sistemlere bağlanmasına yardımcı olan standart olarak ortaya çıkmıştı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 birkaç yapılandırma verisiyle tek tıklamayla kurulabilir.

Öncelikle, önceden yapılandırılmış MCP sunucusu seçeneklerinin listesine bakalım. Yeni bir sunucu eklemek için Ayarlar → Özelleştirmeler'e gidin ve MCP+ ekle düğmesini tıklayın. Bu işlem, sunucuların tam listesini görebileceğiniz bir iletişim kutusu açar:

dbde58f6f5f99df9.png

Herhangi bir MCP sunucusu eklemek için +Ekle düğmesini tıklayın. MCP sunucusuna bağlı olarak proje kimliği ve veritabanı ayrıntıları gibi birkaç bilgi sağlamanız gerekir.

Mevcut MCP sunucularını ekleme

Arka planda, MCP sunucuları $HOME/.gemini/config/mcp_config.json dosyasında yapılandırılır. Mevcut uzak MCP sunucularıyla çalışıyorsanız ayrıntıları bu dosyaya eklemeniz yeterlidir. Özel MCP sunucularını yapılandırma bölümünü buradan inceleyin.

Uzak MCP sunucularınızı ekleyip dosyayı kaydettikten sonra Antigravity'deki MCP sunucuları bölümüne aşağıdaki şekilde gidebilirsiniz:

  1. Ana Antigravity arayüzünde Ayarlar'ı tıklayın.
  2. Özelleştirmeler'e gidin. MCP sunucularını hâlâ görmüyorsanız Yenile'yi tıklayın.

7d004eba523578fd.png

  1. İsterseniz Açma/kapatma düğmesini kullanarak MCP sunucularından herhangi birini devre dışı bırakabilirsiniz. Alternatif olarak, MCP sunucularından herhangi birini tıklayıp sunucu tarafından kullanıma sunulan araçları görebilirsiniz.

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 şunları sorabilirsiniz: Build and deploy a Cloud Run service. 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, işini planlayıp yaparken Artifacts oluşturur. Bu sayede, yaptığı işi anlatı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.

Artifacts, güven açığını kapatır. Bir temsilci hatayı düzelttiğini iddia ettiğinde geliştiricinin bunu doğrulamak için kodu okuması gerekiyordu. Antigravity'de ajan, bunu kanıtlamak için bir eser üretiyor.

Antigravity tarafından üretilen başlıca yapılar şunlardır:

  • Task Lists: Temsilci, kod yazmadan önce yapılandırılmış bir plan oluşturur. Genellikle bu planı 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 düzeltmelerin gerekli olduğuna dair teknik ayrıntılar içerir ve yapıt inceleme politikanız Her Zaman Devam Et olarak ayarlanmadığı sürece 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, görev uygulaması tamamlandıktan sonra oluşturulur.
  • 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 değişikliğin öncesi ve sonrası durumunu yakalar.

Öğeleri daha iyi anlamak için aşağıdaki istemi kullanarak yeni veya mevcut bir projeyle sohbet oluşturun:

Write a node application that I can run from the command line to get me the latest news from Google.

Temsilci, ilk yapay ürünümüz olan Uygulama Planı ile geri dönüyor.

37333333a7794098.png

Sağ üst köşede gösterilen Yardımcı Bölme'yi açıp kapatarak Antigravity tarafından üretilen tüm yapay nesnelere bakabilirsiniz.

94738a4b59d84fd7.png

Yardımcı Bölme'yi açıp kapatırsanız 1 Yapı oluşturulduğunu (Uygulama Planı) belirten aşağıdaki çıktıyı görürsünüz.

3ad614ce81650142.png

Ayrıntıları görmek için aşağıdaki resimde gösterildiği gibi Uygulama Planı'nı tıklayın:

90e8ccae66dba76b.png

Şimdilik planı kabul ediyoruz ve devam etmek için Devam düğmesini tıklıyoruz.

Şimdi, çalışmaya başlarken Görev Planı adlı başka bir yapay nesne ve diğer dosyaları oluşturur. Tüm bunları, aşağıdaki resimde gösterildiği gibi Yardımcı Bölme'de görebilirsiniz:

5e7c8edfff5390ee.png

Görev yapay nesnesini tıkladığınızda, belirlediğiniz hedefe ulaşmak için adım adım görev listesini, hangi adımların tamamlandığını ve hangilerinin henüz tamamlanmadığını görürsünüz.

a18a60fc2a5c136f.png

Son olarak, her şey tamamlanıp Temsilci tarafından test edilip doğrulandığında görevin tamamlandığını belirten bir mesaj alırsınız. Walkthrough (Adım Adım Açıklama) adlı başka bir yapay öğe kullanıma sunuldu. Son listeyi aşağıdaki gibi görebilirsiniz:

125f41b0a983f57a.png

Artifacts (Görev, Yol Gösterici ve Uygulama Planı) dışında Kaynak Dosyaları (package.json, index.js) da olduğunu unutmayın.

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'in önceki bölümlerinde yüklediğimiz Antigravity IDE'yi kullanabilirsiniz. Ana Antigravity arayüzünde Yardımcı Paneli açıp kapatmaya gittiğinizde Open IDE (IDE'yi Aç) seçeneğinin olduğunu görürsünüz.

94738a4b59d84fd7.png

Antigravity IDE'yi açmak için bu seçeneği tıklayın. Antigravity IDE'nin başlatılması sırasında aşağıdaki gibi bir uyarı görebilirsiniz:

d5919244c996af7f.png

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

f6af75f8e99cbbc6.png

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, aşamalı ifşa yoluyla 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/Çalışma Alanı Kapsamı (<project-root>/.agents/skills/): Bu seçenek, becerinin yalnızca belirli bir proje içinde kullanılabilmesini sağlar.

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ı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 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. Aracı yüklendiğinde yalnızca becerilerin meta verilerini okur ve yalnızca gerektiğinde becerilerin tam talimatlarını yükler.

Kod inceleme becerisini doğrulayalım. Antigravity'de istediğiniz bir projede bir görüşme açın ve aşağıdaki istemi girin.

732820afe6db3ce0.png

code-review becerisi gösterilmelidir.

Deneyin

$HOME/agy2-projects/my-skills-project dizininde, aşağıda gösterilen 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:

a6e2b1b775feda28.png

10. Sonuç

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.

Kaggle 5-Day AI Agents rozetinizi kazanın

Bu laboratuvarı Kaggle'ın 5-Day AI Agents: Intensive Vibe Coding Course with Google (5 Günde Yapay Zeka Ajanları: Google ile Yoğun Vibe Kodlama Kursu) kapsamında mı tamamladınız? Tamamlama rozetinizi talep edin: 5 Günlük Yapay Zeka Ajanları Rozeti'ni alın.

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'e göz atabilirsiniz:

Referans belgeler