Sumber daya Azure untuk QnA Maker

QnA Maker menggunakan beberapa sumber Azure, masing-masing dengan tujuan yang berbeda. Memahami bagaimana mereka digunakan secara individual memungkinkan Anda untuk merencanakan dan memilih tingkat harga yang benar atau mengetahui kapan harus mengubah tingkat harga Anda. Memahami bagaimana mereka digunakan dalam kombinasi memungkinkan Anda menemukan dan memperbaiki masalah saat terjadi.

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 ke jawaban atas pertanyaan, lihat panduan migrasi.

Perencanaan sumber daya

Saat pertama kali mengembangkan pangkalan pengetahuan QnA Maker, dalam fase purwarupa, biasanya memiliki satu sumber daya QnA Maker untuk pengujian dan produksi.

Ketika Anda pindah ke fase pengembangan proyek, Anda harus mempertimbangkan:

  • Berapa banyak bahasa yang akan dimiliki oleh sistem pangkalan pengetahuan Anda?
  • Berapa banyak wilayah yang Anda perlukan pangkalan pengetahuan Anda tersedia?
  • Berapa banyak dokumen di setiap domain yang akan disimpan sistem Anda?

Rencanakan untuk memiliki satu sumber daya QnA Maker yang menampung semua pangkalan pengetahuan yang memiliki bahasa yang sama, wilayah yang sama, dan kombinasi domain subjek yang sama.

Pertimbangan tingkat harga

Biasanya ada tiga parameter yang perlu Anda pertimbangkan:

  • Troughput yang Anda butuhkan dari layanan:

    • Pilih Paket Aplikasi yang sesuai untuk layanan Aplikasi Anda berdasarkan kebutuhan Anda. Anda dapat meningkatkan atau menurunkan skala Aplikasi.
    • Ini juga akan memengaruhi pilihan SKU Azure Cognitive Search Anda, lihat detail selengkapnya di sini. Selain itu, Anda mungkin perlu menyesuaikan kapasitas Cognitive Search dengan replika.
  • Ukuran dan jumlah pangkalan pengetahuan: Pilih SKU pencarian Azure yang sesuai untuk skenario Anda. Biasanya, Anda memutuskan jumlah pangkalan pengetahuan yang Anda butuhkan berdasarkan jumlah domain subjek yang berbeda. Setelah domain subjek (untuk satu bahasa) harus dalam satu pangkalan pengetahuan.

Sumber daya layanan Azure Search Anda harus dibuat setelah Januari 2019 dan tidak dapat berada di tingkat gratis (bersama). Tidak ada dukungan untuk mengonfigurasi kunci yang dikelola pelanggan di portal Azure.

Penting

Anda dapat menerbitkan pangkalan pengetahuan N-1 di tingkat tertentu, di mana N adalah indeks maksimum yang diizinkan di tingkat tersebut. Periksa juga ukuran maksimum dan jumlah dokumen yang diizinkan per tingkat.

Misalnya, jika tingkat Anda memiliki 15 indeks yang diizinkan, Anda dapat menerbitkan 14 pangkalan pengetahuan (satu indeks per pangkalan pengetahuan yang diterbitkan). Indeks kelima belas digunakan untuk semua dasar pengetahuan untuk penulisan dan pengujian.

  • Jumlah dokumen sebagai sumber: SKU gratis dari layanan manajemen QnA Maker membatasi jumlah dokumen yang dapat Anda kelola melalui portal dan API hingga 3 (masing-masing berukuran 1 MB). SKU standar tidak memiliki batasan jumlah dokumen yang dapat Anda kelola. Lihat detail selengkapnya di sini.

Tabel berikut ini memberi Anda beberapa panduan tingkat tinggi.

Manajemen QnA Maker App Service Pencarian Azure AI Batasan
Eksperimen SKU Gratis Tingkat Gratis Tingkat Gratis Terbitkan Hingga 2 KBs, ukuran 50 MB
Lingkungan Pengembangan/Pengujian Standard SKU Bersama Dasar Terbitkan Hingga 14 KB, ukuran 2 GB
Lingkungan produksi Standard SKU Dasar Standard Terbitkan Hingga 49 KB, ukuran 25 GB
QPS Target App Service Pencarian Azure AI
3 S1, satu Replika S1, satu Replika
50 S3, 10 Replika S1, 12 Replika
80 S3, 10 Replika S3, 12 Replika
100 P3V2, 10 Replika S3, 12 Replika, 3 Partisi
200 hingga 250 P3V2, 20 Replika S3, 12 Replika, 3 Partisi

Kapan harus mengubah tingkat harga

