Apidog CLI Antigravity'de Nasıl Kullanılır

Antigravity bir döngüdür: aracısı dosyaları düzenler, terminal komutlarını çalıştırır, çıktıyı okur ve sonraki adımı belirler. API testleriniz bu döngüde değilse, bir GUI'nin arkasında kalır ve yalnızca biri tıklamayı hatırladığında çalışır. Çözüm, Apidog senaryolarını doğrudan terminalden çalıştıran apidog-cli ile Antigravity kurallarınıza tek bir yapılandırma bloğu eklemektir.

Apidog'u bugün deneyin

Apidog'da oluşturduğunuz test senaryolarını apidog-cli ile çalıştırdığınızda, Antigravity bunları birim testleriniz gibi ele alabilir: komutu çalıştırır, çıkış kodunu okur ve sonuç başarısızsa kodu düzeltir.

CLI henüz kurulu değilse önce kurulumu tamamlayın. Bir yapay zeka kodlama aracısı ile Apidog CLI nasıl kurulur rehberi npm kurulumu, kimlik doğrulama ve ilk çalıştırmayı adım adım açıklar.

Bu makale aşağıdakileri varsayar:

• apidog --version bir sürüm numarası döndürüyor.
• Makineniz apidog login ile Apidog hesabınız için doğrulandı.

Bu Antigravity hangisi hakkında?

Antigravity, Google'ın Gemini 3 üzerine inşa edilmiş, 2025 sonunda piyasaya sürülen aracı tabanlı geliştirme platformudur. İş planlama, depo dosyalarını düzenleme, terminal komutları ve tarayıcı işlemleri için Aracı Yöneticisi kullanır.

Aracı doğrudan yerel makinenizde çalışır. Antigravity'de bir görev başlattığınızda aracının komutları çalıştırıp raporlamasını izliyorsanız, bu yapılandırma sizin için geçerlidir. Daha geniş bir giriş için Google Antigravity'nin ne olduğunu ve nasıl kullanılacağını inceleyin.

Bu ayrım önemlidir: Antigravity proje kurallarını okuyabilir. Böylece tek seferlik “testlerimi çalıştır” isteğini, her görevde uygulanabilen kalıcı bir davranışa dönüştürebilirsiniz.

Adım 1: Antigravity'ye bir kural dosyası verin

Antigravity, çalışma alanı kökünde .agents/ dizinini tanır. Google'ın Antigravity'de otonom geliştirici işlem hatları oluşturma codelab'i, aracının bu dizindeki dosyaları nasıl kullandığını gösterir.

Çalışma alanı kurallarını aşağıdaki konuma ekleyin:

.agents/rules/apidog.md

Antigravity ayrıca çalışma alanı kökünde bulunan AGENTS.md dosyasını çapraz araç kuralları için okuyabilir. Zaten böyle bir dosyanız varsa, ayrı bir dosya oluşturmak yerine Apidog bloğunu ekleyin. Bu, Codex'in Apidog CLI için okuduğu dosyayla aynı yaklaşımdır.

.agents/rules/apidog.md veya AGENTS.md içine şu kuralları ekleyin:

## Apidog CLI ile API testi

- API'yi test etmek için GUI üzerinden tıklama yapma; Apidog senaryosunu çalıştır.
- Komut: apidog run -t <scenario_id> -e <env_id> -r cli
- Çıkış kodu 0 ise tüm iddialar geçti. Sıfır olmayan kod başarısızlık demektir; raporu aç ve kodu düzelt.
- Makine `apidog login` ile zaten doğrulandı. Asla `--access-token` ekleme ve bu dosyaya token yazma.

Bu bilgiyi yalnızca sohbette vermek yerine kural dosyasına yazın. Antigravity oturumlar arasında sohbet talimatlarını hatırlamayabilir. Buna karşılık, kural dosyasındaki senaryo kimliği ve komut:

• Her yeni görevde kullanılabilir.
• Takımdaki herkes için görünür olur.
• Aracının test çalıştırma davranışını tekrarlanabilir hale getirir.

Adım 2: Apidog'dan komutu alın

Senaryo ve ortam kimliklerini tahmin etmeyin.

1. Apidog'da test senaryosunu açın.
2. CI/CD sekmesine gidin.
3. Oluşturulan komutu kopyalayın.

Komut şu biçimde görünür:

apidog run -t 123456 -e 789012 -r cli

Bayrakların anlamı:

Bayrak	Açıklama
-t	Test senaryosu kimliği
-e	Ortam kimliği
-r cli	Sonuçları terminale yazdıran raporlayıcı

Apidog'un oluşturduğu gerçek komutu kural dosyanıza yapıştırın. Böylece aracı varsayım yapmak yerine doğru senaryo ve ortamla çalışır.

Tüm bayraklar için apidog run komut referansına bakın.

