Cline adalah sebuah siklus: ia merencanakan perubahan, mengedit file, menjalankan perintah, membaca output, dan memutuskan apa yang harus dilakukan selanjutnya. Jadi, mengapa tes API Anda tidak berada dalam siklus itu? Mereka berada di Apidog di balik GUI, menunggu seseorang untuk mengingat untuk mengklik. Agen Anda tidak pernah menyentuhnya.
Solusinya 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 Cline mengetahuinya, agen Anda menjalankan skenario Apidog dengan cara yang sama seperti menjalankan tes unit Anda: tembak perintahnya, baca kode keluar, perbaiki kode jika kembali merah.
Jika Anda belum menginstal CLI, lakukan itu terlebih dahulu. Cara menginstal Apidog CLI dengan agen pengkodean AI menjelaskan instalasi npm, otentikasi, dan jalankan pertama, dengan Cline yang melakukan pengetikan. Artikel ini mengasumsikan apidog --version mencetak angka dan akun Apidog Anda sudah diautentikasi.
Cline yang mana yang dimaksud
Cline adalah agen pengkodean otonom sumber terbuka yang berjalan sebagai ekstensi VS Code (ada juga build JetBrains dan CLI). Ia membaca repositori Anda, merencanakan dalam mode Plan, lalu beralih ke mode Act untuk mengedit file dan menjalankan perintah shell, meminta persetujuan berdasarkan pengaturan persetujuan otomatis Anda. Ia bukan chatbot yang di-host; modelnya berjalan terhadap basis kode Anda di mesin Anda. Jika Anda memiliki panel Cline terbuka di VS Code dan ia menunjukkan perbedaan serta output terminal saat bekerja, Anda berada di tempat yang tepat. Cara menggunakan Cline mencakup dasar-dasar instalasi dan pemilihan model.
Perbedaan ini penting karena Cline memiliki caranya sendiri dalam mempelajari aturan proyek, dan mekanisme tersebut mengubah "jalankan tes saya" yang sekali jadi sesuatu yang Cline akan cari sendiri. Mekanisme itu adalah direktori .clinerules/.
Langkah 1: Tambahkan aturan ke .clinerules, bukan pengingat obrolan
Cline memuat aturan proyek dari direktori .clinerules/ di root ruang kerja Anda sebelum memulai tugas. Ia membaca setiap file .md dan .txt di dalam folder tersebut dan menggabungkannya menjadi set instruksi yang dibawanya selama sesi. Anda juga bisa menggunakan satu file .clinerules jika Anda mau, tetapi direktori akan lebih baik skalanya seiring bertambahnya aturan Anda. Ini didokumentasikan dalam referensi aturan Cline.
Buatlah file seperti .clinerules/apidog.md di root repo Anda dengan blok singkat seperti ini:
# API testing with Apidog
- To test the API, run the Apidog CLI, not curl or ad-hoc scripts.
- Command: apidog run -t <scenario_id> -e <env_id> -r cli
- The scenario ID and environment ID come from Apidog's CI/CD tab. Use those exact values.
- Exit code 0 means every assertion passed. Non-zero means a failure; the exit code is the source of truth, not your summary.
- The machine is already authenticated via `apidog login`. Never add --access-token and never put a token in this file.
- If a flag is unknown, run `apidog run --help` and use the exact flag from there.
Inilah mengapa Anda menulis CLI ke dalam .clinerules/ daripada menyebutkannya di obrolan. ID skenario yang diketik ke dalam pesan Cline akan hilang saat tugas berakhir. Yang ada di .clinerules/apidog.md akan selalu ada untuk setiap rekan tim yang memeriksa repo dan setiap tugas Cline mulai sekarang. File ini dikontrol versi, sehingga aturan tersebut ikut bersama kode.
Langkah 2: Dapatkan perintah dari Apidog
Anda membutuhkan perintah apidog run yang sebenarnya, bukan yang ditebak. Buka skenario pengujian di Apidog, buka tab CI/CD-nya, dan salin perintah yang dihasilkan. Bentuknya seperti ini:
apidog run -t 8291 -e 42 -r cli
Nilai -t adalah ID skenario pengujian Anda dan -e adalah ID lingkungan. Ini adalah nilai-nilai persis yang seharusnya ada di .clinerules/apidog.md. Tempelkan mereka ke dalam blok aturan agar Cline selalu memiliki ID yang benar. Untuk set flag lengkap, lihat referensi perintah apidog run.
Langkah 3: Minta Cline menjalankan pengujian
Dengan aturan yang sudah ada, mulai tugas di panel Cline. Cline memuat .clinerules/ saat ia memulai, sehingga ia sudah tahu CLI ada di sana. Lakukan perubahan yang menyentuh API Anda, atau minta saja untuk menjalankan pemeriksaan:
Jalankan skenario tes Apidog dan beritahu saya hasilnya.
Cline merencanakan langkah tersebut, lalu beralih ke mode Act untuk mengeluarkan perintah apidog run dari aturan Anda. Seberapa banyak ia bertanya terlebih dahulu tergantung pada pengaturan persetujuan Anda. Cline mengevaluasi setiap perintah dan menandainya sebagai aman atau memerlukan persetujuan; skenario pengujian hanya-baca terhadap staging adalah jenis perintah yang dianggap aman. Jika pengaturan persetujuan otomatis Anda mengizinkan perintah aman dieksekusi, apidog run berjalan tanpa prompt. Jika tidak, Cline akan berhenti dan bertanya; setujui, dan aktifkan persetujuan otomatis untuk execute-safe-commands jika Anda ingin ia menjalankan skenario di masa mendatang secara mandiri. Reporter -r cli mencetak hasil langkah demi langkah dan ringkasan langsung di terminal, tempat Anda mengamati setiap permintaan dan pernyataan saat terjadi.
Langkah 4: Baca laporan di dalam Cline
Ketika sebuah eksekusi gagal (berwarna merah), laporan tersebut memiliki jawabannya. Dengan -r cli, Cline mendapatkan rincian yang mudah dibaca di panel output terminal: setiap permintaan, setiap pernyataan, dan mana yang gagal, dengan nilai yang diharapkan versus nilai aktual. Pernyataan yang gagal menyebutkan bidang atau kode status yang tepat, yang biasanya cukup bagi Cline untuk menemukan perbaikan pada putaran berikutnya.
Untuk laporan yang dapat Anda buka di browser atau berikan kepada rekan tim, tambahkan reporter HTML:
apidog run -t 8291 -e 42 -r cli,html
Reporter html menulis file mandiri ke ./apidog-reports. Pertahankan cli dalam daftar agar Cline tetap mendapatkan output inline yang dibacanya untuk memutuskan langkah selanjutnya. Untuk setiap flag dan reporter, termasuk format JUnit yang diurai oleh dashboard CI, lihat panduan lengkap Apidog CLI dan panduan laporan pengujian Apidog CLI.
Pengujian Cline dalam siklusnya sendiri
Manfaatnya adalah apa yang terjadi ketika Anda berhenti bertanya dan Cline menjalankan skenario sendiri karena .clinerules/ menyuruhnya.
Bayangkan Cline mengedit handler yang membangun respons checkout. Siklusnya berubah: ia mengedit kode, lalu, alih-alih menyatakan kemenangan, ia menjalankan skenario Apidog Anda terhadap staging, membaca kode keluar, dan bertindak berdasarkan itu. Jika hijau, ia melanjutkan. Jika merah, ia membuka laporan, membaca pernyataan mana yang gagal (kode status, bidang yang hilang, nilai yang salah), mencoba perbaikan, dan menjalankannya kembali. Pengujian API menjadi bagian dari siklus edit-uji-perbaiki yang sama yang sudah digunakan Cline untuk menjalankan tes unit Anda. Anda menulis satu instruksi dan Cline menyatukan perintah tersebut ke dalam cara kerjanya.
Ini adalah model delegasikan-lalu-verifikasi yang membuat alur kerja agen apa pun aman. Cline menjalankan perintah dan membaca hasilnya; Anda tetap membuat skenario secara visual di Apidog dan memeriksa bahwa agen membaca kode keluar dengan jujur. Untuk pola yang lebih luas, lihat cara menggunakan agen AI untuk pengujian API dan perangkat uji Apidog AI.
Verifikasi Cline benar-benar menjalankan CLI
Agen melaporkan keberhasilan yang tidak mereka peroleh, dan Cline tidak terkecuali. Tiga pemeriksaan, berdasarkan seberapa sering mereka menemukan masalah.
Pertama, konfirmasi apakah perintah tersebut benar-benar dijalankan. Cline menunjukkan perintah yang dieksekusi dan outputnya secara inline di tampilan tugas. Cari baris literal apidog run ... dan hasilnya di bawahnya. Jika Cline mengatakan ia menjalankan pengujian tetapi Anda tidak melihat perintahnya, berarti ia meringkas sesuatu yang tidak pernah dilakukannya. Minta ia untuk menjalankannya lagi dan tunjukkan output mentahnya.
Kedua, konfirmasi kode keluar, yang paling penting:
Berapa kode keluar dari perintah apidog run itu?
apidog run keluar dengan 0 ketika setiap pernyataan berhasil dan non-nol ketika ada yang gagal. Perilaku tunggal itu memungkinkan Cline, atau sebuah pipeline, memperlakukan eksekusi sebagai gerbang yang bersih. Ketika tulisan Cline mengatakan “pengujian berhasil” tetapi kode keluarnya bukan nol, kode keluarnya yang benar.
Ketiga, konfirmasi bahwa ia menggunakan skenario yang sebenarnya. Jika sebuah eksekusi gagal dengan “skenario tidak ditemukan,” Cline mungkin telah membuat atau salah mengingat ID. Periksa kembali nilai -t dan -e terhadap .clinerules/apidog.md dan perintah yang dihasilkan Apidog di tab CI/CD. ID dalam file aturan adalah kebenarannya.
Opsional: hubungkan server Apidog MCP
Menjalankan apidog run dari .clinerules/ mencakup sebagian besar yang Anda butuhkan. Ada satu cara yang lebih jauh.
Cline memiliki dukungan kelas satu untuk Protokol Konteks Model (Model Context Protocol). Di ekstensi VS Code, klik ikon Server MCP di panel Cline, buka Konfigurasi, dan klik Konfigurasi Server MCP untuk membuka cline_mcp_settings.json; tambahkan server Anda di bawah objek mcpServers. Anda juga dapat menjelajahi MCP Marketplace di dalam Cline untuk menginstal server tanpa mengedit JSON secara manual, seperti yang dijelaskan dalam dokumentasi Cline MCP. Server Apidog MCP mengekspos spesifikasi API Anda melalui MCP, sehingga Cline dapat membaca skema Anda saat ia menulis kode, bukan hanya setelah itu. CLI menjalankan pengujian; MCP memberi makan agen spesifikasinya.
Cline adalah ekstensi interaktif, jadi tidak ada mode pengujian non-interaktif yang terpasang di dalamnya seperti yang akan diberikan oleh runner tanpa kepala. Untuk menjalankan apidog run dalam pipeline tanpa Cline, Apidog CLI di GitHub Actions mencakup rahasia, reporter, dan pembatasan kode keluar, dan panduan pipeline CI/CD Apidog CLI mencakup pengaturan yang lebih luas.
Ketika Cline salah
Beberapa kegagalan sering muncul selama pengaturan.
Ia mengabaikan file aturan. Jika Cline menjalankan perintah generik atau tidak sama sekali, aturan mungkin tidak dimuat. Pastikan folder tersebut bernama persis .clinerules dan berada di root ruang kerja Anda, serta file di dalamnya berakhiran .md atau .txt. Memulai tugas baru memaksa Cline untuk memuat ulang aturan.
Ia tetap meneruskan token akses. Jika Cline mencoba menambahkan --access-token, ia menebak dari contoh publik. Aturan sudah memberitahunya untuk tidak melakukannya, karena mesin sudah diautentikasi melalui apidog login. Perkuat baris tersebut, dan jangan pernah meletakkan token asli di .clinerules/. Untuk cara kerja otentikasi sebenarnya, lihat panduan otentikasi Apidog CLI.
Ia menciptakan sebuah flag. Kesalahan "opsi tidak dikenal" berarti Cline menebak flag yang tidak dimiliki versi Anda. Minta ia untuk menjalankan apidog run --help dan salin flag yang persis dari sana, yang selalu benar untuk versi yang terinstal pada Anda.
Ia melaporkan keberhasilan pada eksekusi yang gagal. Ini adalah yang paling mahal, dan alasan mengapa aturan kode keluar ada di file .clinerules/ Anda dan langkah verifikasi Anda. Ketika ringkasan dan kode keluar tidak setuju, kode keluar yang benar.
Dari agen harian ke siklus yang teruji
Begitulah pengaturannya. Instal apidog-cli sekali dengan mengikuti panduan instalasi, tambahkan aturan Apidog singkat ke direktori .clinerules/ repo Anda, dan Cline tahu cara menjalankan tes API Anda dan membaca hasilnya di dalam siklus yang sama yang sudah digunakannya untuk mengedit kode. Endpoint yang rusak akan tertangkap saat Cline masih mengerjakan perubahan, bukan setelah dikirim.
Sebuah tes di balik GUI berjalan ketika manusia mengklik; sebuah perintah satu baris berjalan kapan pun Cline memutuskan. Anda terus membangun skenario secara visual di Apidog, dan agen Anda menjalankannya di tempat Anda tidak mengamati. Unduh Apidog, buat satu skenario, masukkan perintah apidog run ke dalam .clinerules/apidog.md, dan saksikan Cline mengambilnya pada perubahan berikutnya.