Antigravity adalah sebuah loop. Agennya mengedit file, menjalankan perintah terminal, membaca output, dan memutuskan apa yang harus dilakukan selanjutnya. Jadi, mengapa tes API Anda tidak ada dalam loop itu? Mereka duduk di Apidog di balik GUI dan berjalan ketika seseorang ingat untuk mengklik. Agen tidak pernah menyentuhnya.
Perbaikannya adalah satu blok konfigurasi. Apidog CLI adalah paket npm, apidog-cli, yang menjalankan skenario pengujian yang Anda buat di Apidog langsung dari terminal. Setelah CLI terinstal dan Antigravity tahu keberadaannya, agen menjalankan skenario Apidog dengan cara yang sama seperti menjalankan unit tes Anda: jalankan perintah, baca kode keluar, perbaiki kode jika merah.
tombol
Jika Anda belum menginstal CLI, lakukan itu terlebih dahulu. Cara menginstal Apidog CLI dengan agen pengkodean AI menjelaskan instalasi npm, autentikasi, dan jalankan pertama, dengan agen yang melakukan pengetikan. Artikel ini mengasumsikan apidog --version mencetak angka dan akun Apidog Anda sudah diautentikasi.
Antigravity yang mana yang dibicarakan ini
Antigravity adalah platform pengembangan agen Google, dibangun di atas Gemini 3, yang diluncurkan pada akhir 2025. Ini menjalankan agen melalui Agent Manager yang merencanakan pekerjaan, mengedit file di seluruh repositori Anda, dan mengeksekusi perintah shell di terminal dan browsernya sendiri. Agen adalah permukaan utama, dan beroperasi langsung di mesin lokal Anda. Jika Anda telah membuka Antigravity, memulai tugas, dan menyaksikan agen menjalankan perintah serta melaporkan kembali, Anda berada di tempat yang tepat. Untuk tur yang lebih luas, lihat apa itu Google Antigravity dan cara menggunakannya.
Perbedaan ini penting karena Antigravity memiliki caranya sendiri untuk mempelajari aturan proyek, dan mekanisme tersebut mengubah "jalankan tes saya" yang bersifat satu kali menjadi sesuatu yang agen gunakan dengan sendirinya.
Langkah 1: Berikan Antigravity file aturan
Antigravity mengenali direktori khusus .agents/ di root ruang kerja Anda. Codelab Google sendiri tentang membangun pipeline pengembang otonom di Antigravity menunjukkan agen secara native mengambil file yang Anda tempatkan di sana, dan aturan ruang kerja berada di .agents/rules/. Letakkan aturan proyek Anda di file seperti .agents/rules/apidog.md. Antigravity juga membaca file AGENTS.md biasa di root ruang kerja sebagai fondasi lintas-alat, file yang sama dengan yang dibaca Codex untuk Apidog CLI; jika Anda sudah memilikinya, tambahkan blok Apidog di sana daripada memelihara dua file.
Letakkan blok Apidog singkat di file aturan tersebut. Kira-kira seperti ini:
## Pengujian API dengan Apidog CLI
- Untuk menguji API, jalankan skenario Apidog, jangan klik melalui GUI.
- Perintah: apidog run -t <scenario_id> -e <env_id> -r cli
- Kode keluar 0 berarti setiap penegasan lulus. Bukan nol berarti kegagalan; buka laporan dan perbaiki kode.
- Mesin sudah diautentikasi melalui `apidog login`. Jangan pernah menambahkan flag --access-token dan jangan pernah meletakkan token di file ini.
Inilah mengapa Anda menulis CLI ke dalam file aturan daripada menyebutkannya di obrolan. Antigravity tidak mengingat apa yang Anda ajarkan di antara sesi; tutup jendela, buka kembali, dan pelatihan hilang. ID skenario yang diketik ke dalam obrolan akan hilang saat sesi berakhir. Yang tertulis di file aturan Anda akan ada untuk setiap rekan tim dan setiap jalankan Antigravity mulai sekarang.
Langkah 2: Dapatkan perintah dari Apidog
Anda tidak perlu menebak ID skenario dan lingkungan. Buka skenario pengujian di Apidog, buka tab CI/CD-nya, dan salin perintah yang dihasilkan. Bentuknya seperti ini:
apidog run -t 123456 -e 789012 -r cli
Flag -t adalah ID skenario pengujian, -e adalah ID lingkungan, dan -r cli memilih pelapor yang mencetak hasil secara langsung. Tempelkan ID nyata tersebut ke blok .agents/rules/apidog.md Anda agar agen menjalankan perintah persis yang diberikan Apidog kepada Anda. Untuk setiap flag, lihat referensi perintah apidog run.
Langkah 3: Minta agen menjalankan tes
Dengan blok yang ada, mulailah tugas di Antigravity. Agen memuat aturan Anda saat memulai, jadi ia sudah tahu CLI ada di sana. Buat perubahan yang menyentuh API Anda, atau cukup minta untuk menjalankan pemeriksaan:
Jalankan skenario pengujian Apidog dan beritahu saya kode keluarnya.
Agen mengeluarkan perintah apidog run dari file aturannya di terminalnya sendiri. Apakah itu berjalan tanpa bertanya tergantung pada pengaturan izin Anda. Preset Keamanan Antigravity menentukan apakah perintah terminal dan akses file ditinjau oleh Anda sebelum agen bertindak, seperti yang dijelaskan dalam codelab memulai dengan Antigravity Google. Jika preset meminta tinjauan, setujui perintah apidog run saat diminta; skenario pengujian hanya-baca terhadap staging adalah jenis perintah yang aman dan dalam ruang kerja yang baik untuk disetujui. Jika Anda telah mengatur agen untuk melanjutkan sendiri, ia akan menjalankan perintah dan melaporkan kembali tanpa berhenti.
Anda ingin melihat jalannya eksekusi dan agen melaporkan ringkasan dan kode keluar, bukan parafrase.
Langkah 4: Baca laporan di dalam Antigravity
Ketika suatu eksekusi gagal, laporannya memiliki jawabannya. Dengan -r cli, agen mendapatkan rincian yang dapat dibaca di terminalnya: setiap permintaan, setiap penegasan, dan mana yang gagal dengan nilai yang diharapkan versus nilai sebenarnya. Penegasan yang gagal menamai bidang atau kode status yang tepat, yang biasanya cukup bagi agen untuk menemukan perbaikannya.
Untuk laporan yang dapat Anda buka di browser atau berikan kepada rekan tim, tambahkan pelapor HTML:
apidog run -t 123456 -e 789012 -r cli,html
Pelapor html menulis file mandiri ke ./apidog-reports. Pertahankan cli dalam daftar agar agen tetap mendapatkan output inline yang dibacanya untuk memutuskan langkah selanjutnya. Untuk daftar lengkap pelapor, termasuk format JUnit yang diurai oleh dasbor CI, lihat panduan lengkap Apidog CLI dan cara membaca laporan pengujian Apidog CLI.
Pengujian Antigravity di dalam loopnya sendiri
Intinya adalah apa yang terjadi ketika Anda berhenti bertanya dan agen menjalankan skenario sendiri karena file aturan memberitahunya.
Bayangkan agen mengedit handler yang membangun respons checkout. Loopnya berubah. Agen mengedit kode, lalu, alih-alih menyatakan kemenangan, menjalankan skenario Apidog Anda terhadap staging, membaca kode keluar, dan bertindak berdasarkan itu. Hijau, ia melanjutkan. Merah, ia membuka laporan, membaca penegasan mana yang gagal (kode status, bidang yang hilang, nilai yang salah), mencoba perbaikan, dan menjalankan ulang. Tes API menjadi bagian dari loop edit-tes-perbaiki yang sama yang sudah digunakan agen untuk menjalankan unit tes Anda. Anda menulis satu instruksi dan agen melipat perintah itu ke dalam cara kerjanya.
Ini adalah model delegasi-kemudian-verifikasi yang membuat alur kerja agen aman. Antigravity menjalankan perintah dan membaca hasilnya; Anda terus membuat skenario secara visual di Apidog dan memeriksa apakah agen membaca kode keluar dengan jujur. Untuk pola yang lebih luas, lihat cara menggunakan agen AI untuk pengujian API dan alat uji AI Apidog.
Verifikasi Antigravity benar-benar menjalankan CLI
Agen melaporkan keberhasilan yang tidak mereka peroleh, dan Antigravity tidak terkecuali. Tiga pemeriksaan, berdasarkan seberapa sering mereka menemukan masalah.
Pertama, konfirmasikan apakah perintah itu berjalan sama sekali. Antigravity menunjukkan perintah yang dieksekusi dan outputnya di terminalnya. Cari baris `apidog run ...` secara harfiah dan hasilnya di bawahnya. Jika agen mengatakan ia menjalankan tes tetapi Anda tidak melihat perintahnya, itu merangkum sesuatu yang tidak pernah dilakukannya. Minta ia untuk menjalankan lagi dan menunjukkan output mentah.
Kedua, konfirmasikan kode keluar, yang paling penting. Tanyakan langsung:
Berapa kode keluar dari perintah apidog run itu?
apidog run keluar 0 ketika setiap penegasan lulus dan bukan nol ketika ada yang gagal. Perilaku tunggal ini memungkinkan agen, atau pipeline, memperlakukan jalannya sebagai gerbang yang bersih. Ketika prosa agen mengatakan "tes lulus" tetapi kode keluar bukan nol, kode keluar itulah yang benar.
Ketiga, konfirmasikan ia menggunakan skenario yang sebenarnya. Jika suatu jalankan gagal dengan "skenario tidak ditemukan," agen mungkin telah menciptakan atau salah mengingat ID. Periksa kembali nilai -t dan -e terhadap file aturan Anda dan perintah yang dihasilkan Apidog di tab CI/CD. ID di file aturan Anda adalah kebenaran.
Opsional: sambungkan server MCP Apidog
Menjalankan apidog run dari file aturan Anda mencakup sebagian besar yang Anda butuhkan. Untuk melangkah lebih jauh, sambungkan server MCP.
Antigravity mendukung Model Context Protocol, dan server MCP-nya dikonfigurasi dalam file $HOME/.gemini/config/mcp_config.json, sesuai dengan codelab memulai Google Antigravity. Anda menambahkan server sebagai entri dalam objek mcpServers file tersebut dengan command, args, dan env-nya, lalu me-refresh MCP di pengaturan Antigravity. Server MCP Apidog mengekspos spesifikasi API Anda melalui MCP, sehingga agen dapat membaca skema Anda saat menulis kode, bukan hanya setelah fakta. CLI menjalankan tes; MCP memberi makan spesifikasi kepada agen.
Ketika Antigravity salah
Beberapa kegagalan sering muncul selama pengaturan.
Ini mengabaikan file aturan. Jika agen menjalankan perintah generik atau tidak sama sekali, aturan mungkin tidak dimuat. Konfirmasikan bahwa nama file sudah benar dan berada di tempat yang diharapkan Antigravity untuk ruang kerja Anda, lalu mulai tugas baru agar membaca ulang aturan tersebut.
Ini tetap meneruskan token akses. Jika agen mencoba menambahkan --access-token, itu menebak dari contoh publik. Blok aturan Anda sudah memberitahunya untuk tidak melakukannya, karena mesin sudah diautentikasi melalui apidog login. Tegaskan kembali baris tersebut, dan jangan pernah meletakkan token asli di file aturan. Untuk cara kerja autentikasi sebenarnya, lihat autentikasi Apidog CLI.
Ini menciptakan flag. Kesalahan "unknown option" berarti agen menebak flag yang tidak dimiliki versi Anda. Suruh ia untuk menjalankan apidog run --help dan menyalin flag yang tepat dari sana, yang selalu benar untuk versi yang terinstal Anda.
Ini melaporkan kelulusan pada jalankan yang gagal. Yang paling mahal, dan alasan aturan kode keluar ada di file aturan Anda dan langkah verifikasi Anda. Ketika ringkasan dan kode keluar tidak sesuai, kode keluar yang menang.
Dari agen harian hingga loop yang teruji
Begitulah pengaturannya. Instal apidog-cli sekali mengikuti panduan instalasi, tambahkan blok Apidog singkat ke file aturan Antigravity Anda, dan agen akan tahu cara menjalankan tes API Anda dan membaca hasilnya dalam loop yang sama yang sudah digunakannya untuk mengedit kode. Endpoint yang rusak akan terdeteksi saat agen masih mengerjakan perubahan, bukan setelah dikirim.
Tes di balik GUI berjalan ketika manusia mengklik; perintah satu baris berjalan kapan pun Antigravity memutuskan. Anda terus membangun skenario secara visual di Apidog, dan agen Anda menjalankannya di tempat yang tidak Anda saksikan. Unduh Apidog, buat satu skenario, masukkan perintah apidog run ke dalam file aturan Anda, dan saksikan agen mengambilnya pada perubahan berikutnya. Ketika Anda siap untuk menjalankan perintah yang sama dalam pipeline tanpa kehadiran agen, Apidog CLI di GitHub Actions mencakup rahasia, pelapor, dan gerbang kode keluar.
tombol