Cara Menggunakan Apidog CLI di Antigravity

Antigravity bekerja dalam sebuah loop: agen mengedit file, menjalankan perintah terminal, membaca output, lalu memutuskan langkah berikutnya. Karena itu, pengujian API seharusnya ikut berada di dalam loop yang sama—bukan hanya tersimpan di GUI dan dijalankan saat seseorang ingat untuk mengkliknya. Dengan Apidog CLI, agen dapat menjalankan skenario pengujian API langsung dari terminal, membaca kode keluar, lalu memperbaiki kode ketika pengujian gagal.

Coba Apidog hari ini

Solusinya cukup sederhana: instal paket npm apidog-cli, autentikasi sekali, lalu tambahkan instruksi perintah pengujian ke file aturan Antigravity. Setelah itu, agen dapat memperlakukan skenario Apidog seperti unit test: jalankan perintah, periksa exit code, dan lanjutkan atau perbaiki berdasarkan hasilnya.

Jika CLI belum terinstal, ikuti cara menginstal Apidog CLI dengan agen pengkodean AI. Artikel ini mengasumsikan perintah berikut sudah berhasil:

apidog --version

Selain itu, akun Apidog Anda harus sudah diautentikasi.

Antigravity yang dimaksud

Antigravity adalah platform pengembangan agen Google yang dibangun di atas Gemini 3 dan diluncurkan pada akhir 2025. Agen dijalankan melalui Agent Manager untuk merencanakan pekerjaan, mengedit file di repositori, serta mengeksekusi perintah shell pada terminal dan browser.

Antigravity dapat mempelajari aturan proyek dari file di workspace. Ini penting karena instruksi seperti “jalankan tes API saya” tidak perlu diketik ulang pada setiap sesi. Untuk pengenalan platformnya, lihat apa itu Google Antigravity dan cara menggunakannya.

Langkah 1: Tambahkan aturan Apidog ke workspace

Antigravity mengenali direktori .agents/ di root workspace. Codelab Google tentang membangun pipeline pengembang otonom di Antigravity menunjukkan bahwa aturan workspace dapat ditempatkan di .agents/rules/.

Buat file berikut:

.agents/rules/apidog.md

Jika proyek Anda sudah memiliki AGENTS.md di root, Anda dapat meletakkan aturan ini di sana. File tersebut juga digunakan sebagai fondasi lintas alat, termasuk oleh Codex untuk Apidog CLI.

Tambahkan instruksi ringkas berikut:

## 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.
- Kode keluar bukan nol berarti kegagalan; buka laporan dan perbaiki kode.
- Mesin sudah diautentikasi melalui `apidog login`.
- Jangan pernah menambahkan flag `--access-token` atau menyimpan token di file ini.

Mengapa menggunakan file aturan, bukan instruksi chat?

• Antigravity tidak menyimpan instruksi chat sebagai aturan permanen antar-sesi.
• ID skenario yang hanya diberikan di chat dapat hilang saat sesi berakhir.
• File aturan dapat digunakan oleh semua anggota tim dan semua sesi Antigravity berikutnya.

Langkah 2: Salin perintah dari Apidog

Jangan menebak ID skenario atau environment.

1. Buka skenario pengujian di Apidog.
2. Buka tab CI/CD.
3. Salin perintah yang dihasilkan.

Contohnya:

apidog run -t 123456 -e 789012 -r cli

Arti flag:

• -t: ID skenario pengujian.
• -e: ID environment.
• -r cli: gunakan reporter CLI agar hasil dibaca langsung dari terminal.

Tempelkan perintah dengan ID sebenarnya ke .agents/rules/apidog.md. Dengan begitu, agen menjalankan perintah yang sama persis seperti yang diberikan oleh Apidog.

Untuk detail semua opsi, lihat referensi perintah apidog run.

Langkah 3: Minta agen menjalankan pengujian

Setelah file aturan tersedia, mulai tugas baru di Antigravity. Agen akan memuat aturan workspace saat tugas dimulai.

Anda dapat meminta agen secara langsung:

Jalankan skenario pengujian Apidog dan beritahu saya kode keluarnya.

Agen seharusnya menjalankan perintah apidog run dari file aturan di terminalnya.

Apakah Antigravity menjalankan perintah tanpa konfirmasi bergantung pada preset keamanan Anda. Codelab memulai dengan Antigravity menjelaskan bahwa perintah terminal dan akses file dapat memerlukan persetujuan manual.

Untuk skenario read-only terhadap environment staging, Anda dapat menyetujui perintah seperti:

apidog run -t 123456 -e 789012 -r cli

Pastikan agen menampilkan:

1. Perintah yang dijalankan.
2. Output mentah dari CLI.
3. Ringkasan hasil.
4. Kode keluar.

Jangan hanya menerima parafrase seperti “tes berhasil”.

Langkah 4: Baca laporan langsung dari terminal

Jika pengujian gagal, output dari reporter CLI menyediakan informasi yang diperlukan untuk perbaikan, seperti:

• Request yang dijalankan.
• Assertion yang gagal.
• Kode status yang diharapkan dan aktual.
• Field yang hilang.
• Nilai yang berbeda dari ekspektasi.

Agen dapat menggunakan output tersebut untuk menemukan bagian kode yang perlu diperbaiki.

Untuk menghasilkan laporan yang dapat dibuka di browser, tambahkan reporter HTML:

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

Reporter html akan menulis laporan mandiri ke:

./apidog-reports

Tetap gunakan cli bersama html, karena output inline diperlukan agen untuk mengambil keputusan pada loop berikutnya.

