Pembaruan Apidog CLI: Dari Eksekutor Uji ke Lapisan Alur Kerja Agen

Apidog CLI telah lama menjadi titik masuk baris perintah untuk menjalankan tes API dari terminal, pipeline CI, alur kerja otomatisasi, atau sistem eksternal.

apidog run --project <projectId> --test-scenario <scenarioId> --environment <environmentId>

Fondasi tersebut masih penting. Tim masih membutuhkan cara yang andal untuk menjalankan tes API, membuat laporan, dan menjaga gerbang kualitas di dalam CI. Namun, pengembangan API sedang berubah. Agen AI kini berpartisipasi dalam desain API, pembuatan tes, debugging, migrasi, dan pemeliharaan.

Untuk alur kerja tersebut, CLI tidak hanya bisa menjadi langkah terakhir yang menjalankan tes yang sudah ada. Ia juga perlu memberikan Agen cara yang stabil untuk membaca aset API, membuat atau memperbarui aset tes, memvalidasi perubahan terstruktur, menulisnya kembali, dan memverifikasi hasilnya.

Apidog CLI yang telah ditingkatkan mempertahankan fondasi menjalankan tes yang asli dan memperluasnya menjadi lapisan alur kerja untuk pengembang, skrip, dan Agen AI. Artikel ini menjelaskan mengapa CLI lebih penting di era Agen AI, apa yang berubah di Apidog CLI, dan bagaimana tim dapat mulai menggunakannya untuk otomatisasi pengujian API.

Mengapa CLI Lebih Penting di Era Agen AI

Antarmuka grafis dirancang untuk manusia. Mereka visual, fleksibel, dan berguna untuk eksplorasi. Namun, Agen AI bekerja paling baik dengan perintah terstruktur, input yang dapat diprediksi, output yang dapat diprediksi, dan langkah validasi yang jelas.

Di situlah CLI menjadi penting. CLI memberikan Agen dan skrip antarmuka yang dapat diulang ke sumber daya yang sama yang dikelola pengembang di Apidog: API, lingkungan, variabel, kasus uji, skenario uji, suite uji, laporan, data impor/ekspor, dan lainnya.

Dalam praktiknya, ini berarti Apidog dapat melayani pengguna manusia maupun alur kerja otomatis. Orang terus merancang, mendebug, meninjau, dan berkolaborasi di antarmuka produk. Agen dan otomatisasi dapat menggunakan CLI untuk melakukan operasi terkontrol di sekitar aset yang sama.

Dari apidog run ke Alur Kerja API dan Pengujian Lengkap

Pengalaman CLI sebelumnya terutama berpusat pada eksekusi tes. Itu membuat apidog run berguna sebagai gerbang kualitas CI, tetapi juga berarti CLI biasanya muncul di dekat akhir alur kerja. CLI yang ditingkatkan memperluas cakupan ke lebih banyak sumber daya inti Apidog, sehingga otomatisasi dapat berpartisipasi lebih awal: membaca konteks proyek, menyiapkan aset tes, memvalidasi perubahan terstruktur, dan kemudian menjalankan verifikasi.

Dengan CLI yang ditingkatkan, pengguna dan Agen dapat bekerja dengan sumber daya seperti:

• Proyek dan metadata proyek
• API dan definisi API
• Lingkungan dan variabel
• Kasus uji
• Skenario uji
• Suite uji
• Laporan
• Alur kerja impor dan ekspor
• Akun, branch, runner, dan sumber daya proyek terkait

Ini mengubah peran Apidog CLI. Ini bukan hanya cara untuk mengeksekusi tes setelah semuanya selesai. Kini ia dapat berpartisipasi lebih awal dalam siklus pengembangan, di mana Agen perlu memahami proyek, menghasilkan atau memperbarui aset tes, memvalidasi perubahan, dan kemudian menjalankan verifikasi.

Loop yang Lebih Aman untuk Pengujian yang Didorong Agen

Ketika Agen AI membantu pengembangan atau pengujian API, bagian yang berisiko bukan hanya menghasilkan konten. Bagian yang berisiko adalah menulis konten yang dihasilkan ke dalam proyek nyata tanpa struktur atau verifikasi yang memadai.

CLI yang ditingkatkan memungkinkan loop yang lebih aman:

Loop ini penting karena banyak sumber daya Apidog bersifat terstruktur. Kasus uji dan skenario uji dapat mencakup data permintaan, asersi, ekstraksi variabel, pre-processor, post-processor, urutan langkah, referensi ke lingkungan, dan detail lainnya. Jika Agen menebak strukturnya, kesalahan kecil dapat menyebabkan penulisan yang gagal, tampilan yang tidak lengkap di UI, atau tes yang tidak berjalan seperti yang diharapkan.