Peningkatan Alasan
Peningkatan SKU pengelolaan QnA Maker Anda ingin memiliki lebih banyak pasangan QnA atau sumber dokumen di pangkalan pengetahuan Anda.
Tingkatkan SKU App Service dan periksa tingkat Pencarian Azure AI dan buat replika Cognitive Search Pangkalan pengetahuan Anda perlu melayani lebih banyak permintaan dari aplikasi klien Anda, seperti bot obrolan.
Meningkatkan layanan Pencarian Azure AI Anda berencana untuk memiliki banyak pangkalan pengetahuan.

Dapatkan pembaruan waktu proses terbaru dengan memperbarui App Service Anda di portal Azure.

Kunci di QnA Maker

Layanan QnA Maker Anda menangani dua jenis kunci: kunci penulisan dan kunci titik akhir kueri yang digunakan dengan waktu proses yang dihosting di layanan Aplikasi.

Gunakan kunci ini saat membuat permintaan ke layanan melalui API.

Key management

Nama Lokasi Tujuan
Kunci Penulisan/Langganan Portal Azure Kunci ini digunakan untuk mengakses API layanan pengelolaan QnA Maker. API ini memungkinkan Anda mengedit pertanyaan dan jawaban di pangkalan pengetahuan Anda, dan menerbitkan pangkalan Pengetahuan Anda. Kunci ini dibuat saat Anda membuat layanan QnA Maker baru.

Temukan kunci ini di sumber daya layanan Azure AI di halaman Kunci dan Titik Akhir.
Tombol titik akhir kueri Portal QnA Maker Kunci ini digunakan untuk mengkueri titik akhir pangkalan pengetahuan yang diterbitkan untuk mendapatkan respons atas pertanyaan pengguna. Anda biasanya menggunakan titik akhir kueri ini di bot obrolan Anda atau di kode aplikasi klien yang tersambung ke layanan QnA Maker. Kunci ini dibuat saat Anda menerbitkan pangkalan pengetahuan QnA Maker Anda.

Temukan kunci ini di halaman Pengaturan layanan. Temukan halaman ini dari menu pengguna di kanan atas halaman pada menu tarik-turun.

Menemukan kunci penulisan di portal Azure

Anda dapat melihat dan mengatur ulang kunci penulisan dari portal Azure, tempat Anda membuat sumber daya QnA Maker.

  1. Buka sumber daya QnA Maker di portal Azure dan pilih sumber daya yang memiliki jenis layanan Azure AI:

    QnA Maker resource list

  2. Pilih Kunci dan Titik Akhir:

    QnA Maker managed (Preview) Subscription key

Menemukan kunci titik akhir kueri di portal QnA Maker

Titik akhir berada di wilayah yang sama dengan sumber daya karena kunci titik akhir digunakan untuk membuat panggilan ke pangkalan pengetahuan.

Kunci titik akhir dapat dikelola dari portal QnA Maker.

  1. Masuk ke portal QnA Maker, buka profil Anda, lalu pilih Pengaturan layanan:

    Endpoint key

  2. Melihat atau mengatur ulang kunci Anda:

    Endpoint key manager

    Catatan

    Refresh kunci Anda jika menurut Anda kunci tersebut telah disusupi. Ini mungkin memerlukan perubahan yang sesuai pada aplikasi klien atau kode bot Anda.

Wilayah layanan manajemen

Layanan manajemen QnA Maker hanya digunakan untuk portal QnA Maker dan untuk pemrosesan data awal. Layanan ini hanya tersedia di wilayah US Barat. Tidak ada data pelanggan yang disimpan di layanan US Barat ini.

Pertimbangan penamaan sumber daya

Nama sumber daya untuk sumber daya QnA Maker, seperti qna-westus-f0-b, juga digunakan untuk memberi nama sumber daya lainnya.

Jendela pembuatan portal Azure memungkinkan Anda membuat sumber daya QnA Maker dan memilih tingkat harga untuk sumber daya lainnya.

Screenshot of Azure portal for QnA Maker resource creation

Setelah sumber daya dibuat, sumber daya memiliki nama yang sama, kecuali untuk sumber daya Application Insights opsional, yang menambahkan karakter ke nama.

Screenshot of Azure portal resource listing

Tip

Buat grup sumber daya baru saat Anda membuat sumber daya QnA Maker. Itu memungkinkan Anda melihat semua sumber daya yang terkait dengan sumber daya QnA Maker saat mencari berdasarkan grup sumber daya.

Tip

Gunakan konvensi penamaan untuk menunjukkan tingkat harga dalam nama sumber daya atau grup sumber daya. Ketika Anda menerima kesalahan dari membuat pangkalan pengetahuan baru, atau menambahkan dokumen baru, batas tingkat harga Cognitive Search adalah masalah umum.

Tujuan sumber daya

