Menggunakan portal Azure untuk Membuat sumber daya Azure Bot
BERLAKU UNTUK: SDK v4
Sumber daya Azure Bot (sumber daya bot) memungkinkan Anda mendaftarkan bot Anda dengan Azure AI Bot Service dan menyambungkan bot Anda ke saluran. Anda dapat membangun, menyambungkan, dan mengelola bot untuk berinteraksi dengan pengguna Anda di mana pun mereka berada, dari aplikasi atau situs web Anda ke Teams, Messenger, dan banyak saluran lainnya.
Artikel ini menjelaskan cara membuat sumber daya bot melalui portal Azure.
- Untuk mempelajari cara membuat bot, lihat mulai cepat Membuat bot dengan Bot Framework SDK .
- Untuk informasi tentang cara memprovisikan dan menerbitkan bot ke Azure, lihat cara Menyebarkan bot Anda di Azure.
Pengelolaan sumber daya
Saat Anda membuat sumber daya bot, Azure membuat sumber daya terkait. Beberapa sumber daya yang dibuat bergantung pada cara Anda memutuskan untuk mengelola identitas bot Anda.
Identitas bot Anda dapat dikelola di Azure dengan beberapa cara berbeda.
- Sebagai identitas terkelola yang ditetapkan pengguna, sehingga Anda tidak perlu mengelola kredensial bot sendiri.
- Sebagai aplikasi penyewa tunggal.
- Sebagai aplikasi multi-penyewa.
Dukungan untuk identitas terkelola dan jenis aplikasi penyewa tunggal yang ditetapkan pengguna ditambahkan ke Bot Framework SDK untuk C#, JavaScript, dan Python. Jenis aplikasi ini tidak didukung dalam bahasa lain atau di Bot Framework Composer, Bot Framework Emulator, atau Dev Tunnels.
| Jenis aplikasi | Dukungan |
|---|---|
| Identitas terkelola yang ditetapkan pengguna | Azure AI Bot Service dan SDK C#, JavaScript, dan Python |
| Penyewa tunggal | Azure AI Bot Service dan SDK C#, JavaScript, dan Python |
| Multi-penyewa | Azure AI Bot Service, semua bahasa Bot Framework SDK, Composer, Emulator, dan Dev Tunnels |
Prasyarat
- Jika Anda tidak memiliki langganan Azure, buat akun gratis sebelum Anda memulai.
- Bot Framework SDK untuk C# atau JavaScript versi 4.15.0 atau yang lebih baru, untuk identitas terkelola yang ditetapkan pengguna dan bot penyewa tunggal.
Buat sumber daya
Buat sumber daya Azure Bot, yang akan memungkinkan Anda mendaftarkan bot Anda dengan Azure AI Bot Service.
Tip
Sumber daya Pendaftaran Bot Aplikasi Web dan Saluran Bot baru tidak dapat dibuat; namun, sumber daya apa pun yang ada yang dikonfigurasi dan disebarkan akan terus berfungsi. Bot yang dibuat dari templat VSIX atau Yeoman dari SDK versi 4.14.1.2 atau yang lebih baru berisi templat ARM yang akan menghasilkan sumber daya Azure Bot.
Buka portal Azure.
Di panel kanan, pilih Buat sumber daya.
Dalam kotak pencarian masukkan
bot, lalu tekan Enter.Pilih kartu Azure Bot .
Pilih Buat.
Masukkan nilai di bidang yang diperlukan dan tinjau serta perbarui pengaturan.
Berikan informasi di bawah Detail proyek. Pilih apakah bot Anda akan memiliki residensi data global atau lokal. Saat ini, fitur residensi data lokal tersedia untuk sumber daya di wilayah "westeurope" dan "centralindia". Untuk informasi selengkapnya, lihat Regionalisasi di Azure AI Bot Service.
Berikan informasi di bawah ID Aplikasi Microsoft. Pilih bagaimana identitas bot Anda akan dikelola di Azure dan apakah akan membuat identitas baru atau menggunakan identitas yang sudah ada.
Pilih Tinjau + buat.
Jika validasi lolos, pilih Buat.
Setelah penyebaran selesai, pilih Buka sumber daya. Anda akan melihat bot dan sumber daya terkait yang tercantum dalam grup sumber daya yang Anda pilih.
Jika Anda belum memiliki Bot Framework SDK, pilih Unduh dari GitHub untuk mempelajari cara menggunakan paket untuk bahasa pilihan Anda.
Anda sekarang siap untuk membangun bot Anda dengan Bot Framework SDK.
Tip
Saat Azure membuat sumber daya Azure Bot penyewa tunggal atau multi-penyewa baru dengan ID aplikasi baru, Azure Bot juga menghasilkan kata sandi.
Informasi identitas bot
Ikuti langkah-langkah ini untuk menambahkan informasi identitas ke file konfigurasi bot Anda. File berbeda tergantung pada bahasa pemrograman yang Anda gunakan untuk membuat bot.
Penting
Versi Java dari Bot Framework SDK hanya mendukung bot multi-penyewa. Versi C#, JavaScript, dan Python mendukung ketiga jenis aplikasi untuk mengelola identitas bot.
| Bahasa | Nama file | Catatan |
|---|---|---|
| C# | appsettings.json | Mendukung ketiga jenis aplikasi untuk mengelola identitas bot Anda. |
| JavaScript | .env | Mendukung ketiga jenis aplikasi untuk mengelola identitas bot Anda. |
| Java | application.properties | Hanya mendukung bot multi-penyewa. |
| Python | config.py | Mendukung ketiga jenis aplikasi untuk mengelola identitas bot Anda. |
Informasi identitas yang perlu Anda tambahkan tergantung pada jenis aplikasi bot. Berikan nilai berikut dalam file konfigurasi Anda.
Tersedia untuk bot C#, JavaScript, dan Python.
| Properti | Nilai |
|---|---|
MicrosoftAppType |
UserAssignedMSI |
MicrosoftAppId |
ID klien identitas terkelola yang ditetapkan pengguna. |
MicrosoftAppPassword |
Tidak berlaku. Biarkan ini kosong untuk bot identitas terkelola yang ditetapkan pengguna. |
MicrosoftAppTenantId |
ID penyewa identitas terkelola yang ditetapkan pengguna. |
Untuk memperbarui layanan aplikasi Anda
Jika Anda memiliki sumber daya App Service (aplikasi web) yang sudah ada untuk bot dan bot Anda adalah aplikasi identitas terkelola yang ditetapkan pengguna, Anda mungkin perlu memperbarui layanan aplikasi bot Anda:
- Buka bilah App Service untuk aplikasi web bot Anda.
- Di Pengaturan, pilih Identitas.
- Pada bilah Identitas , pilih tab Pengguna yang ditetapkan dan Tambahkan (+).
- Pada bilah Tambahkan identitas terkelola yang ditetapkan pengguna:
Pilih langganan Anda.
Untuk Identitas terkelola yang ditetapkan pengguna, pilih identitas terkelola untuk bot Anda. Jika identitas terkelola dibuat secara otomatis untuk Anda, identitas tersebut akan memiliki nama yang sama dengan bot Anda.
Pilih Tambahkan untuk menggunakan identitas ini untuk bot Anda.
Untuk mendapatkan ID aplikasi atau penyewa Anda
Untuk mendapatkan aplikasi bot atau ID penyewa Anda:
- Buka bilah sumber daya Azure Bot untuk bot Anda.
- Buka bilah Konfigurasi bot. Dari bilah ini, Anda dapat menyalin ID Aplikasi Microsoft atau ID Penyewa Aplikasi bot.
Untuk menghasilkan kata sandi baru
Bot penyewa tunggal dan multi-penyewa memiliki rahasia aplikasi atau kata sandi yang Anda butuhkan untuk beberapa operasi. Azure AI Bot Service menyembunyikan rahasia bot Anda. Namun, pemilik sumber daya App Service bot dapat menghasilkan kata sandi baru:
- Buka bilah sumber daya Azure Bot untuk bot Anda.
- Buka bilah Konfigurasi bot.
- Pilih Kelola, di samping ID Aplikasi Microsoft, untuk masuk ke bilah Sertifikat + rahasia untuk layanan aplikasi.
- Ikuti instruksi pada bilah untuk membuat rahasia klien baru dan mencatat nilai di tempat yang aman.
Informasi Tambahan
- Untuk informasi tentang manajemen identitas dengan ID Microsoft Entra, lihat Apa itu ID Microsoft Entra?.
- Untuk informasi tentang paket Azure App Service dan App Service, lihat gambaran umum App Service.
- Untuk informasi tentang sumber daya Azure dan bagaimana sumber daya dikelola secara umum, lihat gambaran umum Azure Resource Manager.
Catatan
Bot Framework Composer dan Bot Framework Emulator saat ini hanya mendukung bot multi-penyewa. Bot Framework SDK untuk C# atau JavaScript versi 4.15.0 atau yang lebih baru diperlukan untuk identitas terkelola yang ditetapkan pengguna dan bot penyewa tunggal.
Dukungan keterampilan
Beberapa jenis konsumen keterampilan tidak dapat menggunakan beberapa jenis bot keterampilan. Tabel berikut ini menjelaskan kombinasi mana yang didukung.
| Keterampilan multi-penyewa | Keterampilan penyewa tunggal | Keterampilan identitas terkelola yang ditetapkan pengguna | |
|---|---|---|---|
| Konsumen multi-penyewa | Didukung | Tidak didukung | Tidak didukung |
| Konsumen penyewa tunggal | Tidak didukung | Didukung jika kedua aplikasi milik penyewa yang sama | Didukung jika kedua aplikasi milik penyewa yang sama |
| Konsumen identitas terkelola yang ditetapkan pengguna | Tidak didukung | Didukung jika kedua aplikasi milik penyewa yang sama | Didukung jika kedua aplikasi milik penyewa yang sama |
Untuk informasi tentang cara mengonfigurasi keterampilan atau konsumen keterampilan, lihat Menerapkan keterampilan atau Menerapkan konsumen keterampilan.