M365Con 2027 – konferensi online gratis · 11–22 Jan 2027 · 120 sessions→ m365con.net

Blog · Mirko Peters

Cara menulis test case dalam bahasa sederhana yang dapat dijalankan oleh agen AI

By · · Updated

Tulis test case dalam bahasa Inggris sederhana yang dapat dijalankan oleh agen AI: satu perilaku per test, satu tindakan per langkah, elemen yang diberi nama, dan hasil yang diharapkan yang jelas dan dapat diperiksa.

Automatically translated with AI from the original post. Read the English original

Untuk menulis test case dalam bahasa sederhana yang dapat dijalankan oleh agen AI, batasi setiap test pada satu perilaku, setiap langkah pada satu tindakan, dan setiap pemeriksaan pada satu hasil yang dapat Anda lihat di layar. Panduan ini ditujukan untuk QA lead dan penguji yang ingin beralih dari skrip ke instruksi tertulis tanpa kehilangan keandalan hasil. Anda akan mempelajari lima bagian dari sebuah test case, aturan yang membuat langkah dapat dijalankan, metode untuk mengubah kriteria penerimaan menjadi test, serta contoh lengkap yang dapat Anda salin.

Poin Penting

  • Test case dalam bahasa sederhana memiliki lima bagian: judul, prasyarat, langkah, hasil yang diharapkan, dan data test. Agen AI membutuhkan kelima bagian tersebut dijabarkan secara eksplisit.
  • Tulis satu perilaku per test dan satu tindakan per langkah, karena pembuat alat melaporkan bahwa instruksi satu langkah adalah yang paling akurat.
  • Beri nama setiap elemen sebagaimana pengguna melihatnya, misalnya tombol Log In, alih-alih hanya menulis tombol atau kolom.
  • Berikan setiap test hasil yang diharapkan yang dapat diperiksa di layar, seperti judul atau jumlah tertentu, dan jangan pernah hanya menulis "pastikan berfungsi".
  • Baca apa yang dihasilkan agen sebelum Anda mempercayai hasil lulus, dan tulis ulang setiap langkah yang ditafsirkan dengan cara yang tidak Anda maksudkan.

Lima bagian dari test case dalam bahasa sederhana

Test case yang baik terbaca seperti cerita singkat yang dapat diikuti oleh siapa pun di tim. Dalam pengujian perangkat lunak, menulis test case yang efektif merupakan keterampilan inti QA, dan penguji manual selalu menulisnya dengan bahasa sederhana. Yang baru adalah agen AI kini dapat menjalankan langkah-langkah test tersebut. Hal ini paling berpengaruh untuk end-to-end testing, ketika sebuah test mengikuti pengguna melalui seluruh alur kerja di browser. Bagi agen AI, setiap bagian harus eksplisit, karena agen tidak dapat bertanya kembali apa maksud Anda.

  1. Judul. Satu baris yang menyatakan perilaku, misalnya "Pelanggan dapat mengatur ulang kata sandi yang terlupa". Judul adalah hal pertama yang dilihat pembaca dalam laporan.
  2. Prasyarat. Kondisi produk yang harus ada sebelum test dimulai, misalnya "Akun pelanggan sudah ada dan pelanggan dalam keadaan sudah keluar".
  3. Langkah. Apa yang dilakukan pengguna, satu tindakan per baris.
  4. Hasil yang diharapkan. Apa yang seharusnya dilihat pengguna setelahnya, dalam istilah yang dapat Anda periksa di layar.
  5. Data test. Nilai pasti yang digunakan, misalnya alamat email atau nomor pesanan.

Templat bersama menjaga agar test case dari setiap penguji memiliki bentuk yang sama, dan rangkaian test dengan satu templat jauh lebih mudah ditinjau. Test case juga memerlukan cara untuk memverifikasi hasil, itulah sebabnya hasil yang diharapkan itu penting.

Bentuk ini sama dengan yang digunakan behavior-driven development. Dalam bahasa Gherkin, seperti dijelaskan di Automation Panda, Given menetapkan kondisi awal, When menjalankan tindakan yang diuji, dan Then menyatakan hasil yang diharapkan. Anda tidak harus menggunakan kata kunci tersebut. Ketiga peran ini tetap berguna.

Aturan yang membuat langkah dapat dijalankan oleh agen AI

