Men-debug bot SDK-first

BERLAKU UNTUK: SDK v4

Artikel ini menjelaskan cara men-debug bot Anda menggunakan IDE, seperti Visual Studio atau Visual Studio Code, dan Emulator Kerangka Kerja Bot. Gunakan metode ini untuk men-debug bot secara lokal. Artikel ini menggunakan bot echo, seperti yang dibuat di mulai cepat Buat bot .

Catatan

Dalam artikel ini, kami menggunakan Emulator Kerangka Kerja Bot untuk mengirim dan menerima pesan dari bot selama penelusuran kesalahan. Jika Anda mencari cara lain untuk men-debug bot Anda menggunakan Bot Framework Emulator, silakan baca artikel Debug dengan Bot Framework Emulator .

Catatan

Bot Framework JavaScript, C#, dan Python SDK akan terus didukung, namun, Java SDK dihentikan dengan dukungan jangka panjang akhir yang berakhir pada November 2023.

Bot yang ada yang dibangun dengan Java SDK akan terus berfungsi.

Untuk pembuatan bot baru, pertimbangkan untuk menggunakan Microsoft Copilot Studio dan baca tentang memilih solusi salinan yang tepat.

Untuk informasi selengkapnya, lihat Masa depan pembuatan bot.

Prasyarat

• Unduh dan instal Emulator Kerangka Kerja Bot.
• Unduh dan instal Visual Studio Code atau Visual Studio.

C#

Mengatur titik henti C# di Visual Studio Code

Di Visual Studio Code, Anda dapat mengatur titik pemisah dan menjalankan bot di mode debug untuk melalui kode Anda. Untuk mengatur titik henti di Visual Studio Code, lakukan hal berikut:

1. Luncurkan Visual Studio Code dan buka folder proyek bot Anda.

2. Atur titik henti seperlunya. Untuk mengatur titik henti, arahkan mouse Anda ke kolom di sebelah kiri nomor baris. Titik merah kecil akan muncul. Jika Anda mengklik titik tersebut, titik henti akan diatur. Jika Anda mengklik titik tersebut lagi, titik henti akan dihapus.

   

3. Dari bilah menu, pilih Jalankan, lalu Mulai Penelusuran Kesalahan. Bot Anda akan mulai berjalan dalam mode penelusuran kesalahan dari Terminal di Visual Studio Code.

4. Mulai Emulator Kerangka Kerja Bot dan sambungkan ke bot Anda seperti yang dijelaskan dalam cara Men-debug dengan Emulator Kerangka Kerja Bot.

5. Dari Emulator, kirim pesan bot Anda (misalnya, kirim pesan "Hai"). Eksekusi akan berhenti di baris tempat Anda menempatkan titik pemisah.

   

Mengatur titik henti C# di Visual Studio

Di Visual Studio, Anda dapat mengatur titik henti dan menjalankan bot dalam mode debug untuk menelusuri kode Anda. Untuk mengatur titik henti di Visual Studio, lakukan hal berikut:

1. Buka folder bot Anda, lalu buka file .sln. Ini akan membuka solusi di Visual Studio.

2. Dari bilah menu, pilih Bangun dan pilih Bangun Solusi.

3. Di Penjelajah Solusi, pilih file .cs dan atur titik henti seperlunya. Ini akan menetapkan logika bot utama. Untuk mengatur titik henti, arahkan mouse Anda ke kolom di sebelah kiri nomor baris. Titik kecil akan muncul. Jika Anda mengklik titik tersebut, titik henti akan diatur. Jika Anda mengklik titik tersebut lagi, titik henti akan dihapus.

   

4. Dari menu, pilih Debug, lalu Mulai Penelusuran Kesalahan. Pada titik ini, bot berjalan secara lokal.

5. Mulai Emulator Kerangka Bot dan sambungkan ke bot Anda seperti yang dijelaskan pada bagian di atas.

6. Dari Emulator, kirim pesan bot Anda, seperti "Hai". Eksekusi akan berhenti di baris tempat Anda menempatkan titik pemisah.

   

JavaScript

Mengatur titik henti JavaScript di Visual Studio Code

Di Visual Studio Code, Anda dapat mengatur titik pemisah dan menjalankan bot di mode debug untuk melalui kode Anda. Untuk mengatur titik henti di Visual Studio Code, lakukan hal berikut:

1. Luncurkan Visual Studio Code dan buka folder proyek bot Anda.

