Konektor pengetahuan melengkapi intent yang ditentukan. API tersebut menguraikan dokumen pengetahuan (misalnya, FAQ atau artikel) untuk menemukan respons otomatis. Untuk mengonfigurasinya, Anda menentukan satu atau beberapa dasar pengetahuan, yang merupakan kumpulan dokumen pengetahuan.
Anda dapat mengaktifkan pusat informasi untuk agen, sehingga semua permintaan intent yang terdeteksi dapat menemukan respons otomatis menggunakan pusat informasi Anda. Atau, Anda dapat menentukan satu atau beberapa pusat informasi dalam setiap permintaan mendeteksi intent.
Sangat umum bagi agen yang menggunakan konektor pengetahuan untuk juga menggunakan intent yang ditentukan. Konektor pengetahuan menawarkan kontrol dan presisi respons yang lebih sedikit dibandingkan intent. Anda harus menentukan intent untuk menangani permintaan pengguna yang kompleks, dan mengizinkan konektor pengetahuan menangani permintaan sederhana.
Untuk mengetahui daftar bahasa yang didukung, lihat kolom Konektor Pengetahuan di referensi bahasa.
Batasan
Fitur konektor info hanya tersedia untuk wilayah global
.
Aktifkan fitur beta
Pastikan fitur beta diaktifkan:
- Buka Konsol Dialogflow ES.
- Pilih agen.
- Klik tombol setelan settings di samping nama agen.
- Scroll ke bawah saat berada di tab Umum dan pastikan Fitur Beta diaktifkan.
- Jika Anda telah membuat perubahan, klik Simpan.
Membuat pusat informasi dan membuat dokumen
Ikuti petunjuk dalam petunjuk dasar pengetahuan untuk membuat pusat informasi dan dokumen.
Setelan untuk konektor pengetahuan
Anda dapat mengaktifkan atau menonaktifkan basis pengetahuan untuk agen Anda. Basis informasi yang diaktifkan akan dipertimbangkan untuk semua permintaan pencocokan intent yang tidak menentukan basis pengetahuan. Untuk mengaktifkan atau menonaktifkan pusat informasi:
- Buka Konsol Dialogflow ES.
- Pilih agen.
- Klik Pengetahuan di menu sidebar kiri.
- Pilih satu atau beberapa pusat informasi dari daftar.
- Klik Aktifkan atau Nonaktifkan.
Jika ekspresi pengguna akhir juga cocok dengan intent, Anda dapat menentukan seberapa kuat hasil pengetahuan Anda:
- Scroll ke bawah ke bagian Sesuaikan Preferensi Hasil Pengetahuan.
- Sesuaikan penggeser dari lebih lemah (preferensi yang diberikan pada intent) ke lebih kuat (preferensi yang diberikan pada pengetahuan). Untuk informasi lebih lanjut, lihat Mendeteksi respons intent di bawah.
Mengonfigurasi respons
Secara default, pusat informasi dikonfigurasi dengan satu respons teks default yang diisi dengan jawaban pengetahuan yang paling cocok. Anda dapat mengubah respons ini dan menambahkan pesan respons kaya. Respons pengetahuan dapat berisi hingga tiga jawaban per pusat informasi, dan Anda dapat merujuk jawaban ini dalam respons yang dikonfigurasi. Untuk menambahkan respons:
- Dari halaman Pengetahuan, klik nama pusat informasi Anda.
- Scroll ke bawah ke bagian Respons dan tambahkan respons sesuai keinginan:
- Saat menentukan respons pertama,
gunakan
$Knowledge.Question[1]
dan$Knowledge.Answer[1]
tempat Anda ingin menyediakan pertanyaan dan jawaban. - Indeks untuk
$Knowledge.Question
dan$Knowledge.Answer
dimulai dari 1, jadi tingkatkan indeks ini saat menambahkan lebih banyak respons.
- Saat menentukan respons pertama,
gunakan
- Klik Simpan setelah Anda selesai mengedit.
Saat menentukan respons, Anda harus mempertimbangkan poin-poin berikut:
- Jika jumlah respons yang ditentukan lebih besar dari jumlah N respons konektor pengetahuan yang cocok, hanya N respons yang akan ditampilkan.
- Mengingat akurasinya mungkin lebih rendah daripada mencocokkan intent yang ditentukan secara eksplisit, sebaiknya tampilkan tiga respons kepada pengguna Anda jika memungkinkan.
Contoh:
Mendeteksi intent dengan basis pengetahuan
Saat membuat permintaan intent deteksi, Anda dapat menentukan satu atau beberapa basis pengetahuan untuk kemungkinan respons. Menyediakan pusat informasi secara eksplisit dalam permintaan akan mengganti setelan untuk pusat informasi yang diaktifkan dan dinonaktifkan.
Contoh di bawah ini menunjukkan cara menggunakan Konsol Dialogflow, REST API (termasuk command line), atau library klien untuk mendeteksi intent.
Untuk menggunakan API, panggil metode detectIntent
pada
jenis
Sessions
.
UI Web
Anda dapat berinteraksi dengan agen dan menerima respons konektor pengetahuan melalui simulator Dialogflow:- Ikuti langkah-langkah di atas untuk mengaktifkan pusat informasi.
- Ikuti langkah-langkah di atas untuk menentukan respons.
- Ketik "Bagaimana cara mendaftar?" di simulator.
REST
Panggil metodedetectIntent
pada
jenis Sessions
dan tentukan basis pengetahuan di kolom queryParams
.
Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:
- PROJECT_ID: project ID GCP Anda
- KNOWLEDGE_BASE_ID: ID pusat informasi Anda
Metode HTTP dan URL:
POST https://dialogflow.googleapis.com/v2beta1/projects/PROJECT_ID/agent/sessions/123456789:detectIntent
Meminta isi JSON:
{ "queryInput": { "text": { "text": "How do I sign up?", "languageCode": "en-US" } }, "queryParams": { "knowledgeBaseNames": ["projects/PROJECT_ID/knowledgeBases/KNOWLEDGE_BASE_ID"] } }
Untuk mengirim permintaan Anda, perluas salah satu opsi berikut:
Anda akan melihat respons JSON seperti berikut:
{ ... "queryResult": { "queryText": "How do I sign up?", "parameters": {}, "allRequiredParamsPresent": true, "fulfillmentText": "Sign up for Cloud Storage by turning on the Cloud Storage service in the Google Cloud Platform Console.", "intent": { "name": "projects/my-gcp-project/agent/intents/487c7242-a769-408a-a339-47b95e10dac4", "displayName": "Knowledge.KnowledgeBase.MzkzNTAyMDE3NDQxNDk3MDg4MA" }, "intentDetectionConfidence": 0.99371547, "languageCode": "en-us", "knowledgeAnswers": { "answers": [ { "answer": "Sign up for Cloud Storage by turning on the Cloud Storage service in the Google Cloud Platform Console.", "matchConfidenceLevel": "HIGH", "matchConfidence": 0.99371547 }, { "answer": "Certain types of content are not allowed on this service; please refer to the Terms of Services and Platform Policies for details. If you believe a piece of content is in violation of our policies, report it here (select See more products, then Google Cloud Storage and Cloud Bigtable).", "matchConfidenceLevel": "LOW", "matchConfidence": 0.0012244871 }, { "answer": "From the Cloud Storage documentation click \"Send feedback\" near the top right of the page. This will open a feedback form. Your comments will be reviewed by the Cloud Storage team.", "matchConfidenceLevel": "LOW", "matchConfidence": 0.0011537358 } ] } } }
Java
Untuk mengautentikasi ke Dialogflow, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, baca Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
Node.js
Untuk mengautentikasi ke Dialogflow, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, baca Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
Python
Untuk mengautentikasi ke Dialogflow, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, baca Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
Mendeteksi respons intent
Respons untuk metode
detectIntent
jenis
Sessions
adalah DetectIntentResponse
.
Beberapa faktor memengaruhi cara kolom respons diisi.
Jika intent yang ditentukan dan basis pengetahuan sama-sama berpotensi cocok,
tingkat kecocokan antara keduanya dan preferensi hasil info
(lihat Setelan untuk konektor info)
digunakan untuk menentukan kecocokan mana yang merupakan kecocokan yang dipilih.
Kecocokan yang dipilih diisi di kolom DetectIntentResponse.queryResult
,
dan potensi kecocokan lainnya akan diisi di kolom DetectIntentResponse.alternativeQueryResults
.
Kedua kolom ini berisi pesan QueryResult
.
Jika basis pengetahuan memberikan potensi kecocokan:
QueryResult.knowledgeAnswers
diisi dengan daftar jawaban potensial pengetahuan yang diurutkan dengan menurunkan tingkat keyakinan kecocokan.- Jika respons kaya telah ditentukan untuk basis pengetahuan,
QueryResult.fulfillmentMessages
akan diisi dengan pesan respons lengkap.
Saat melakukan permintaan intent deteksi, ada kemungkinan kueri pengetahuan gagal.
Jika hal ini terjadi, intent yang ditentukan akan dipilih,
sehingga permintaan intent deteksi secara keseluruhan tidak akan gagal.
Anda dapat menemukan informasi error kueri pengetahuan di kolom DetectIntentResponse.alternativeQueryResults[i].diagnosticInfo
.
Mengelola pusat informasi
Untuk mempelajari lebih lanjut cara mengelola basis pengetahuan, lihat Mengelola basis pengetahuan.