Penyedia alat menerbitkan panduan untuk menulis instruksi yang dapat diikuti agen AI. Dokumentasi BrowserStack untuk natural language test agent memberikan aturan yang berlaku untuk sebagian besar alat:

  • Mulai dengan kata kerja tindakan. "Click the Submit button" sudah jelas. "The submit button" bukan instruksi.
  • Gunakan satu maksud per perintah. Pecah tugas multi-langkah menjadi langkah-langkah terpisah.
  • Sebutkan elemen yang spesifik. Tulis "the Log In button", bukan "the button".
  • Gulir layar lebih dulu jika target berada di luar area layar. Tambahkan satu langkah sebelum tindakan.

Halaman yang sama menyebutkan bahwa keandalan menurun seiring perintah menjadi semakin kompleks, dan bahwa instruksi satu langkah paling akurat. Tambahkan tiga aturan berdasarkan pengalaman:

  • Gunakan kata-kata yang tampil di layar. Jika tombolnya bertuliskan "Sign in", jangan tulis "Log in".
  • Tulis nilainya di dalam langkah. Tulis "Type ana@example.com into the Email field", bukan "enter a valid email".
  • Hindari kata ganti dan kata yang samar. "It", "there", "properly", dan "correctly" semuanya menyembunyikan keputusan yang harus ditebak oleh agen.

Cara menulis kasus uji dalam bahasa Inggris biasa, langkah demi langkah

Ikuti metode ini untuk mengubah sebuah kebutuhan menjadi kasus uji.

  1. Mulai dari satu kriteria penerimaan. Ambil satu kalimat dari user story, misalnya "A customer who forgets a password can set a new one by email".
  2. Pilih satu perilaku. Setiap kasus uji memeriksa satu perilaku. Panduan Automation Panda tentang writing good Gherkin menyatakannya sebagai "One Scenario, One Behavior" dan menyebutkan bahwa skenario dengan beberapa pasangan When-Then sebaiknya dipecah.
  3. Tulis kondisi awal. Deskripsikan sebagai kondisi, bukan sebagai langkah persiapan. "A customer account exists" lebih baik daripada sepuluh langkah untuk membuat satu akun.
  4. Tulis tindakan pengguna. Setiap tindakan ditulis dalam satu baris pendek dengan kata kerja dan elemen yang disebutkan namanya.
  5. Tulis hasil yang diharapkan. Sebutkan apa yang muncul: judul, pesan, atau nilai. Gunakan teks yang persis sama.
  6. Tambahkan datanya. Tulis nilainya di dalam langkah atau dalam tabel kecil di bawah tes.
  7. Bacakan dengan keras. Jika rekan baru tidak dapat menjalankannya secara manual, agen pun akan kesulitan.

Panduan yang sama menyarankan agar skenario dibuat singkat, dengan kurang dari sepuluh langkah. Kasus uji yang panjang sering kali merupakan beberapa kasus uji yang digabung. Variasi dari satu perilaku, misalnya tiga kata sandi yang tidak valid, sebaiknya ditempatkan dalam tabel data, bukan tiga salinan langkah yang sama.

Contoh: uji pengaturan ulang kata sandi, sebelum dan sesudah

Detailnya fiktif.

Sebelum (terlalu samar). "Check that password reset works." Agen tidak memiliki kondisi awal, tindakan, maupun hasil untuk diperiksa. Tes bisa lolos karena alasan yang keliru.

Sesudah (dapat dijalankan).

  • Judul: Pelanggan dapat meminta tautan pengaturan ulang kata sandi.
  • Prasyarat: Akun pelanggan untuk ana@example.com sudah ada, dan pelanggan dalam keadaan sudah keluar.
  • Langkah 1: Buka halaman Sign in.
  • Langkah 2: Klik tautan "Forgot password".
  • Langkah 3: Ketik ana@example.com ke kolom Email.
  • Langkah 4: Klik tombol "Send reset link".
  • Hasil yang diharapkan: Halaman menampilkan pesan "Check your email".

Versi "sesudah" memiliki satu perilaku, lima tindakan singkat, dan satu hasil yang terlihat. Jika produk Anda juga memerlukan tautan di email agar berfungsi, tulis kasus uji kedua untuk perilaku tersebut. Jangan memperpanjang kasus uji yang pertama.

