Bagikan melalui

Men-debug bot Anda menggunakan file transkrip

  • Artikel

BERLAKU UNTUK: SDK v4

Salah satu kunci keberhasilan pengujian dan penelusuran kesalahan bot adalah kemampuan Anda untuk merekam dan memeriksa serangkaian kondisi yang terjadi saat menjalankan bot Anda. Artikel ini membahas pembuatan dan penggunaan file transkrip bot untuk menyediakan serangkaian interaksi pengguna dan respons bot terperinci untuk pengujian dan penelusuran kesalahan.

File transkrip bot

File transkrip bot adalah file JSON khusus yang mempertahankan interaksi antara pengguna dan bot Anda. File transkrip tidak hanya mempertahankan konten pesan, tetapi juga detail interaksi seperti ID pengguna, ID saluran, jenis saluran, kemampuan saluran, waktu interaksi, dan sebagainya. Semua informasi ini kemudian dapat digunakan untuk membantu menemukan dan mengatasi masalah saat menguji atau men-debug bot Anda.

Membuat/Menyimpan file transkrip bot

Artikel ini menunjukkan cara membuat file transkrip bot menggunakan Bot Framework Emulator. File transkrip juga dapat dibuat secara terprogram; lihat Penyimpanan transkrip blob untuk membaca lebih lanjut mengenai pendekatan tersebut. Dalam artikel ini, kita akan menggunakan kode sampel Bot Framework untuk Bot Prompt Multi Turn yang meminta mode transportasi, nama, dan usia pengguna, tetapi kode apa pun yang dapat diakses menggunakan Bot Framework Emulator Microsoft dapat digunakan untuk membuat file transkrip.

Untuk memulai proses ini, pastikan bahwa kode bot yang ingin Anda uji berjalan dalam lingkungan pengembangan Anda.

  1. Mulai Emulator.

  2. Pada tab Selamat Datang, pilih Buka Bot.

  3. Masukkan alamat port tempat bot Anda mendengarkan, diikuti oleh /api/messages, misalnya, http://localhost:3978/api/messages.

    Jika bot Anda dikonfigurasi dengan ID aplikasi dan kata sandi Microsoft, masukkan ID dan kata sandi dalam dialog Buka bot . Jika tidak, Emulator tidak akan dapat terhubung ke bot Anda.

  4. Pilih Sambungkan untuk menyambungkan Emulator ke bot Anda.

    Cuplikan layar dialog untuk menyambungkan ke bot dari Emulator.

Uji kode Anda dengan berinteraksi dengan bot Anda di Emulator. Setelah memasukkan semua interaksi pengguna yang ingin Anda pertahankan, gunakan Emulator Kerangka Kerja Bot untuk membuat dan menyimpan file transkrip yang berisi percakapan ini.

  1. Di tab Live Chat , pilih Simpan transkrip.

    Cuplikan layar percakapan dan tombol 'simpan transkrip' di Emulator.

  2. Pilih lokasi dan nama untuk file transkrip Anda dan pilih Simpan.

    Cuplikan layar dialog 'simpan transkrip percakapan'.

Semua interaksi pengguna dan respons bot yang Anda masukkan untuk menguji kode dengan Emulator sekarang telah disimpan ke dalam file transkrip yang nantinya dapat Anda muat ulang untuk membantu men-debug interaksi antara pengguna dan bot Anda.

Mengambil file transkrip bot

Saat Anda membuka file transkrip, Emulator memuat percakapan yang disimpan ke tab baru.

Untuk mengambil file transkrip bot:

  1. Buka Emulator.
  2. Dari menu, pilih File lalu Buka Transkrip.
  3. Gunakan file Buka transkrip untuk memilih dan membuka file transkrip yang ingin Anda ambil.

Cuplikan layar dialog 'buka file transkrip'.

Debug menggunakan file transkrip

Dengan file transkrip dimuat, Anda sekarang siap untuk men-debug interaksi yang Anda ambil antara pengguna dan bot Anda.

  1. Pilih pesan pengguna atau bot apa pun, atau aktivitas yang direkam di panel log Emulator.

  2. Emulator akan menampilkan informasi aktivitas di panel inspektur . Informasi aktivitas adalah payload permintaan HTTP untuk aktivitas tersebut.

    Aktivitas pesan meliputi:

    • Jenis aktivitas
    • Waktu aktivitas dikirim dari atau diterima oleh saluran
    • Informasi tentang saluran pengguna
    • Informasi tentang pengirim dan penerima aktivitas, di from bidang dan recipient , masing-masing
    • Informasi khusus untuk jenis aktivitas, seperti teks pesan untuk aktivitas pesan.

Tingkat informasi terperinci ini memungkinkan Anda untuk mengikuti interaksi langkah demi langkah antara input pengguna dan respons bot Anda, yang berguna untuk men-debug situasi di mana bot Anda tidak merespons dengan cara yang Anda antisipasi atau tidak merespons pengguna sama sekali. Memiliki nilai-nilai ini dan catatan langkah-langkah menjelang interaksi yang gagal memungkinkan Anda untuk menelusuri kode Anda, menemukan lokasi di mana bot Anda tidak merespons seperti yang diantisipasi, dan menyelesaikan masalah tersebut.

Menggunakan file transkrip bersama dengan Bot Framework Emulator hanyalah salah satu dari banyak alat yang dapat Anda gunakan untuk membantu Anda menguji dan men-debug kode bot dan interaksi pengguna Anda.

Informasi Tambahan

Untuk informasi pengujian dan penelusuran kesalahan selengkapnya, lihat: