Gunakan petunjuk tindak lanjut untuk membuat beberapa giliran percakapan
Gunakan konteks dan petunjuk tindak lanjut untuk mengelola beberapa giliran, yang dikenal sebagai multi-giliran, untuk bot Anda dari satu pertanyaan ke pertanyaan lainnya.
Untuk melihat cara kerja multi-giliran, lihat video demonstrasi berikut:
Catatan
Layanan QnA Maker akan dihentikan pada 31 Maret 2025. Versi kemampuan pertanyaan dan jawaban yang lebih baru sekarang tersedia sebagai bagian dari Bahasa Azure AI. Untuk kemampuan menjawab pertanyaan dalam Language Service, lihat jawaban pertanyaan. Mulai 1 Oktober 2022, Anda tidak dapat membuat sumber daya QnA Maker baru. Untuk informasi tentang memigrasikan pangkalan pengetahuan QnA Maker yang ada pada jawaban atas pertanyaan, lihat panduan migrasi.
Apa itu percakapan multi-giliran?
Beberapa pertanyaan tidak dapat dijawab dalam satu giliran. Saat Anda merancang percakapan (bot obrolan) aplikasi klien, pengguna mungkin mengajukan pertanyaan yang perlu difilter atau disempurnakan untuk menentukan jawaban yang benar. Anda membuat alur ini melalui pertanyaan yang mungkin dengan menyajikan pengguna dengan perintah tindak lanjut.
Saat pengguna mengajukan pertanyaan, QnA Maker menampilkan jawaban dan perintah tindak lanjut apa pun. Respons ini memungkinkan Anda menyajikan pertanyaan tindak lanjut sebagai pilihan.
Perhatian
Perintah multi-giliran tidak diekstrak dari dokumen FAQ. Jika Anda memerlukan ekstraksi multi-giliran, hapus tanda tanya yang menunjuk pasangan tanya jawab sebagai FAQ.
Contoh percakapan multi-giliran dengan bot obrolan
Dengan multi-giliran, bot obrolan mengelola percakapan dengan pengguna untuk menentukan jawaban akhir, seperti yang ditunjukkan dalam gambar berikut:
Pada gambar sebelumnya, pengguna telah memulai percakapan dengan memasukkan Akun saya. Pangkalan pengetahuan memiliki tiga pasangan tanya jawab yang terkait. Untuk memperbaiki jawabannya, pengguna memilih salah satu dari tiga pilihan di pangkalan pengetahuan. Pertanyaan (#1), memiliki tiga petunjuk tindak lanjut, yang disajikan di bot obrolan sebagai tiga opsi (#2).
Saat pengguna memilih opsi (#3), daftar opsi perbaikan (#4) berikutnya disajikan. Urutan ini berlanjut (#5) sampai pengguna menentukan jawaban akhir (#6) yang benar.
Menggunakan multi-giliran dalam bot
Setelah menerbitkan KB, Anda dapat memilih tombol Buat Bot untuk menyebarkan bot QnA Maker Anda ke Azure AI Bot Service. Perintah akan muncul di klien obrolan yang telah Anda aktifkan untuk bot Anda.
Membuat percakapan multi-giliran dari struktur dokumen
Saat Anda membuat basis pengetahuan, bagian Isi KB Anda menampilkan kotak centang Aktifkan ekstraksi multi-giliran dari URL, file .pdf atau .docx.
Saat Anda memilih opsi ini, QnA Maker mengekstrak hierarki yang ada dalam struktur dokumen. Hierarki dikonversi untuk menindaklanjuti perintah dan akar hierarki berfungsi sebagai QnA induk. Dalam beberapa dokumen, akar dari hierarki tidak memiliki isi, yang dapat bertindak sebagai jawaban. Anda dapat memberikan 'Teks Jawaban Default' untuk digunakan sebagai penggantian teks jawaban untuk mengekstrak hierarki seperti itu.
Struktur multi-giliran hanya dapat disimpulkan dari URL, file PDF, atau file DOCX. Untuk contoh struktur, lihat gambar file PDF panduan pengguna Microsoft Surface.
Membuat dokumen multi-giliran Anda sendiri
Jika Anda membuat dokumen multi-giliran, harap ingat panduan berikut:
Gunakan judul dan sub judul untuk menunjukkan hierarki. Misalnya, gunakan h1 untuk menunjukkan QnA induk dan h2 untuk menunjukkan QnA yang harus dianggap sebagai permintaan. Gunakan ukuran judul kecil untuk menunjukkan hierarki berikutnya. Jangan gunakan gaya, warna, atau mekanisme lain untuk menyiratkan struktur dalam dokumen Anda, QnA Maker tidak akan mengekstrak perintah multi-giliran.
Karakter pertama dari judul harus dikapitalisasi.
Jangan mengakhiri judul dengan tanda tanya,
?.Anda dapat menggunakan sampel dokumen sebagai contoh untuk membuat dokumen multi-giliran Anda sendiri.
Menambahkan file ke KB multi-giliran
Saat Anda menambahkan dokumen hierarkis, QnA Maker menentukan petunjuk tindak lanjut dari struktur untuk membuat alur percakapan.
- Di QnA Maker, pilih pangkalan pengetahuan yang ada yang dibuat dengan Aktifkan ekstraksi multi-giliran dari URL, file .pdf, atau file .docx yang diaktifkan.
- Buka halaman Pengaturan, pilih file atau URL untuk ditambahkan.
- Simpan dan latih pangkalan pengetahuan.
Perhatian
Dukungan untuk menggunakan file pangkalan pengetahuan multi-giliran TSV atau XLS yang diekspor sebagai sumber data untuk pangkalan pengetahuan baru atau kosong tidak didukung. Anda perlu Mengimpor jenis file tersebut, dari halaman Pengaturan portal QnA Maker, untuk menambahkan perintah multi-giliran yang diekspor ke pangkalan pengetahuan.
Buat pangkalan pengetahuan dengan perintah multi-giliran dengan Create API
Anda dapat membuat kasus pengetahuan dengan perintah multi-giliran menggunakan QnA Maker Create API. Perintah ditambahkan dalam array prompts properti context.
Menampilkan pertanyaan dan jawaban dengan konteks
Kurangi pasangan tanya jawab yang ditampilkan hanya untuk yang memiliki percakapan kontekstual.
Pilih Tampilkan opsi, lalu pilih Tampilkan konteks. Daftar ini menampilkan pasangan tanya jawab yang berisi petunjuk tindak lanjut.
Konteks multigiliran turn ditampilkan di kolom pertama.
Pada gambar sebelumnya, #1 menunjukkan teks tebal di kolom, yang menandakan pertanyaan saat ini. Pertanyaan induk adalah item teratas dalam baris. Setiap pertanyaan di bawahnya adalah pasangan tanya jawab yang ditautkan. Item ini dapat dipilih, sehingga Anda dapat segera membuka item konteks lainnya.
Menambahkan pasangan tanya jawab yang sudah ada sebagai petunjuk tindak lanjut
Pertanyaan asli, Akun saya, memiliki petunjuk tindak lanjut, seperti Akun dan masuk.
Tambahkan petunjuk tindak lanjut ke pasangan tanya jawab yang ada yang saat ini tidak ditautkan. Karena pertanyaan tidak terkait dengan pasangan tanya jawab apa pun, pengaturan tampilan saat ini perlu diubah.
Untuk menautkan pasangan tanya jawab yang ada sebagai petunjuk tindak lanjut, pilih baris untuk pasangan tanya jawab. Untuk panduan Surface, cari Keluar untuk mengurangi daftar.
Di baris untuk Keluar, di kolom Jawaban, pilih Tambahkan petunjuk tindak lanjut.
Di bidang di jendela pop-up petunjuk tindak lanjut, masukkan nilai berikut:
Bidang Nilai Menampilkan teks Masukkan Nonaktifkan perangkat. Ini adalah teks kustom untuk ditampilkan dalam petunjuk tindak lanjut. Konteks-saja Pilih kotak centang ini. Jawaban ditampilkan hanya jika pertanyaan menentukan konteks. Tautan ke jawaban Masukkan Gunakan layar masuk untuk menemukan pasangan tanya jawab yang ada. Satu kecocokan ditampilkan. Pilih jawaban ini sebagai tindak lanjut, lalu pilih Simpan.
Setelah Anda menambahkan petunjuk tindak lanjut, pilih Simpan dan latih di navigasi atas.
Mengedit teks tampilan
Saat petunjuk tindak lanjut dibuat, dan pasangan tanya jawab yang ada dimasukkan sebagai Tautan ke Jawaban, Anda dapat memasukkan teks Tampilkan teks. Teks ini tidak menggantikan pertanyaan yang ada, dan tidak menambahkan pertanyaan alternatif baru. Ini terpisah dari nilai-nilai tersebut.
Untuk mengedit teks tampilan, cari dan pilih pertanyaan di bidang Konteks.
Di baris untuk pertanyaan tersebut, pilih petunjuk tindak lanjut di kolom jawaban.
Pilih teks tampilan yang ingin Anda edit, lalu pilih Edit.
Di jendela pop-up Petunjuk tindak lanjut, ubah teks tampilan yang sudah ada.
Setelah Anda selesai mengedit teks tampilan, pilih Simpan.
Di bilah navigasi atas, Simpan dan latih.
Menambahkan pasangan tanya jawab baru sebagai petunjuk tindak lanjut
Saat Anda menambahkan pasangan tanya jawab baru ke pangkalan pengetahuan, setiap pasangan harus dikaitkan dengan pertanyaan yang ada sebagai petunjuk tindak lanjut.
Di toolbar pangkalan pengetahuan, cari dan pilih pasangan tanya jawab yang ada untuk Akun dan masuk.
Di kolom Jawaban untuk pertanyaan ini, pilih Tambahkan petunjuk tindak lanjut.
Di bagian Petunjuk tindak lanjut (PRATINJAU) , buat petunjuk tindak lanjut baru dengan memasukkan nilai berikut:
Bidang Nilai Menampilkan teks Membuat Akun Windows. Teks kustom untuk ditampilkan dalam petunjuk tindak lanjut. Konteks-saja Pilih kotak centang ini. Jawaban ini ditampilkan hanya jika pertanyaan menentukan konteks. Tautan ke jawaban Masukkan teks berikut sebagai jawabannya:
Buat akun Windows dengan akun email baru atau yang sudah ada.
Saat Anda menyimpan dan melatih database, teks ini akan dikonversi.
Pilih Buat baru, lalu pilih Simpan.
Tindakan ini membuat pasangan tanya jawab baru dan menautkan pertanyaan yang dipilih sebagai petunjuk tindak lanjut. Kolom Konteks, untuk kedua pertanyaan, menunjukkan hubungan petunjuk tindak lanjut.
Pilih opsi Tampilan, lalu pilih Tampilkan konteks (PRATINJAU).
Pertanyaan baru menunjukkan caranya terkait.
Pertanyaan induk menampilkan pertanyaan baru sebagai salah satu pilihannya.
Setelah Anda menambahkan petunjuk tindak lanjut, pilih Simpan dan latih di bilah navigasi atas.
Melihat multi-giliran selama pengujian petunjuk tindak lanjut
Saat Anda menguji pertanyaan dengan petunjuk tindak lanjut di panel Pengujian, respons menyertakan petunjuk tindak lanjut.
Permintaan JSON untuk menampilkan jawaban awal dan petunjuk tindak lanjut
Gunakan objek context kosong untuk meminta jawaban atas pertanyaan pengguna dan menyertakan petunjuk tindak lanjut.
{
"question": "accounts and signing in",
"top": 10,
"userId": "Default",
"isTest": false,
"context": {}
}
Respons JSON untuk menampilkan jawaban awal dan petunjuk tindak lanjut
Bagian sebelumnya meminta jawaban dan petunjuk tindak lanjut apa pun ke Akun dan masuk. Respons mencakup informasi perintah, yang terletak di answers[0].context, dan teks yang akan ditampilkan kepada pengguna.
{
"answers": [
{
"questions": [
"Accounts and signing in"
],
"answer": "**Accounts and signing in**\n\nWhen you set up your Surface, an account is set up for you. You can create additional accounts later for family and friends, so each person using your Surface can set it up just the way he or she likes. For more info, see All about accounts on Surface.com. \n\nThere are several ways to sign in to your Surface Pro 4: ",
"score": 100.0,
"id": 15,
"source": "product-manual.pdf",
"metadata": [],
"context": {
"isContextOnly": true,
"prompts": [
{
"displayOrder": 0,
"qnaId": 16,
"qna": null,
"displayText": "Use the sign-in screen"
}
]
}
},
{
"questions": [
"Sign out"
],
"answer": "**Sign out**\n\nHere's how to sign out: \n\n Go to Start, and right-click your name. Then select Sign out. ",
"score": 38.01,
"id": 18,
"source": "product-manual.pdf",
"metadata": [],
"context": {
"isContextOnly": true,
"prompts": [
{
"displayOrder": 0,
"qnaId": 16,
"qna": null,
"displayText": "Turn off the device"
}
]
}
},
{
"questions": [
"Use the sign-in screen"
],
"answer": "**Use the sign-in screen**\n\n1. \n\nTurn on or wake your Surface by pressing the power button. \n\n2. \n\nSwipe up on the screen or tap a key on the keyboard. \n\n3. \n\nIf you see your account name and account picture, enter your password and select the right arrow or press Enter on your keyboard. \n\n4. \n\nIf you see a different account name, select your own account from the list at the left. Then enter your password and select the right arrow or press Enter on your keyboard. ",
"score": 27.53,
"id": 16,
"source": "product-manual.pdf",
"metadata": [],
"context": {
"isContextOnly": true,
"prompts": []
}
}
]
}
Array prompts menyediakan teks dalam properti displayText dan nilai qnaId. Anda dapat menunjukkan jawaban ini sebagai pilihan berikutnya yang ditampilkan dalam alur percakapan lalu mengirim kembali qnaId yang dipilih ke QnA Maker dalam permintaan berikut.
Permintaan JSON untuk menampilkan selain jawaban awal dan petunjuk tindak lanjut
Isi objek context untuk menyertakan konteks sebelumnya.
Dalam permintaan JSON berikut, pertanyaan saat ini adalah Menggunakan Windows Hello untuk masuk dan pertanyaan sebelumnya adalah akun dan masuk.
{
"question": "Use Windows Hello to sign in",
"top": 10,
"userId": "Default",
"isTest": false,
"qnaId": 17,
"context": {
"previousQnAId": 15,
"previousUserQuery": "accounts and signing in"
}
}
Respons JSON untuk menampilkan selain jawaban awal dan petunjuk tindak lanjut
Respons JSON GenerateAnswer QnA Maker mencakup petunjuk tindak lanjut di properti context item pertama dalam objek answers:
{
"answers": [
{
"questions": [
"Use Windows Hello to sign in"
],
"answer": "**Use Windows Hello to sign in**\n\nSince Surface Pro 4 has an infrared (IR) camera, you can set up Windows Hello to sign in just by looking at the screen. \n\nIf you have the Surface Pro 4 Type Cover with Fingerprint ID (sold separately), you can set up your Surface sign you in with a touch. \n\nFor more info, see What is Windows Hello? on Windows.com. ",
"score": 100.0,
"id": 17,
"source": "product-manual.pdf",
"metadata": [],
"context": {
"isContextOnly": true,
"prompts": []
}
},
{
"questions": [
"Meet Surface Pro 4"
],
"answer": "**Meet Surface Pro 4**\n\nGet acquainted with the features built in to your Surface Pro 4. \n\nHere's a quick overview of Surface Pro 4 features: \n\n\n\n\n\n\n\nPower button \n\n\n\n\n\nPress the power button to turn your Surface Pro 4 on. You can also use the power button to put it to sleep and wake it when you're ready to start working again. \n\n\n\n\n\n\n\nTouchscreen \n\n\n\n\n\nUse the 12.3" display, with its 3:2 aspect ratio and 2736 x 1824 resolution, to watch HD movies, browse the web, and use your favorite apps. \n\nThe new Surface G5 touch processor provides up to twice the touch accuracy of Surface Pro 3 and lets you use your fingers to select items, zoom in, and move things around. For more info, see Surface touchscreen on Surface.com. \n\n\n\n\n\n\n\nSurface Pen \n\n\n\n\n\nEnjoy a natural writing experience with a pen that feels like an actual pen. Use Surface Pen to launch Cortana in Windows or open OneNote and quickly jot down notes or take screenshots. \n\nSee Using Surface Pen (Surface Pro 4 version) on Surface.com for more info. \n\n\n\n\n\n\n\nKickstand \n\n\n\n\n\nFlip out the kickstand and work or play comfortably at your desk, on the couch, or while giving a hands-free presentation. \n\n\n\n\n\n\n\nWi-Fi and Bluetooth® \n\n\n\n\n\nSurface Pro 4 supports standard Wi-Fi protocols (802.11a/b/g/n/ac) and Bluetooth 4.0. Connect to a wireless network and use Bluetooth devices like mice, printers, and headsets. \n\nFor more info, see Add a Bluetooth device and Connect Surface to a wireless network on Surface.com. \n\n\n\n\n\n\n\nCameras \n\n\n\n\n\nSurface Pro 4 has two cameras for taking photos and recording video: an 8-megapixel rear-facing camera with autofocus and a 5-megapixel, high-resolution, front-facing camera. Both cameras record video in 1080p, with a 16:9 aspect ratio. Privacy lights are located on the right side of both cameras. \n\nSurface Pro 4 also has an infrared (IR) face-detection camera so you can sign in to Windows without typing a password. For more info, see Windows Hello on Surface.com. \n\nFor more camera info, see Take photos and videos with Surface and Using autofocus on Surface 3, Surface Pro 4, and Surface Book on Surface.com. \n\n\n\n\n\n\n\nMicrophones \n\n\n\n\n\nSurface Pro 4 has both a front and a back microphone. Use the front microphone for calls and recordings. Its noise-canceling feature is optimized for use with Skype and Cortana. \n\n\n\n\n\n\n\nStereo speakers \n\n\n\n\n\nStereo front speakers provide an immersive music and movie playback experience. To learn more, see Surface sound, volume, and audio accessories on Surface.com. \n\n\n\n\n",
"score": 21.92,
"id": 3,
"source": "product-manual.pdf",
"metadata": [],
"context": {
"isContextOnly": true,
"prompts": [
{
"displayOrder": 0,
"qnaId": 4,
"qna": null,
"displayText": "Ports and connectors"
}
]
}
},
{
"questions": [
"Use the sign-in screen"
],
"answer": "**Use the sign-in screen**\n\n1. \n\nTurn on or wake your Surface by pressing the power button. \n\n2. \n\nSwipe up on the screen or tap a key on the keyboard. \n\n3. \n\nIf you see your account name and account picture, enter your password and select the right arrow or press Enter on your keyboard. \n\n4. \n\nIf you see a different account name, select your own account from the list at the left. Then enter your password and select the right arrow or press Enter on your keyboard. ",
"score": 19.04,
"id": 16,
"source": "product-manual.pdf",
"metadata": [],
"context": {
"isContextOnly": true,
"prompts": []
}
}
]
}
Mengkueri pangkalan pengetahuan dengan ID QnA Maker
Jika Anda sedang membangun aplikasi khusus, dalam tanggapan pertanyaan awal, setiap petunjuk tindak lanjut, dan yang terkait qnaId dikembalikan. Setelah memiliki ID, Anda dapat meneruskannya dalam isi permintaan petunjuk tindak lanjut. Jika isi permintaan berisi qnaId, dan objek konteks (yang berisi properti QnA Maker sebelumnya), GenerateAnswer akan menampilkan pertanyaan yang tepat dengan ID, alih-alih menggunakan algoritme peringkat untuk menemukan jawaban dengan teks pertanyaan.
Urutan tampilan didukung di Update API
Teks tampilan dan urutan tampilan, yang ditampilkan dalam respons JSON, didukung untuk pengeditan oleh Update API.
Menambahkan atau menghapus perintah multi-giliran dengan Update API
Anda dapat menambahkan atau menghapus perintah multi-giliran menggunakan QnA Maker Update API. Perintah ditambahkan dalam array promptsToAdd dan array promptsToDelete dari properti context.
Mengekspor pangkalan pengetahuan untuk kontrol versi
QnA Maker mendukung kontrol versi dengan menyertakan langkah-langkah percakapan multi-giliran pada file yang diekspor.
Langkah berikutnya
- Pelajari lebih lanjut tentang percakapan kontekstual dari sampel dialog ini atau pelajari lebih lanjut tentang desain bot konseptual untuk percakapan multi-giliran.