Sekarang jalankan dan baca lognya. Misalnya, agen mengklik "Forgot password" dengan benar tetapi mengetik alamat ke kotak pencarian. Log menunjukkan kesalahannya, lalu Anda menulis ulang langkah 3 menjadi "Ketik ana@example.com ke kolom Email pada formulir reset". Tim Cypress merekomendasikan kebiasaan yang sama untuk alat bahasa Inggris biasa mereka: periksa setiap langkah yang dihasilkan, dan beralih ke kode tetap saat Anda memerlukan tes yang stabil.

Variasi: gunakan tabel data, bukan salinan

Banyak kasus uji memeriksa perilaku yang sama dengan nilai yang berbeda. Formulir pendaftaran seharusnya menolak alamat email tanpa tanda @, alamat tanpa domain, dan alamat yang mengandung spasi. Jangan menulis tiga kasus uji dengan langkah yang identik.

Panduan Automation Panda mencatat bahwa Gherkin tidak memiliki langkah "Or". Untuk variasi dari satu perilaku, panduan tersebut merekomendasikan Scenario Outline dengan tabel Examples, dan menyarankan agar hanya menyertakan variasi yang benar-benar dibutuhkan, karena baris tambahan memperpanjang waktu eksekusi. Anda dapat menerapkan ide yang sama dalam bahasa Inggris biasa. Tulis langkahnya sekali dengan placeholder, misalnya "Type {email} into the Email field", lalu tambahkan tabel kecil di bawahnya.

Contoh tabel, fiktif: {email} berisi "ana.example.com" dan pesan yang diharapkan adalah "Enter a valid email address"; {email} berisi "ana@" dan pesannya sama; {email} kosong dan pesannya adalah "Email is required". Tiga baris, satu set langkah, tiga hasil yang jelas. Jika satu baris gagal, laporan akan menunjukkan nilai mana yang melanggar aturan.

Daftar periksa tinjauan sebelum Anda menjalankan pengujian

Gunakan daftar ini untuk setiap kasus uji baru:

  • Judul menyatakan satu perilaku.
  • Kondisi awal berupa suatu keadaan, bukan daftar klik persiapan.
  • Setiap langkah diawali dengan kata kerja dan menyebut elemen sebagaimana tampil di layar.
  • Semua nilai dituliskan secara lengkap.
  • Hasil yang diharapkan dapat dilihat dan memiliki teks atau angka yang tepat.
  • Jumlah langkahnya kurang dari sepuluh.
  • Orang lain telah membaca pengujian tersebut.

Kesalahan umum

  • Menggabungkan beberapa perilaku dalam satu kasus uji. Saat gagal, Anda tidak tahu bagian mana yang rusak.
  • Menjelaskan cara, bukan tujuan. Sepuluh langkah ketikan menyembunyikan maksud. Nyatakan tindakan pada tingkat yang dilakukan pengguna.
  • Melewatkan hasil yang diharapkan. Kasus uji tanpa pemeriksaan dapat lolos tanpa membuktikan apa pun.
  • Menggunakan nama internal. ID uji dan kelas CSS dapat berubah. Gunakan label yang dilihat pengguna.
  • Membiarkan AI generatif menyusun pengujian dan menerimanya tanpa membaca. Model dapat mengarang langkah yang tidak dimiliki produk Anda.
  • Menyerahkan data pada kebetulan. Jika suatu nilai tidak ditentukan, agen akan memilih sendiri, dan pengujian mungkin tidak dapat diulang.

Bagaimana perangkat lunak dapat membantu

Spreadsheet bersama atau halaman wiki sudah cukup untuk memulai. Tulis setiap pengujian dalam bentuk lima bagian dan tinjau seperti kode. Jika Anda menggunakan alat manajemen pengujian, simpan satu pengujian per rekaman dan kaitkan dengan persyaratan. Alat pengujian bahasa alami kemudian dapat membaca teks yang sama. Banyak tim juga menyimpan panduan gaya singkat berisi aturan di atas, sehingga setiap penguji baru menulis langkah dengan cara yang sama.

Langkah berikutnya

Ambil tiga kriteria penerimaan dari sprint Anda saat ini dan tulis satu kasus uji untuk masing-masing, menggunakan lima bagian tersebut. Jalankan di alat pilihan Anda untuk menulis kasus uji dalam bahasa Inggris biasa yang dapat dijalankan agen, lalu perbaiki setiap langkah yang ditunjukkan log sebagai salah dibaca.

Entities in this article

End-to-end testing AI agent Generative AI

Related articles

RSS