Adım 3: Aracının testi çalıştırmasını sağlayın

Kural bloğu yerindeyken Antigravity'de bir görev başlatın. Aracı görev başında kuralları yüklediği için CLI komutunu zaten bilir.

API'nizi etkileyen bir değişiklikten sonra şu istemi kullanın:

Apidog test senaryosunu çalıştır ve çıkış kodunu söyle.

Aracı, kural dosyanızdaki apidog run komutunu terminalinde çalıştırmalıdır.

Komutun onay istemeden çalışıp çalışmaması Antigravity izin ayarlarınıza bağlıdır. Google'ın Antigravity'ye başlama codelab'inde açıklandığı gibi, Güvenlik Ön Ayarı terminal komutları ve dosya erişimlerinin çalıştırılmadan önce gözden geçirilip geçirilmeyeceğini belirler.

Ön ayar inceleme gerektiriyorsa:

1. Aracının önerdiği apidog run komutunu kontrol edin.
2. Hazırlık ortamına yönelik salt okunur test senaryosuysa komutu onaylayın.
3. Çalıştırma özetini ve çıkış kodunu doğrulayın.

Beklenen sonuç, yalnızca “testler geçti” yorumu değil; çalıştırılan komut, terminal çıktısı ve çıkış kodudur.

Adım 4: Raporu Antigravity içinde okuyun

Bir çalıştırma başarısız olduğunda, -r cli raporlayıcısı terminalde okunabilir bir döküm üretir:

• Her istek
• Her iddia
• Başarısız durum kodu
• Beklenen ve gerçek değer arasındaki fark
• Eksik veya yanlış alanlar

Bu çıktı genellikle aracının düzeltmeye nereden başlayacağını belirlemesi için yeterlidir.

Tarayıcıda açılabilecek veya ekip arkadaşlarıyla paylaşılabilecek bir rapor da oluşturmak için HTML raporlayıcıyı ekleyin:

apidog run -t 123456 -e 789012 -r cli,html

html raporlayıcısı kendi kendine yeten raporu ./apidog-reports dizinine yazar. Aracının karar verebilmesi için terminal çıktısını korumak adına cli raporlayıcısını listede bırakın.

Diğer raporlayıcılar ve JUnit uyumlu CI çıktıları için şu kaynaklara bakın:

• Eksiksiz Apidog CLI rehberi
• Apidog CLI test raporları nasıl okunur

Antigravity testini kendi döngüsünde çalıştırmak

Asıl hedef, her seferinde manuel olarak istem vermek değildir. Kural dosyası sayesinde aracının API'yi etkileyen değişikliklerde senaryoyu kendi döngüsünde çalıştırmasını sağlamaktır.

Örneğin araç bir ödeme yanıtı üreten işleyiciyi düzenlediğinde döngü şu hale gelir:

1. Kodu düzenler.
2. Apidog senaryosunu hazırlık ortamına karşı çalıştırır.
3. Çıkış kodunu okur.
4. Sonuç 0 ise göreve devam eder.
5. Sonuç sıfır değilse raporu inceler.
6. Başarısız iddiayı bulur: durum kodu, eksik alan veya yanlış değer.
7. Düzeltmeyi uygular ve testi tekrar çalıştırır.

Böylece API testi, mevcut düzenle-test et-düzelt döngüsünün parçası olur.

Bu yaklaşım, aracı iş akışları için devret-sonra-doğrula modelini uygular:

• Antigravity komutu çalıştırır ve sonucu okur.
• Siz Apidog'da test senaryolarını görsel olarak yönetirsiniz.
• Çıkış kodu aracının özetinden bağımsız, doğrulanabilir bir sinyal sağlar.

Daha geniş yaklaşım için:

• API testi için yapay zeka aracıları nasıl kullanılır
• Apidog yapay zeka test donanımı

Antigravity'nin gerçekten CLI'yi çalıştırdığını doğrulayın

Aracılar bazen çalıştırmadıkları işlemleri başarılıymış gibi özetleyebilir. Aşağıdaki üç kontrolü uygulayın.

1. Komutun çalıştırıldığını doğrulayın

Antigravity terminalinde tam apidog run ... komutunu ve altındaki çıktıyı arayın.

Aracı testleri çalıştırdığını söylüyor ancak terminalde komut görünmüyorsa, ham çıktıyı göstermesini ve testi yeniden çalıştırmasını isteyin.

2. Çıkış kodunu doğrulayın

Aracıya doğrudan şunu sorun:

Bu apidog run komutunun çıkış kodu neydi?

apidog run davranışı:

• Tüm iddialar geçtiğinde 0 ile çıkar.
• Herhangi bir iddia başarısız olduğunda sıfır olmayan bir değerle çıkar.

