1. Giriş
Antigravity, herkesin temsilci odaklı dönemde geliştirmeler yapmasına yardımcı olmak için tasarlanmış bir temsilci tabanlı geliştirme platformudur. Antigravity, Antigravity IDE, Antigravity CLI ve Antigravity SDK olmak üzere dört ana üründen oluşur.
Bu codelab'de yalnızca geliştiriciler için Antigravity IDE'ye odaklanacağız.
Neler öğreneceksiniz?
- Antigravity platformunu anlama
- Antigravity IDE'yi yükleyin.
- Antigravity düzenleyicisini ve aracı panelini keşfedin.
- Eğik çizgi komutları
- Özelleştirmeler, MCP sunucuları ve beceriler.
İhtiyacınız olanlar
Antigravity IDE'nin sisteminize (Mac, Windows ve belirli Linux dağıtımları) yerel olarak yüklenmesi gerekir. Ayrıca aşağıdakilere de ihtiyacınız olacaktır:
- Chrome web tarayıcısı.
- Bir Gmail hesabı (kişisel Gmail hesabı).
Sorunları 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. 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. Antigravity Platformu
Antigravity IDE'ye odaklanmadan önce Antigravity platformunu anlayalım.
Antigravity 4 ayrı üründen oluşur:
- Antigravity: Birden fazla yerel temsilciyi paralel olarak yönetebileceğiniz, bağımsız ana uygulama ve komuta merkeziniz.
- Antigravity IDE: Geliştiriciler için tam özellikli, temsilci tabanlı IDE.
- Antigravity CLI: Terminal tabanlı aracı etkileşimleri için komut satırı arayüzü.
- Antigravity SDK'sı: Geliştiricilerin Antigravity'yi kendi sistemlerine programatik olarak entegre etmelerini sağlayan araçlar.
Tüm ürünler aynı temel Antigravity temsilcilerine erişim sağlasa da etkileşim düzeyi farklıdır.
Antigravity'de temsilcilerle daha üst düzeyde çalışırsınız. Temsilciyle yaptığınız görüşmelerde, oluşturmasını istediğiniz şeyi açıklarsınız ve kodla ilgilenmesini sağlarsınız. Oluşturulan kodu görebilirsiniz ancak kodu kendiniz incelemeniz gerekmez.
Antigravity IDE'de daha düşük bir kodlama düzeyindesiniz. Ajan paneli üzerinden ajanla konuşmaya devam edebilirsiniz. Ayrıca, kodun tam görünümünü elde edebilir ve kod oluşturup düzenlerken ajandan yardım alabilirsiniz.
Antigravity CLI'da, komut satırı arayüzündeki aracıları kullanıyorsunuz. Yine de temsilciyle konuşabilir ve kod oluşturup düzenlemesini sağlayabilirsiniz ancak her şey terminalde gerçekleşir.
Hangi seviyeyi seçeceğiniz size kalmıştır. Genellikle Antigravity'de daha yüksek bir düzeyde geliştirmeye başlarsınız ve karmaşıklık arttıkça kodlama için Antigravity IDE'ye veya daha terminal dostu görevler için Antigravity CLI'ye geçersiniz.
3. Kurulum
Antigravity uygulamasını yüklediyseniz ancak Antigravity IDE'yi henüz yüklemediyseniz sağ üst köşede IDE'yi yükle düğmesini görürsünüz:
Bu düğmeyi tıklayabilir veya işletim sisteminiz (macOS, Windows, Linux) için Antigravity IDE'yi indirmek ve yüklemek üzere doğrudan Antigravity IDE indirme sayfasına gidebilirsiniz.
Yükleme tamamlandıktan sonra karşılama ekranı gösterilir:
Google Hesabınızla giriş yapın ve temanızı seçerek yüklemeye devam edin.
Bir noktada, Antigravity IDE aracısını nasıl kullanmak istediğiniz sorulur. Bu ekranda, aracı için terminal yürütme politikasını, politika incelemesini ve JavaScript yürütme politikasını ayarlayabilirsiniz. Şimdilik İncelemeye dayalı geliştirme'yi seçin.
Sonraki ekranda uzantıları ve agy-ide komut satırı aracını yapılandırabilirsiniz. Yalnızca ihtiyacınız olan uzantıları yüklemenizi öneririz.
Antigravity IDE, aracıların Google geliştirici ürünleriyle çalışmasına yardımcı olmak için beceri ve MCP'lerin paketlenmiş koleksiyonları olan eklentilerle birlikte gelir. Çalışmanız için faydalı olabileceğini düşündüğünüz seçenekleri belirleyin:
Artık Antigravity IDE'yi kullanmaya hazırsınız.
4. Antigravity IDE Arayüzü
Antigravity IDE'yi ilk kez başlattığınızda ana Antigravity IDE arayüzünü görürsünüz.
Önce yerel bir klasör açarak başlayabilirsiniz. Ayrıca Terminal ve ardından New Terminal menü öğesi aracılığıyla yeni bir terminal açmanız da önerilir.
Artık düzenleyici, terminal ve temsilci kullanıma hazır:
Düzenleyicide kod yazarken Antigravity'den yapay zeka yardımı alırsınız. Ajan paneli, ajanla sohbet ettiğiniz, farklı modeller seçtiğiniz ve dosya ile komutlara başvurduğunuz yerdir. Terminal varsayılan olarak yapay zeka destekli değildir ancak Antigravity CLI'yı yüklerseniz agy komutuyla başlatabilir ve terminalde yapay zeka yardımından yararlanabilirsiniz.
Antigravity Ayarları
Sağ alt köşedeki Antigravity Ayarları'na göz atmanız önerilir. Ajanın temel ayarlarını içerir:
Gelişmiş Ayarlar, aracı güvenlik modu gibi daha fazla ayar sunar:
Bu sayede, terminal komutları ve dosya sistemi erişimi gibi konularda ajanın ne kadar özgür olacağını belirleyebilirsiniz. Bu ayarları inceleyip projeniz için uygun olanları seçtiğinizden emin olun.
5. Düzenleyici
Düzenleyiciyi inceleyelim. Düzenleyici özelliklerini keşfetmek için hello.py Python dosyası oluşturun.
Düzenleyicide hello.py kodunu yazarken akıllı otomatik tamamlama özelliği devreye girer. Bu özelliği Tab tuşuna basarak kabul edebilirsiniz:
İmleci kodda bir sonraki mantıksal yere taşımak için sekme ile atlama önerileri alırsınız. Örneğin, main() yazmayı bitirdiğinizde düzenleyici, ana yönteme gitmenizi ister:
Ayrıca, eksik bağımlılıkları eklemek için içe aktarma sekmesi önerisi de alırsınız:
6. Temsilci Paneli
Sağ tarafta, temsilci yan panelini görürsünüz. Görünmüyorsa Cmd + L kısayoluyla açıp kapatabilirsiniz.
Farklı model türleri seçebilir, @ simgesini kullanarak dosyalar, dizinler, terminal, MCP sunucuları gibi daha fazla bağlam ekleyebilir veya / simgesini kullanarak komutlar ekleyebilirsiniz (sonraki bir adımda ele alınacaktır).
Temsilciyle etkileşim kurmanın en kolay yolu, sohbette soru sormaya başlamaktır ancak temsilciyle etkileşim kurmanın birden fazla yolu vardır.
Statik bir linter yüklüyse (ör. Pylint), hata yaptığınızda kodda söz dizimi hataları görürsünüz. Düzenleyicide bir sorunun üzerine gelip Explain and fix simgesini seçerseniz . Bu işlem, ajandan açıklama ve olası bir düzeltme almak için aracı panelini açar:
Ayrıca, IDE'nin Problems sekmesine gidip Send to Agent seçeneğini belirleyerek aracının bu sorunları düzeltmesini sağlayabilirsiniz:
Ayrıca, terminal çıkışının hata içeren bir bölümünü seçip Cmd + L ile temsilci sohbetine gönderebilirsiniz:
Temsilciyle sohbet ederken giriş penceresinin üst kısmında bazı simgeler görürsünüz:
Bunlar; Değişikliklere Genel Bakış (kod değişikliklerini görmek için), Terminal (arka plan işlemleri), Yapılar ve Tarayıcı'dır.
7. Yapılar
Antigravity'nin temelinde, geliştirme sürecinin 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:
- Kodlamadan önce: Bir uygulama planı ve görev listesi.
- Kod oluştururken: Kod farklılıkları.
- Kodlamadan sonra: Ne yaptığını açıklayan ve sonuçları doğrulayan bir kılavuz.
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, ajanı istediğiniz yöne etkili bir şekilde yönlendirmek için çok yararlıdır.
Basit bir uygulama oluşturmayı deneyelim ve bu süreçte Antigravity'ye nasıl geri bildirim sağlayabileceğimizi görelim.
Temsilci yan panelinde şu istemi deneyin:
Build a TODO list application with Python Flask, SQlite DB, and a CRUD frontend. Keep the application simple
Bu işlem, ajanın planlama yapmaya ve bir uygulama planı oluşturmaya başlaması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.
Birkaç saniye içinde görüşmede bir uygulama planı görürsünüz:
Memnun kaldıysanız Proceed düğmesini tıklayabilirsiniz. Geri bildirimde bulunmak isterseniz uygulama planını açabilir ve göndermeden önce Google Dokümanlar tarzında yorumlar ekleyebilirsiniz.
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 izleyeceği adımların somut bir listesidir. Bu liste, Antigravity'nin ilerleme durumunu bildirmesinin bir yoludur:
Kod değişiklikleri
Bu noktada Antigravity, yeni dosyalarda bazı kodlar oluşturur. Ayrıntılara bakmadan bu değişiklikleri temsilci sohbeti yan panelinde 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.
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çabilir. Görev ekleme, görev güncelleme gibi bazı manuel testler yapar. Son olarak, uygulamayı doğrulamak için yaptığı işlemleri özetleyen bir açıklama dosyası oluşturur. Bu dosyada ekran görüntüsü veya tarayıcı kaydı içeren bir doğrulama akışı yer alabilir.
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.
8. Eğik Çizgi Komutları
Antigravity IDE'de yerleşik eğik çizgiyle başlayan komutlar / bulunur. Aracı yan panelinde / yazarsanız komut listesini görürsünüz:
/goal, ajana bir görevi tamamlanana kadar çalıştırması talimatını verirken /schedule, görevlerin yinelenen veya tek seferlik görevler olarak planlanmasına olanak tanır. /grill-me, ajanla bir plan üzerinde anlaşmak için, /learn ise görüşmelerden yeniden kullanılabilir beceriler veya kurallar çıkarmak için kullanışlıdır.
Bu komutları deneyerek size nasıl yardımcı olabileceklerini görün.
9. Özelleştirmeler
Antigravity IDE'de birkaç özelleştirme seçeneği bulunur: Kurallar ve İş Akışları.
Sağ üst köşedeki ... simgesini tıklayın ve Customizations seçeneğini belirleyin. Rules ve Workflows simgelerini görürsünüz:
Kurallar, ajanın davranışını yönlendirmeye yardımcı olur. Bunlar, aracı 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ı, ajanla 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/config/global_workflows/<YOUR_WORKFLOW_NAME>.md - Çalışma alanı kuralları:
your-workspace/.agents/rules/ - Workspace iş akışları:
your-workspace/.agents/workflows/
Çalışma alanına bazı kurallar ve iş akışları ekleyelim.
Kural ekleyin
Ö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şturulduğundan emin olmak 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, aracı yan paneline gidin ve aracıya ş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.
10. 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 IDE, 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.
Sağ üst köşedeki ... simgesini tıklayın ve MCP Servers seçeneğini belirleyin. Bu işlem, MCP sunucularının listesini görebileceğiniz bir iletişim kutusu açar:
Örneğin, MCP sunucusunu yüklemek için Cloud Run'ı tıklayabilirsiniz.
Sağ üstteki Manage MCP Servers simgesini tıklarsanız ~/.gemini/config/mcp_config.json bölümünde ham MCP sunucu yapılandırmasını da görebilirsiniz. Bu dosyaya başka özel MCP sunucuları da ekleyebilir ve Antigravity IDE'de tanındıklarını görmek için yenileme düğmesine basabilirsiniz.
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.
11. 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ç şişmesine, daha yüksek maliyetlere, gecikmeye ve kafa karışıklığına yol açar.
Beceriler, bu sorunu aşamalı açıklama yoluyla çö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.
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 bir beceri 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.
Proje klasöründe beceriyi içerecek bir dizin oluşturun:
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 talimatlarının tamamını yükler.
Beceri doğrulansın. Antigravity ile yeni bir sohbet başlatın ve hangi becerilerin yüklü olduğunu sorun. code-review becerisini görmelisiniz:
Deneyin
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:
12. Sonuç
Tebrikler! Antigravity IDE'yi başarıyla yüklediniz, yapılandırdınız ve temel özelliklerini keşfettiniz.
Antigravity platformu hakkında daha fazla bilgi edinmek için aşağıdaki codelab'lere ve referans belgelerine göz atın.
Diğer Codelab'ler
- Google Antigravity'yi kullanmaya başlama
- Google Antigravity ile geliştirme
- Antigravity CLI ile Uygulamalı Çalışma
- Antigravity ile Google Cloud'da derleme ve dağıtım
Referans belgeleri
- Resmi site : https://antigravity.google/
- Belgeler: https://antigravity.google/docs/home
- Kullanım alanları : https://antigravity.google/use-cases
- İndirme : https://antigravity.google/download
- Google Antigravity'nin YouTube kanalı : https://www.youtube.com/@googleantigravity