Setiap sumber daya Azure yang dibuat dengan QnA Maker memiliki tujuan khusus:

  • Sumber daya QnA Maker
  • Sumber daya Azure Cognitive Search
  • App Service
  • Layanan Paket Aplikasi
  • Layanan Application Insights

Sumber daya QnA Maker

Sumber daya QnA Maker menyediakan akses ke API penulisan dan penerbitan.

Pengaturan konfigurasi sumber daya QnA Maker

Saat Anda membuat pangkalan pengetahuan baru di portal QnA Maker, pengaturan Bahasa adalah satu-satunya pengaturan yang diterapkan di tingkat sumber daya. Anda memilih bahasa saat membuat basis pengetahuan pertama untuk sumber daya.

Sumber daya Azure Cognitive Search

Sumber daya Cognitive Search digunakan untuk:

  • Menyimpan pasangan tanya jawab
  • Memberikan peringkat awal (peringkat #1) dari pasangan tanya jawab saat runtime

Penggunaan indeks

Sumber daya menyimpan satu indeks untuk bertindak sebagai indeks pengujian dan indeks lainnya masing-masing berkorelasi dengan satu pangkalan pengetahuan yang diterbitkan.

Sumber daya yang dihargai untuk menampung 15 indeks, akan menampung 14 pangkalan pengetahuan yang diterbitkan, dan satu indeks digunakan untuk menguji semua pangkalan pengetahuan. Indeks pengujian ini dipartisi oleh pangkalan pengetahuan sehingga kueri yang menggunakan panel uji interaktif akan menggunakan indeks pengujian tetapi hanya mengembalikan hasil dari partisi tertentu yang terkait dengan pangkalan pengetahuan tertentu.

Penggunaan bahasa

Pangkalan pengetahuan pertama yang dibuat dalam sumber daya QnA Maker digunakan untuk menentukan bahasa tunggal yang ditetapkan untuk sumber daya Cognitive Search dan semua indeksnya. Anda hanya dapat memiliki satu set bahasa untuk layanan QnA Maker.

Menggunakan satu layanan Cognitive Search

Jika Anda membuat layanan TJ dan dependensinya (seperti Search) melalui portal, layanan Pencarian dibuat untuk Anda dan ditautkan ke layanan QnA Maker. Setelah sumber daya ini dibuat, Anda dapat memperbarui pengaturan App Service untuk menggunakan layanan Pencarian yang sudah ada sebelumnya dan menghapus yang baru saja Anda buat.

Pelajari cara mengonfigurasi QnA Maker untuk menggunakan sumber daya layanan Azure AI yang berbeda dari yang dibuat sebagai bagian dari proses pembuatan sumber daya QnA Maker.

Layanan Aplikasi dan paket layanan Aplikasi

Layanan aplikasi digunakan oleh aplikasi klien Anda untuk mengakses basis pengetahuan yang diterbitkan melalui titik akhir waktu proses. Layanan aplikasi meliputi lapisan peringkat kedua berbasis pemrosesan bahasa alami (NLP) (pemberi peringkat # 2) dari pasangan QnA saat runtime. Peringkat kedua menerapkan filter cerdas yang dapat menyertakan metadata dan perintah tindak lanjut.

Untuk mengkueri pangkalan pengetahuan yang diterbitkan, semua pangkalan pengetahuan yang diterbitkan menggunakan titik akhir URL yang sama, tetapi menentukan ID pangkalan pengetahuan dalam rute.

{RuntimeEndpoint}/qnamaker/knowledgebases/{kbId}/generateAnswer

Application Insights

Application Insights digunakan untuk mengumpulkan log obrolan dan telemetri. Tinjau kueri Kusto umum untuk informasi tentang layanan Anda.

Bagikan layanan dengan QnA Maker

QnA Maker membuat beberapa sumber daya Azure. Untuk mengurangi pengelolaan dan manfaat dari pembagian biaya, gunakan tabel berikut untuk memahami apa yang dapat dan tidak dapat Anda bagikan:

Layanan Bagikan Alasan
Layanan Azure AI X Tidak dimungkinkan oleh desain
Paket App Service Memperbaiki ruang disk yang dialokasikan untuk paket App Service. Jika aplikasi lain yang berbagi paket App Service yang sama menggunakan ruang disk yang signifikan, instans App Service QnAMaker akan mengalami masalah.
App Service X Tidak dimungkinkan oleh desain
Application Insights Dapat dibagikan
Layanan Pencarian 1. testkb adalah nama yang dicadangkan untuk layanan QnAMaker; tidak dapat digunakan oleh orang lain.
2. Peta sinonim dengan nama synonym-map disediakan untuk layanan QnAMaker.
3. Jumlah basis pengetahuan yang diterbitkan dibatasi oleh tingkat layanan Search. Jika ada indeks gratis yang tersedia, layanan lain dapat menggunakannya.

Langkah berikutnya