Antigravity bir döngüdür. Aracısı dosyaları düzenler, terminal komutlarını çalıştırır, çıktıyı okur ve sonra ne yapacağına karar verir. Peki neden API testleriniz bu döngüde değil? Bir GUI'nin arkasında Apidog'da dururlar ve birisi tıklamayı hatırladığında çalıştırılırlar. Aracı onlara asla dokunmaz.
Çözüm, tek bir yapılandırma bloğudur. Apidog CLI, apidog-cli adında bir npm paketidir ve Apidog'da oluşturduğunuz test senaryolarını doğrudan bir terminalden çalıştırır. CLI yüklendiğinde ve Antigravity onun var olduğunu bildiğinde, aracı bir Apidog senaryosunu birim testlerinizi çalıştırdığı gibi çalıştırır: komutu ateşle, çıkış kodunu oku, kırmızıysa kodu düzelt.
CLI'yi henüz kurmadıysanız, önce bunu yapın. Bir yapay zeka kodlama aracısı ile Apidog CLI nasıl kurulur makalesi, aracının yazarak npm kurulumunu, kimlik doğrulamasını ve ilk çalıştırmayı adım adım anlatır. Bu makale, apidog --version komutunun bir sayı yazdığını ve Apidog hesabınızın kimliğinin doğrulandığını varsayar.
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. İşi planlayan, depolamanızdaki dosyaları düzenleyen ve kendi terminalinde ve tarayıcısında kabuk komutları yürüten bir Aracı Yöneticisi aracılığıyla aracıyı çalıştırır. Aracı birincil yüzeydir ve doğrudan yerel makinenizde çalışır. Antigravity'yi açtıysanız, bir görev başlattıysanız ve aracının komutları çalıştırıp rapor verdiğini izlediyseniz, doğru yerdesiniz. Daha geniş bir tur için, Google Antigravity'nin ne olduğunu ve nasıl kullanılacağını görün.
Bu ayrım önemlidir çünkü Antigravity'nin proje kurallarını öğrenmek için kendi bir yolu vardır ve bu mekanizma, bir kerelik "testlerimi çalıştır" komutunu aracının kendi başına başvurduğu bir şeye dönüştürür.
Adım 1: Antigravity'ye bir kural dosyası verin
Antigravity, çalışma alanı kökünüzde özel bir .agents/ dizinini tanır. Google'ın Antigravity'de otonom geliştirici işlem hatları oluşturma konusundaki codelabi, aracının oraya yerleştirdiğiniz dosyaları doğal olarak nasıl aldığını gösterir ve çalışma alanı kuralları .agents/rules/ içinde bulunur. Proje kurallarınızı .agents/rules/apidog.md gibi bir dosyaya koyun. Antigravity ayrıca çalışma alanı kökünde bulunan düz bir AGENTS.md dosyasını çapraz araç temeli olarak okur; bu, Codex'in Apidog CLI için okuduğu dosyanın aynısıdır; zaten bir tane tutuyorsanız, iki tane tutmak yerine Apidog bloğunu oraya ekleyin.
O kural dosyasına kısa bir Apidog bloğu yerleştirin. Şuna benzer bir şey:
## API testing with the Apidog CLI
- To test the API, run the Apidog scenario, do not click through the GUI.
- Command: apidog run -t <scenario_id> -e <env_id> -r cli
- Exit code 0 means every assertion passed. Non-zero means a failure; open the report and fix the code.
- The machine is already authenticated via `apidog login`. Never add an --access-token flag and never put a token in this file.
CLI'yi sohbette belirtmek yerine kural dosyasına yazmanızın nedeni budur. Antigravity, oturumlar arasında ona öğrettiğiniz şeyleri hatırlamaz; pencereyi kapatın, yeniden açın ve rehberlik kaybolur. Sohbet kutusuna yazılan bir senaryo kimliği, oturum sona erdiğinde kaybolur. Kural dosyanıza yazılan bir senaryo kimliği ise, artık her takım arkadaşı ve her Antigravity çalıştırması için orada olacaktır.
Adım 2: Apidog'dan komutu alın
Senaryo ve ortam kimliklerini tahmin etmek zorunda değilsiniz. Apidog'da test senaryosunu açın, CI/CD sekmesine gidin ve oluşturulan komutu kopyalayın. Şuna benzer görünür:
apidog run -t 123456 -e 789012 -r cli
-t bayrağı test senaryo kimliğidir, -e ortam kimliğidir ve -r cli sonuçları satır içi yazdıran raporlayıcıyı seçer. Bu gerçek kimlikleri .agents/rules/apidog.md bloğunuza yapıştırın, böylece aracı Apidog'un size verdiği tam komutu çalıştırır. Her bayrak için apidog run komut referansına bakın.
Adım 3: Aracının testi çalıştırmasını sağlayın
Blok yerindeyken Antigravity'de bir görev başlatın. Aracı, başladığında kurallarınızı yükler, böylece CLI'nin orada olduğunu zaten bilir. API'nizi etkileyen bir değişiklik yapın veya sadece kontrolü çalıştırmasını isteyin:
Apidog test senaryosunu çalıştır ve çıkış kodunu söyle.
Aracı, kendi terminalinde kural dosyanızdaki apidog run komutunu yayınlar. Onay istemeden çalışıp çalışmaması izin ayarınıza bağlıdır. Antigravity'nin Güvenlik Ön Ayarı, Google'ın Antigravity'ye başlama codelab'inde açıklandığı gibi, aracı işlem yapmadan önce terminal komutlarının ve dosya erişimlerinin sizin tarafınızdan gözden geçirilip geçirilmeyeceğini belirler. Eğer ön ayar inceleme isterse, istediğinde apidog run komutunu onaylayın; hazırlık ortamına karşı salt okunur bir test senaryosu, onaylamanın sorun olmadığı güvenli, çalışma alanı içi komut türüdür. Aracıyı kendi başına ilerleyecek şekilde ayarladıysanız, komutu çalıştırır ve durmadan geri rapor verir.
Çalıştırmanın yürütüldüğünü ve aracının hem özet hem de çıkış kodunu bildirdiğini görmek istersiniz, bir yorumu değil.
Adım 4: Raporu Antigravity içinde okuyun
Bir çalıştırma başarısız olduğunda (kırmızıya döndüğünde), rapor cevabı verir. -r cli ile aracı, terminalinde okunabilir bir döküm alır: her istek, her iddia ve hangisinin beklenen ile gerçek değer arasındaki farkla başarısız olduğu. Başarısız olan iddia, tam alanı veya durum kodunu belirtir, bu da genellikle aracının çözümü bulması için yeterlidir.
Bir tarayıcıda açabileceğiniz veya bir takım arkadaşınıza verebileceğiniz bir rapor için HTML raporlayıcıyı ekleyin:
apidog run -t 123456 -e 789012 -r cli,html
html raporlayıcı, ./apidog-reports dizinine kendi kendine yeten bir dosya yazar. Aracının bir sonraki adımına karar vermek için okuduğu satır içi çıktıyı almaya devam etmesi için cli'yi listede tutun. JUnit formatındaki CI panolarının ayrıştırdığı raporlayıcılar da dahil olmak üzere tüm raporlayıcılar için eksiksiz Apidog CLI rehberine ve Apidog CLI test raporları nasıl okunur makalesine bakın.
Antigravity testini kendi döngüsünde çalıştırmak
Asıl mesele, siz sormayı bıraktığınızda ve kural dosyası ona söylediği için aracının senaryoyu kendi başına çalıştırmasıdır.
Aracının bir ödeme yanıtı oluşturan bir işleyiciyi düzenlediğini hayal edin. Döngüsü değişir. Kodu düzenler, sonra zafer ilan etmek yerine Apidog senaryonuzu hazırlık ortamına karşı çalıştırır, çıkış kodunu okur ve buna göre hareket eder. Yeşilse, devam eder. Kırmızıysa, raporu açar, hangi iddianın başarısız olduğunu (durum kodu, eksik alan, yanlış değer) okur, bir düzeltme dener ve yeniden çalıştırır. API testi, aracının birim testlerinizi zaten çalıştırdığı aynı düzenle-test et-düzelt döngüsünün bir parçası haline gelir. Tek bir talimat yazdınız ve aracı komutu zaten çalışma şekline dahil etti.
Bu, herhangi bir aracı iş akışını güvenli kılan devret-sonra-doğrula modelidir. Antigravity komutu çalıştırır ve sonucu okur; siz Apidog'da senaryoları görsel olarak yazmaya devam eder ve aracının çıkış kodlarını dürüstçe okuduğunu kontrol edersiniz. Daha geniş kalıp için API testi için yapay zeka aracıları nasıl kullanılır ve Apidog yapay zeka test donanımı makalelerine bakın.
Antigravity'nin gerçekten CLI'yi çalıştırdığını doğrulayın
Aracılar hak etmedikleri başarıları rapor ederler ve Antigravity de bir istisna değildir. Sorunları ne sıklıkta yakaladıklarına göre sıralanmış üç kontrol.
İlk olarak, komutun çalışıp çalışmadığını onaylayın. Antigravity, yürüttüğü komutları ve bunların çıktısını terminalinde gösterir. Tam olarak apidog run ... satırını ve altında bir sonucu arayın. Eğer aracı testleri çalıştırdığını söylüyor ancak komutu görmüyorsanız, hiç yapmadığı bir şeyi özetlemiştir. Tekrar çalıştırmasını ve ham çıktıyı göstermesini isteyin.
İkincisi, önemli olan çıkış kodunu onaylayın. Doğrudan sorun:
Bu apidog run komutunun çıkış kodu neydi?
apidog run, tüm iddialar geçtiğinde 0 ile, herhangi bir şey başarısız olduğunda ise sıfır olmayan bir değerle çıkar. Bu tek davranış, aracının veya bir işlem hattının çalıştırmayı temiz bir geçit olarak ele almasını sağlar. Aracının yazısı "testler geçti" dediğinde ancak çıkış kodu sıfır olmadığında, çıkış kodu doğrudur.
Üçüncüsü, gerçek senaryoyu kullandığını onaylayın. Bir çalıştırma "senaryo bulunamadı" hatasıyla başarısız olursa, aracı bir kimlik uydurmuş veya yanlış hatırlamış olabilir. -t ve -e değerlerini kural dosyanızdaki ve Apidog'un CI/CD sekmesinde oluşturduğu komuttaki değerlerle tekrar kontrol edin. Kural dosyanızdaki kimlikler gerçeği yansıtır.
İsteğe Bağlı: Apidog MCP sunucusunu bağlayın
Kural dosyanızdan apidog run çalıştırmak, ihtiyacınız olan çoğu şeyi kapsar. Daha ileri gitmek için bir MCP sunucusu bağlayın.
Antigravity, Model Bağlam Protokolü'nü destekler ve MCP sunucuları, Google'ın başlangıç codelab'ine göre $HOME/.gemini/config/mcp_config.json dosyasında yapılandırılır. Bir sunucuyu, o dosyanın mcpServers nesnesine command, args ve env ile bir giriş olarak eklersiniz, ardından Antigravity ayarlarında MCP'yi yenilersiniz. Apidog MCP sunucusu, API spesifikasyonlarınızı MCP üzerinden ifşa eder, böylece aracı, kodu yazarken şemanızı okuyabilir, sadece sonradan değil. CLI testleri çalıştırır; MCP, aracıya spesifikasyonu besler.
Antigravity yanlış yaptığında
Kurulum sırasında birkaç hata sıkça ortaya çıkar.
Kural dosyasını göz ardı eder. Eğer aracı genel bir komut çalıştırıyorsa veya hiç çalıştırmıyorsa, kurallar yüklenmiyor olabilir. Dosyanın doğru adlandırıldığını ve Antigravity'nin çalışma alanınız için beklediği yerde bulunduğunu onaylayın, ardından kuralları yeniden okuması için yeni bir görev başlatın.
Yine de bir erişim jetonu iletir. Eğer aracı --access-token eklemeye çalışırsa, genel örneklerden tahmin yürütüyordur. Makine apidog login aracılığıyla kimliği doğrulandığı için kural bloğunuz zaten ona bunu yapmamasını söyler. Bu satırı güçlendirin ve asla gerçek bir jetonu kural dosyasına koymayın. Kimlik doğrulamanın gerçekten nasıl çalıştığını görmek için Apidog CLI kimlik doğrulamasına bakın.
Bir bayrak uydurur. "Bilinmeyen seçenek" hatası, aracının sürümünüzde olmayan bir bayrağı tahmin ettiği anlamına gelir. Ona apidog run --help komutunu çalıştırmasını söyleyin ve oradan tam bayrağı kopyalayın; bu, yüklü sürümünüz için her zaman doğrudur.
Başarısız bir çalıştırmada geçti raporu verir. En maliyetli olanı ve çıkış kodu kuralının kural dosyanızda ve doğrulama adımınızda olmasının nedeni budur. Özet ve çıkış kodu çeliştiğinde, çıkış kodu kazanır.
Günlük bir ajandan test edilmiş bir döngüye
Kurulum bu kadar. Kurulum rehberini takip ederek apidog-cli'yi bir kez kurun, Antigravity kural dosyanıza kısa bir Apidog bloğu ekleyin ve aracı API testlerinizi nasıl çalıştıracağını ve kodu düzenlemek için zaten kullandığı aynı döngü içinde sonucu nasıl okuyacağını bilecektir. Bozuk bir uç nokta, aracı hala değişiklik üzerinde çalışırken yakalanır, dağıtımdan sonra değil.
Bir GUI'nin arkasındaki bir test, bir insan tıkladığında çalışır; tek satırlık bir komut ise Antigravity ne zaman karar verirse o zaman çalışır. Siz Apidog'da senaryoları görsel olarak oluşturmaya devam edersiniz ve aracınız onları siz izlemezken çalıştırır. Apidog'u indirin, bir senaryo oluşturun, apidog run komutunu kural dosyanıza ekleyin ve bir sonraki değişiklikte aracının bunu nasıl algıladığını izleyin. Aynı komutu bir işlem hattında aracı olmadan çalıştırmaya hazır olduğunuzda, GitHub Actions'ta Apidog CLI sırları, raporlayıcıları ve çıkış kodu kapılamasını kapsar.