Untuk reporter lain, termasuk format JUnit untuk dashboard CI, lihat panduan lengkap Apidog CLI dan cara membaca laporan pengujian Apidog CLI.

Masukkan pengujian API ke loop agen

Tujuan akhirnya bukan hanya menjalankan perintah saat diminta, tetapi membuat agen menjalankannya sebagai bagian dari workflow.

Contoh loop saat agen mengubah handler checkout:

1. Agen mengedit handler respons checkout.
2. Agen menjalankan skenario Apidog terhadap staging.
3. Agen membaca exit code dan assertion yang gagal.
4. Jika exit code 0, agen melanjutkan pekerjaan.
5. Jika exit code bukan 0, agen memperbaiki kode.
6. Agen menjalankan skenario kembali.

Dengan aturan yang eksplisit, tes API menjadi bagian dari loop edit-test-fix yang sama dengan unit test.

Anda tetap membuat dan memelihara skenario secara visual di Apidog. Antigravity menjalankan perintah dan membaca hasilnya. Untuk pola penggunaan yang lebih luas, lihat cara menggunakan agen AI untuk pengujian API dan alat uji AI Apidog.

Verifikasi bahwa Antigravity benar-benar menjalankan CLI

Jangan hanya mengandalkan ringkasan agen. Lakukan tiga pemeriksaan berikut.

1. Pastikan perintah benar-benar dijalankan

Di terminal Antigravity, cari baris berikut secara literal:

apidog run ...

Kemudian periksa output tepat di bawahnya.

Jika agen mengklaim sudah menjalankan tes tetapi tidak ada perintah atau output terminal, minta agen menjalankan ulang dan menampilkan output mentah.

2. Periksa exit code

Tanyakan secara langsung:

Berapa kode keluar dari perintah apidog run itu?

Perilaku apidog run:

• Exit code 0: semua assertion lulus.
• Exit code bukan 0: ada assertion atau eksekusi yang gagal.

Exit code harus menjadi sumber kebenaran. Jika agen mengatakan “tes lulus” tetapi exit code bukan nol, hasil sebenarnya adalah gagal.

3. Pastikan agen memakai ID skenario yang benar

Jika eksekusi menampilkan error seperti “skenario tidak ditemukan”, agen mungkin menggunakan atau mengingat ID yang salah.

Bandingkan nilai berikut:

-t <scenario_id>
-e <env_id>

Periksa terhadap:

• File .agents/rules/apidog.md atau AGENTS.md.
• Perintah yang dihasilkan Apidog pada tab CI/CD.

ID di file aturan Anda harus menjadi referensi utama.

Opsional: Sambungkan server MCP Apidog

Menjalankan apidog run dari file aturan sudah cukup untuk sebagian besar workflow. Jika Anda ingin agen juga membaca spesifikasi API saat menulis kode, tambahkan server MCP Apidog.

Antigravity mendukung Model Context Protocol dan mengonfigurasi server MCP melalui file:

$HOME/.gemini/config/mcp_config.json

Menurut codelab memulai Google Antigravity, tambahkan server ke objek mcpServers menggunakan properti seperti:

• command
• args
• env

Setelah itu, refresh konfigurasi MCP dari pengaturan Antigravity.

Server MCP Apidog mengekspos spesifikasi API melalui MCP. Perannya berbeda dari CLI:

• Apidog CLI: menjalankan skenario pengujian.
• Apidog MCP: memberi agen akses ke spesifikasi dan skema API saat menulis kode.

Troubleshooting

Agen mengabaikan file aturan

Jika agen menjalankan perintah generik atau tidak menjalankan apa pun:

1. Pastikan file berada di .agents/rules/.
2. Pastikan nama file dan formatnya benar.
3. Mulai tugas Antigravity baru agar aturan dimuat ulang.

Agen mencoba menambahkan --access-token

Jika agen menambahkan flag --access-token, ia kemungkinan menebak dari contoh publik.

Aturan Anda harus menyatakan bahwa autentikasi dilakukan melalui:

apidog login

Jangan menyimpan token akses asli di file aturan. Untuk detail autentikasi, lihat autentikasi Apidog CLI.

Agen menciptakan flag yang tidak valid

Error seperti berikut berarti agen memakai flag yang tidak tersedia pada versi CLI Anda:

unknown option

Minta agen menjalankan:

apidog run --help

Gunakan output tersebut sebagai sumber kebenaran untuk flag yang didukung oleh versi terinstal.

Agen melaporkan lulus pada eksekusi yang gagal

Bandingkan ringkasan agen dengan exit code.

Jika keduanya berbeda, exit code yang benar. Itulah alasan aturan exit code perlu ditulis eksplisit di file aturan proyek.

Dari agen harian ke loop yang teruji

Setup-nya sederhana:

1. Instal apidog-cli mengikuti panduan instalasi.
2. Autentikasi dengan apidog login.
3. Salin perintah apidog run dari tab CI/CD Apidog.
4. Tambahkan perintah tersebut ke .agents/rules/apidog.md atau AGENTS.md.
5. Minta Antigravity menjalankan skenario dan memeriksa exit code.

Dengan pendekatan ini, endpoint yang rusak dapat terdeteksi saat agen masih mengerjakan perubahan, bukan setelah kode dikirim.

Anda tetap membangun skenario secara visual di Apidog, sementara agen menjalankannya sebagai bagian dari workflow pengembangan. Unduh Apidog, buat satu skenario, lalu masukkan perintah apidog run ke file aturan Anda.

Jika Anda ingin menjalankan perintah yang sama di pipeline tanpa agen, lihat Apidog CLI di GitHub Actions untuk konfigurasi rahasia, reporter, dan gerbang exit code.