Itu sebabnya cli-schema adalah bagian penting dari peningkatan ini. Sebelum menulis file JSON yang kompleks ke Apidog, Agen dapat meminta CLI untuk memvalidasi apakah bidang dan struktur cocok dengan skema yang diharapkan.

apidog cli-schema validate test-case-create --file ./test-case-create.json
apidog cli-schema validate test-scenario-update --file ./scenario-update.json

Singkatnya: biarkan Agen menghasilkan, tetapi biarkan CLI memvalidasi sebelum penulisan terjadi.

CLI juga dapat memberikan petunjuk berorientasi Agen dalam output perintah. Setelah sumber daya dibuat atau diperbarui, langkah selanjutnya seringkali bukan "berhenti". Agen yang lebih andal harus membaca kembali sumber daya yang disimpan, mengkonfirmasi strukturnya, dan menjalankan tes bila sesuai. Petunjuk ini membantu Agen bergerak melalui alur kerja dengan lebih sedikit titik buta.

Keterampilan Memberikan Penilaian Operasional kepada Agen

Perintah CLI memberikan kekuatan eksekusi kepada Agen. Keterampilan memberikan penilaian operasional kepada Agen.

SEBUAH KETERAMPILAN bukan hanya referensi perintah. Ini lebih seperti panduan operasional yang ditulis untuk Agen AI: kapan menggunakan perintah, perintah mana yang harus didahulukan, bidang mana yang tidak boleh ditebak, kapan memvalidasi, kapan membaca kembali, dan kapan menjalankan tes.

Misalnya, Agen yang andal seharusnya tidak selalu menulis skenario tes besar dari awal. Pola yang lebih aman seringkali adalah:

1. Buat skenario dasar.
2. Impor langkah-langkah dari API atau kasus uji yang sudah ada.
3. Baca kembali struktur skenario lengkap.
4. Perbarui asersi, ekstraksi variabel, atau prosesor dalam langkah-langkah yang lebih kecil.
5. Validasi dan jalankan skenario.

Keterampilan membuat pola-pola ini eksplisit. Mereka membantu Agen menghindari kesalahan umum seperti menggunakan nama bidang yang salah, memilih nilai enum yang salah, melewati validasi skema, atau mengasumsikan bahwa penulisan yang berhasil berarti sumber daya akhir sudah benar.

Apidog menyediakan 8 Keterampilan pendamping untuk membantu Agen memahami perintah CLI, struktur sumber daya, dan alur kerja tugas. Bersama-sama, CLI dan Keterampilan membuat Apidog lebih praktis untuk pengembangan dan pengujian API yang dibantu AI.

Perubahan Proyek yang Lebih Aman dengan Cabang AI

Ketika Agen memodifikasi sumber daya proyek, keamanan dan kemampuan tinjauan itu penting. Untuk alasan itu, CLI yang ditingkatkan juga dapat digunakan bersama dengan Cabang AI.

Agen dapat melakukan perubahan di cabang terisolasi terlebih dahulu. Tim dapat meninjau perbedaan, mengkonfirmasi hasilnya, dan kemudian menggabungkan ke cabang target. Ini membantu mencegah perubahan otomatis memengaruhi cabang utama atau cabang kolaborasi bersama secara langsung.

Apa yang Dibuka oleh Ini dalam Alur Kerja Nyata

Nilai CLI yang ditingkatkan paling mudah dilihat dalam alur kerja konkret.

Hasilkan Tes dari Definisi API

Agen dapat membaca definisi API dari proyek, menghasilkan kasus uji, memvalidasi JSON yang dihasilkan dengan cli-schema, menulis kasus uji ke Apidog, membacanya kembali, dan menjalankan verifikasi. Ini mengubah pembuatan tes dari saran satu kali menjadi alur kerja yang terkontrol.

Pertahankan Skenario Uji yang Kompleks

Untuk skenario multi-langkah, Agen dapat mengimpor langkah-langkah dari API atau kasus uji yang sudah ada terlebih dahulu, kemudian memperbarui asersi, variabel, atau prosesor setelah membaca kembali struktur lengkap. Ini mengurangi risiko membangun skenario besar secara salah dalam satu kali jalan.

apidog test-scenario import-steps <scenarioId> --project <projectId> --source endpoint --ids <endpointIds> --sync manual
apidog test-scenario get <scenarioId> --project <projectId> --with-case-detail

Pindahkan dan Reproduksi Aset Proyek

