Mode agen GitHub Copilot adalah sebuah siklus: ia mengedit file, menjalankan perintah terminal, membaca output, dan memutuskan apa yang harus dilakukan selanjutnya. Jadi, mengapa pengujian API Anda tidak ada dalam siklus tersebut? Mereka berada di Apidog di balik GUI, berjalan ketika seseorang ingat untuk mengklik. Copilot tidak pernah menyentuhnya.
Solusinya adalah satu file konfigurasi. Apidog CLI adalah paket npm, apidog-cli, yang menjalankan skenario pengujian yang Anda buat di Apidog langsung dari terminal. Setelah CLI terinstal dan Copilot mengetahuinya, mode agen menjalankan skenario Apidog dengan cara yang sama seperti ia menjalankan pengujian unit Anda: menjalankan perintah, membaca kode keluar, memperbaiki kode jika berwarna merah.
Jika Anda belum menginstal CLI, lakukan itu terlebih dahulu. Cara menginstal Apidog CLI dengan agen pengkodean AI menjelaskan instalasi npm, proses login, dan eksekusi pertama, dengan agen yang melakukan pengetikan. Artikel ini mengasumsikan apidog --version mencetak angka dan akun Apidog Anda sudah diautentikasi.
Copilot Mana yang Dibahas Ini
Copilot terdiri dari beberapa produk, dan namanya tumpang tindih dengan cara yang membingungkan. Artikel ini membahas antarmuka yang dapat menjalankan perintah shell.
Yang utama adalah mode agen di VS Code. Anda membuka tampilan Copilot Chat, mengalihkan dropdown mode ke Agen, dan ia dapat mengedit beberapa file, menjalankan perintah terminal, dan berulang sampai tugas selesai. Ketika ia ingin menjalankan perintah, ia menunjukkan perintah tersebut dan meminta konfirmasi sebelum mengeksekusinya. Langkah konfirmasi itulah tempat apidog run sangat cocok.
Dua antarmuka terkait patut disebutkan agar Anda tahu yang mana yang sedang Anda gunakan. Agen pengkodean Copilot berjalan secara asinkron di GitHub Actions setelah Anda menetapkan tugas padanya; ia menghasilkan permintaan tarik (pull request) daripada bekerja di editor Anda. Copilot CLI adalah klien terminal terpisah. Keduanya dapat menjalankan perintah, tetapi artikel ini menargetkan mode agen di VS Code, karena di sanalah Anda duduk saat Anda mengkode dan di sanalah siklus edit-uji-perbaiki paling ketat. Pengaturan di bawah ini juga berfungsi untuk agen pengkodean, yang membaca file instruksi yang sama. Untuk gambaran yang lebih luas tentang apa yang berubah ketika Copilot menjadi agen, lihat agen pengkodean baru GitHub Copilot.
Perbedaan ini penting karena Copilot memiliki cara sendiri untuk mempelajari aturan proyek, dan mekanisme tersebut mengubah "jalankan pengujian saya" yang hanya sekali menjadi sesuatu yang Copilot lakukan sendiri. Mekanisme tersebut adalah file instruksi kustom.
Langkah 1: Tambahkan aturan Apidog ke file instruksi Copilot
Copilot membaca instruksi kustom repositori dari satu file: .github/copilot-instructions.md di root repositori Anda. Mode agen, Copilot Chat, tinjauan kode, dan agen pengkodean semuanya memuatnya secara otomatis, sesuai dengan dokumen GitHub tentang instruksi kustom repositori. Anggap saja sebagai CLAUDE.md untuk Claude Code atau AGENTS.md untuk Codex: file Markdown biasa berisi instruksi proyek yang ditarik Copilot ke dalam konteks sebelum mulai bekerja.
Buat file tersebut dan tambahkan blok Apidog singkat:
## Pengujian API dengan Apidog CLI
Ketika Anda mengubah endpoint API, verifikasi dengan Apidog CLI sebelum
menyatakan tugas selesai. Jalankan:
apidog run -t 812345 -e 671234 -r cli
- `apidog run` keluar 0 ketika setiap pernyataan lulus, bukan nol pada kegagalan apa pun.
Perlakukan keluar bukan nol sebagai pengujian yang gagal, bahkan jika teks ringkasan terlihat baik-baik saja.
- Mesin sudah diautentikasi melalui `apidog login`. JANGAN tambahkan
flag `--access-token` dan jangan pernah meletakkan token di file ini.
- Jika Anda mengalami kesalahan "unknown option", jalankan `apidog run --help` dan gunakan
flag yang sebenarnya. Jangan menebak.
Ganti nilai -t dan -e dengan ID skenario dan lingkungan Anda yang sebenarnya dari langkah berikutnya.
Tuliskan ke dalam file instruksi alih-alih menyebutkannya di obrolan karena ID skenario yang diketik ke obrolan akan hilang ketika sesi berakhir. Satu di .github/copilot-instructions.md ada untuk setiap rekan tim, setiap sesi mode agen, dan setiap permintaan tarik (pull request) yang dibuka agen pengkodean mulai sekarang. Jika Anda ingin aturan tersebut hanya berlaku untuk file tertentu, GitHub juga mendukung instruksi khusus jalur di .github/instructions/NAMA.instructions.md, tetapi satu file di seluruh repositori sudah cukup di sini.
Langkah 2: Dapatkan perintah dari Apidog
Anda tidak perlu menulis perintah apidog run secara manual. Apidog menghasilkannya untuk Anda.
Buka skenario pengujian di Apidog, buka tab CI/CD-nya, dan salin perintahnya. Ini akan terbentuk sempurna dengan ID skenario yang benar (-t), ID lingkungan (-e), dan flag reporter:
apidog run -t 812345 -e 671234 -r cli
Tempel ID-ID persis tersebut ke dalam blok di .github/copilot-instructions.md Anda. ID-ID ini adalah sumber kebenaran; ketika Copilot dan file instruksi Anda tidak setuju, tab CI/CD yang menang. Untuk seluruh set flag dan reporter, lihat referensi perintah apidog run.
Langkah 3: Minta mode agen menjalankan pengujian
Buka tampilan Copilot Chat di VS Code dan alihkan dropdown mode ke Agen. Karena mode agen memuat .github/copilot-instructions.md saat dimulai, ia sudah tahu bahwa CLI ada di sana. Lakukan perubahan yang menyentuh API Anda, atau tanyakan langsung:
Run the Apidog API test scenario and tell me the result.
Copilot mengeluarkan perintah apidog run dari file instruksi Anda. Mode agen tidak menjalankan perintah terminal secara diam-diam; ia menunjukkan perintah tersebut dan meminta Anda untuk mengonfirmasi sebelum mengeksekusi, sehingga Anda melihat persis apa yang akan dijalankan. Setujui. Reporter -r cli kemudian mencetak hasil langkah demi langkah dan ringkasan langsung di terminal terintegrasi, tempat Anda mengamati setiap permintaan dan pernyataan saat terjadi.
Anda ingin melihat dua hal: eksekusi berjalan, dan Copilot melaporkan kembali ringkasan serta kode keluar. Jika Anda menyetujui perintah sekali, VS Code dapat mengingat pilihan Anda untuk perintah tersebut di ruang kerja, sehingga panggilan apidog run selanjutnya dieksekusi tanpa perlu konfirmasi ulang. Skenario pengujian hanya-baca terhadap staging adalah jenis perintah yang aman, di dalam ruang kerja yang baik untuk diizinkan.
Langkah 4: Baca laporan di dalam Copilot
Ketika eksekusi berwarna merah, laporan memiliki jawabannya. Dengan -r cli, Copilot mendapatkan rincian yang mudah dibaca di terminal: setiap permintaan, setiap pernyataan, dan mana yang gagal dengan nilai yang diharapkan versus nilai sebenarnya. Pernyataan yang gagal menyebutkan bidang atau kode status yang tepat, yang biasanya cukup bagi Copilot untuk menemukan perbaikan pada iterasi berikutnya.
Untuk laporan yang dapat Anda buka di browser atau serahkan kepada rekan tim, tambahkan reporter HTML:
apidog run -t 812345 -e 671234 -r cli,html
Reporter html menulis file mandiri ke ./apidog-reports. Pertahankan cli dalam daftar agar Copilot tetap mendapatkan output inline yang dibacanya untuk memutuskan langkah selanjutnya. Untuk setiap format reporter, termasuk output JUnit yang diurai oleh dashboard CI, lihat panduan lengkap Apidog CLI dan cara membaca laporan pengujian Apidog CLI.
Pengujian Copilot di dalam siklusnya sendiri
Intinya adalah apa yang terjadi ketika Anda berhenti bertanya dan Copilot menjalankan skenario sendiri karena file instruksi memberitahunya untuk melakukannya.
Bayangkan mode agen mengedit penangan 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. Hijau, ia melanjutkan. 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 Copilot untuk menjalankan pengujian unit Anda. Anda menulis satu instruksi dan Copilot mengintegrasikan perintah tersebut ke dalam cara kerjanya.
Ini adalah model delegasi-lalu-verifikasi yang membuat alur kerja agen apa pun aman. Copilot 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 Copilot benar-benar menjalankan CLI
Agen melaporkan keberhasilan yang tidak mereka peroleh, dan Copilot tidak terkecuali. Tiga pemeriksaan, sesuai urutan seberapa sering mereka menemukan masalah.
Pertama, konfirmasikan apakah perintah tersebut benar-benar dijalankan. Mode agen menampilkan perintah yang dieksekusi dan outputnya secara inline di terminal. Cari baris literal apidog run ... dan hasilnya di bawahnya. Jika Copilot mengatakan ia menjalankan pengujian tetapi Anda tidak melihat perintahnya, berarti ia merangkum sesuatu yang tidak pernah dilakukannya. Minta ia untuk menjalankan lagi dan tampilkan output mentahnya.
Kedua, konfirmasi kode keluar, yang paling penting:
What was the exit code of that apidog run command?
apidog run keluar 0 ketika setiap pernyataan lulus dan bukan nol ketika ada yang gagal. Perilaku tunggal itu memungkinkan Copilot, atau pipeline, memperlakukan eksekusi sebagai gerbang yang bersih. Ketika prosa Copilot mengatakan "pengujian lulus" tetapi kode keluar bukan nol, kode keluar itulah yang benar.
Ketiga, konfirmasikan bahwa ia menggunakan skenario yang sebenarnya. Jika eksekusi gagal dengan "skenario tidak ditemukan", Copilot mungkin telah menciptakan atau salah mengingat ID. Periksa kembali nilai -t dan -e terhadap file instruksi Anda dan perintah yang dihasilkan Apidog di tab CI/CD. ID dari Apidog adalah kebenaran.
Opsional: Hubungkan server MCP Apidog
Menjalankan apidog run dari file instruksi Anda mencakup sebagian besar yang Anda butuhkan. Untuk melangkah lebih jauh, hubungkan server MCP Apidog.
Mode agen di VS Code membaca server MCP dari file .vscode/mcp.json di root repositori Anda, sesuai dengan dokumen GitHub tentang memperluas Copilot dengan MCP. Server MCP Apidog mengekspos spesifikasi API Anda melalui MCP, sehingga Copilot dapat membaca skema Anda saat menulis kode, bukan hanya setelah fakta. Pembagian kerjanya jelas: CLI menjalankan pengujian, dan MCP memberikan spesifikasi kepada agen.
Jika Anda menjalankan agen pengkodean Copilot di GitHub Actions, konfigurasi MCP-nya berada di tempat yang berbeda. Anda menambahkannya sebagai JSON di bawah Pengaturan repositori, di bagian Copilot di bawah agen Cloud, dengan rahasia apa pun yang disimpan sebagai rahasia Actions yang diawali COPILOT_MCP_. File .vscode/mcp.json adalah untuk mode agen di editor Anda.
Ketika Copilot Melakukan Kesalahan
Beberapa kegagalan sering muncul selama penyiapan.
Ia mengabaikan file instruksi. Jika Copilot menjalankan perintah generik atau tidak sama sekali, file tersebut mungkin tidak dimuat. Pastikan namanya persis .github/copilot-instructions.md, berada di direktori .github di root repositori Anda, dan instruksi kustom diaktifkan di pengaturan VS Code Anda. Jalur yang salah berarti Copilot tidak pernah membacanya.
Ia tetap meneruskan token akses. Jika Copilot mencoba menambahkan --access-token, itu berarti ia menebak dari contoh publik. Blok tersebut sudah memberitahunya untuk tidak melakukannya, karena mesin sudah diautentikasi melalui apidog login. Tegaskan kembali baris tersebut, dan jangan pernah meletakkan token asli di file instruksi. Untuk model autentikasi, lihat autentikasi Apidog CLI.
Ia membuat flag baru. Kesalahan "unknown option" berarti Copilot menebak flag yang tidak dimiliki versi Anda. Beri tahu ia untuk menjalankan apidog run --help dan salin flag yang persis dari sana, yang selalu benar untuk versi yang Anda instal.
Ia melaporkan lulus pada eksekusi yang gagal. Yang paling merugikan, dan alasan aturan kode keluar ada di file instruksi dan langkah verifikasi Anda. Ketika ringkasan dan kode keluar tidak sesuai, kode keluar itulah yang benar.
Dari agen harian ke siklus yang teruji
Itulah pengaturannya. Instal apidog-cli sekali mengikuti panduan instalasi, tambahkan blok Apidog singkat ke .github/copilot-instructions.md repositori Anda, dan Copilot tahu cara menjalankan pengujian API Anda dan membaca hasilnya di dalam siklus yang sama yang sudah digunakannya untuk mengedit kode. Sebuah endpoint yang rusak akan tertangkap saat Copilot masih mengerjakan perubahan, bukan setelah dikirim.
Pengujian di balik GUI berjalan ketika manusia mengklik; perintah satu baris berjalan kapan pun Copilot memutuskan. Anda terus membangun skenario secara visual di Apidog, dan agen Anda menjalankannya di tempat Anda tidak mengamati. Unduh Apidog, bangun satu skenario, masukkan perintah apidog run-nya ke .github/copilot-instructions.md, dan saksikan Copilot mengambilnya pada perubahan berikutnya. Ketika Anda siap menjalankan perintah yang sama dalam pipeline tanpa Copilot, Apidog CLI di GitHub Actions mencakup rahasia, reporter, dan gating kode keluar.