2. Dari bilah menu, pilih Debug lalu pilih Mulai Penelusuran Kesalahan. Jika Anda diminta untuk memilih mesin runtime untuk menjalankan kode Anda, pilih Node.js. Pada titik ini, bot berjalan secara lokal.

3. Pilih file .js dan atur titik henti seperlunya. Untuk mengatur titik henti, arahkan mouse Anda ke kolom di sebelah kiri nomor baris. Titik merah kecil akan muncul. Jika Anda mengklik titik tersebut, titik henti akan diatur. Jika Anda mengklik titik tersebut lagi, titik henti akan dihapus.

   

4. Mulai Emulator Kerangka Kerja Bot dan sambungkan ke bot Anda seperti yang dijelaskan di artikel Debug dengan Emulator Kerangka Kerja Bot.

5. Dari Emulator, kirim pesan bot Anda (misalnya, kirim pesan "Hai"). Eksekusi akan berhenti di baris tempat Anda menempatkan titik pemisah.

   

Java

Mengatur titik henti Java di Visual Studio Code

Di Visual Studio Code, Anda dapat mengatur titik pemisah dan menjalankan bot di mode debug untuk melalui kode Anda. Lihat juga Membuat bot dengan Bot Framework SDK untuk Java.

1. Instal Paket Ekstensi Java di Visual Studio Code, jika Anda belum melakukannya. Ekstensi ini menyediakan dukungan yang kaya untuk Java di Visual Studio Code, termasuk penelusuran kesalahan.

2. Luncurkan Visual Studio Code dan buka folder proyek bot Anda.

3. Atur titik henti seperlunya. Untuk mengatur titik henti, arahkan mouse Anda ke kolom di sebelah kiri nomor baris. Titik merah kecil akan muncul. Jika Anda mengklik titik tersebut, titik henti akan diatur. Jika Anda mengklik titik tersebut lagi, titik henti akan dihapus.

   

4. EchoBot.java Pilih file dan tambahkan titik henti ke lokasi yang diinginkan.

5. Dari bilah menu, pilih Jalankan lalu pilih Mulai Penelusuran Kesalahan.

6. Pilih Java jika diminta untuk men-debug file yang saat ini dipilih.

7. Mulai Emulator Kerangka Kerja Bot dan sambungkan ke bot Anda seperti yang dijelaskan di artikel Debug dengan Emulator Kerangka Kerja Bot.

8. Dari Emulator, kirim pesan bot Anda (misalnya, kirim pesan "Hai"). Eksekusi akan berhenti di baris tempat Anda menempatkan titik pemisah.

   

Untuk informasi selengkapnya, lihat Menjalankan dan melakukan penelusuran kesalahan Java.

Python

Mengatur titik henti Python di Visual Studio Code

Di Visual Studio Code, Anda dapat mengatur titik pemisah dan menjalankan bot di mode debug untuk melalui kode Anda. Lihat juga Membuat bot dengan Bot Framework SDK untuk Python.

1. Instal ekstensi Python di Visual Studio Code, jika Anda belum melakukannya. Ekstensi ini menyediakan dukungan kaya untuk Python di Visual Studio Code, termasuk penelusuran kesalahan.

2. Luncurkan Visual Studio Code dan buka folder proyek bot Anda.

3. Atur titik henti seperlunya. Untuk mengatur titik henti, arahkan mouse Anda ke kolom di sebelah kiri nomor baris. Titik merah kecil akan muncul. Jika Anda mengklik titik tersebut, titik henti akan diatur. Jika Anda mengklik titik tersebut lagi, titik henti akan dihapus.

   

4. app.py Pilih file.

5. Dari bilah menu, pilih Debug lalu pilih Mulai Penelusuran Kesalahan.

6. Pilih File Python untuk men-debug file yang saat ini dipilih.

7. Mulai Emulator Kerangka Kerja Bot dan sambungkan ke bot Anda seperti yang dijelaskan di artikel Debug dengan Emulator Kerangka Kerja Bot.

8. Dari Emulator, kirim pesan bot Anda (misalnya, kirim pesan "Hai"). Eksekusi akan berhenti di baris tempat Anda menempatkan titik pemisah.

   

Untuk informasi selengkapnya, lihat Men-debug kode Python Anda.

Sumber Daya Tambahan:

• Memecahkan masalah konfigurasi bot dan artikel pemecahan masalah lainnya di bagian tersebut.
• Debug dengan Emulator.

Langkah berikutnya

Debug bot Anda menggunakan file transkrip.