CLI yang ditingkatkan juga meningkatkan alur kerja impor dan ekspor untuk data asli Apidog. Ini berguna untuk migrasi proyek, mereproduksi lingkungan pelanggan, menyalin pengaturan tes, atau memindahkan API, skema, kasus uji, dan skenario antar proyek.

apidog export --project <projectId> --format apidog --output ./project.apidog.json
apidog import --project <projectId> --format apidog --file ./project.apidog.json

Pertahankan Gerbang Kualitas CI

Kemampuan baru yang siap-Agen tidak menggantikan CI. Mereka melengkapinya. Tim masih dapat menggunakan apidog run sebagai titik masuk inti untuk eksekusi tes otomatis dan laporan.

apidog run --project <projectId> --test-scenario <scenarioId> --environment <environmentId> -r "cli,html,junit" --out-dir ./apidog-reports

Memulai

Jika Anda sudah menginstal Apidog CLI, periksa versi Anda saat ini terlebih dahulu:

apidog -v

Jika versi Apidog CLI Anda lebih awal dari 2.2.5, perbarui CLI sebelum menggunakan kemampuan baru. Nomor versi ini merujuk pada Apidog CLI, bukan aplikasi Apidog.

Anda dapat meminta Agen AI yang Anda gunakan untuk menginstal Apidog CLI dan Keterampilan pendamping dengan menyalin prompt ini:

Baca instruksi dan bantu saya menginstal Apidog CLI:
https://apidog.com/apidog-cli-installation-guide.md

Jika Anda lebih suka menginstal atau memperbaruinya secara manual, jalankan:

npm install -g apidog-cli@latest

Untuk referensi perintah lengkap, lihat Opsi Apidog CLI.

Coba Tugas Agen Pertama Anda

Setelah CLI dan Keterampilan terinstal, cara termudah untuk memulai adalah dengan memberikan Agen Anda satu tugas API kecil dan berisiko rendah. Misalnya, minta ia untuk membuat titik akhir pemeriksaan kesehatan sederhana GET /health di proyek Apidog, lalu membacanya kembali untuk mengkonfirmasi hasilnya.

Salin prompt ini ke Agen AI Anda:

Gunakan Apidog CLI untuk membantu saya membuat titik akhir API pertama saya di Apidog. Pertama, periksa pengaturan Apidog CLI saya dan daftar proyek yang dapat saya akses. Tanyakan proyek mana yang akan digunakan. Setelah saya mengkonfirmasi, buat titik akhir GET /health sederhana bernama Health Check dengan contoh respons 200. Validasi input terstruktur apa pun sebelum menulis, lalu baca kembali titik akhir tersebut dan ringkas apa yang telah dibuat.

Ini memberikan titik awal konkret bagi pengguna baru: Agen memeriksa pengaturan, bertanya sebelum menulis ke proyek, membuat definisi API kecil, dan mengkonfirmasi hasil yang disimpan.

Langkah selanjutnya:

• Unduh Apidog untuk merancang, men-debug, menguji, dan mendokumentasikan API dalam satu ruang kerja.
• Pelajari lebih lanjut tentang Apidog CLI untuk pengujian API baris perintah, otomatisasi CI, dan alur kerja Agen AI.

FAQ

Apa itu Apidog CLI?

Apidog CLI adalah alat baris perintah untuk menjalankan tes API, bekerja dengan sumber daya proyek Apidog, dan menghubungkan aset API dan pengujian Apidog ke alur kerja otomatisasi.

Bisakah Apidog CLI menjalankan tes API di CI?

Ya. Tim dapat menggunakan apidog run di pipeline CI untuk menjalankan tes API, membuat laporan, dan menjaga gerbang kualitas otomatis dalam alur kerja pengujian mereka.

Bagaimana Apidog CLI membantu Agen AI?

Apidog CLI memberikan Agen AI cara terstruktur untuk membaca informasi API, menghasilkan atau memperbarui aset tes, memvalidasi perubahan, menuliskannya ke Apidog, membaca kembali hasilnya, dan menjalankan tes untuk verifikasi.

Apa itu cli-schema di Apidog CLI?

cli-schema membantu memvalidasi file JSON yang kompleks sebelum ditulis ke Apidog. Ini mengurangi penulisan yang gagal, bidang yang tidak valid, dan loop coba lagi yang tidak perlu ketika Agen membuat atau memperbarui kasus uji dan skenario uji.

Bagaimana cara menginstal Apidog CLI?

Anda dapat meminta Agen AI untuk mengikuti panduan instalasi Apidog CLI dan menginstal CLI serta Keterampilan pendamping, atau menginstalnya secara manual dengan npm install -g apidog-cli@latest.