Aracının özeti “testler geçti” diyorsa ama çıkış kodu sıfır değilse, çıkış kodunu esas alın.

3. Gerçek senaryo kimliklerini kullandığını doğrulayın

“Senaryo bulunamadı” hatası genellikle yanlış veya uydurulmuş bir kimliğe işaret eder.

Şunları karşılaştırın:

• Kural dosyanızdaki -t değeri
• Kural dosyanızdaki -e değeri
• Apidog CI/CD sekmesinin oluşturduğu komut

Kural dosyanızdaki değerler Apidog'un oluşturduğu komutla aynı olmalıdır.

İsteğe bağlı: Apidog MCP sunucusunu bağlayın

Kural dosyasından apidog run çalıştırmak çoğu kullanım senaryosunu kapsar. Aracının API spesifikasyonunu kod yazarken de okuyabilmesini istiyorsanız MCP sunucusu bağlayabilirsiniz.

Antigravity, Model Bağlam Protokolü'nü destekler. Google'ın başlangıç codelab'ine göre MCP sunucuları şu dosyada yapılandırılır:

$HOME/.gemini/config/mcp_config.json

Sunucuyu mcpServers nesnesine command, args ve env alanlarıyla ekleyin; ardından Antigravity ayarlarından MCP yapılandırmasını yenileyin.

Apidog MCP sunucusu, API spesifikasyonunuzu MCP üzerinden erişilebilir hale getirir. Böylece araç:

• Kod yazarken şemanızı okuyabilir.
• İstek ve yanıt yapısını anlayabilir.
• CLI ile test çalıştırmadan önce API bağlamını kullanabilir.

Kısaca:

• CLI testleri çalıştırır.
• MCP aracıya API spesifikasyonunu sağlar.

Antigravity yanlış yaptığında

Kurulum sırasında sık görülen sorunlar ve çözümleri şunlardır.

Kural dosyasını göz ardı ediyor

Araç genel bir komut çalıştırıyorsa veya hiç komut çalıştırmıyorsa, kurallar yüklenmiyor olabilir.

Kontrol listesi:

1. Dosya adını doğrulayın.
2. Dosyanın .agents/rules/apidog.md altında veya çalışma alanı kökündeki AGENTS.md içinde olduğunu doğrulayın.
3. Kuralları yeniden yüklemesi için yeni bir Antigravity görevi başlatın.

Hâlâ erişim token'ı ekliyor

Araç --access-token eklemeye çalışıyorsa, genel örneklerden tahmin yürütüyor olabilir.

Kural dosyanızdaki şu kuralı güçlendirin:

Makine `apidog login` ile doğrulandı. `--access-token` kullanma ve token yazma.

Gerçek erişim token'ını asla kural dosyasına koymayın. Kimlik doğrulama davranışı için Apidog CLI kimlik doğrulaması rehberine bakın.

Bir bayrak uyduruyor

“Bilinmeyen seçenek” hatası, aracının yüklü sürümünüzde olmayan bir bayrağı kullandığını gösterir.

Aracıya şu komutu çalıştırmasını söyleyin:

apidog run --help

Ardından gereken bayrağı doğrudan yardım çıktısından kopyalayın. Bu çıktı, makinenizde yüklü sürüm için geçerlidir.

Başarısız çalıştırmayı başarılı raporluyor

Bu en maliyetli hatadır. Kural dosyanızdaki çıkış kodu kuralı ve doğrulama adımı bu nedenle gereklidir.

Özet ile çıkış kodu çelişirse:

Çıkış kodu kazanır.

Günlük bir ajandan test edilmiş bir döngüye

Kurulum bu kadar:

1. Kurulum rehberini izleyerek apidog-cli paketini bir kez kurun.
2. Antigravity kural dosyanıza kısa bir Apidog bloğu ekleyin.
3. Apidog'un CI/CD sekmesinden gerçek apidog run komutunu kopyalayın.
4. Aracının komutu çalıştırdığını, raporu okuduğunu ve çıkış kodunu bildirdiğini doğrulayın.

Böylece bozuk bir uç nokta, dağıtımdan sonra değil, araç değişiklik üzerinde çalışırken yakalanır.

GUI arkasındaki bir test yalnızca insan tıkladığında çalışır. Kural dosyasındaki tek satırlık bir komut ise Antigravity'nin geliştirme döngüsüne dahil olur. Siz Apidog'da senaryoları görsel olarak oluşturmaya devam ederken, aracınız bunları değişikliklerden sonra çalıştırabilir.

Apidog'u indirin, bir senaryo oluşturun ve apidog run komutunu kural dosyanıza ekleyin. Aynı komutu aracı olmadan CI işlem hattında çalıştırmaya hazır olduğunuzda, GitHub Actions'ta Apidog CLI rehberi sırları, raporlayıcıları ve çıkış kodu kapılamasını kapsar.