Pusat informasi mewakili kumpulan dokumen informasi yang Anda berikan ke Dialogflow. Dokumen pengetahuan Anda berisi informasi yang mungkin berguna selama percakapan dengan pengguna akhir. Beberapa fitur Dialogflow menggunakan pusat informasi saat mencari respons terhadap ekspresi pengguna akhir. Panduan ini menjelaskan cara membuat dan mengelola pusat informasi.
Pusat informasi diterapkan di tingkat agen.
Sebelum memulai
Anda harus melakukan hal berikut sebelum membaca panduan ini:
- Baca Dasar-dasar Dialogflow.
- Lakukan langkah-langkah penyiapan.
Membuat pusat informasi
Contoh di bawah menunjukkan cara menggunakan Konsol Dialogflow, REST API (termasuk command line), atau library klien untuk membuat pusat informasi.
Untuk menggunakan API, panggil metode create pada jenis KnowledgeBase.
UI Web
Gunakan Konsol Dialogflow untuk membuat pusat informasi:- Buka konsol Dialogflow ES
- Pilih agen
- Klik Knowledge di menu sidebar kiri
- Klik Create Knowledge Base
- Masukkan nama pusat informasi
- Klik Simpan
REST
Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:
- PROJECT_ID: project ID GCP Anda
- KNOWLEDGE_BASE_DISPLAY_NAME: nama pusat informasi yang diinginkan
Metode HTTP dan URL:
POST https://dialogflow.googleapis.com/v2beta1/projects/PROJECT_ID/knowledgeBases
Meminta isi JSON:
{
"displayName": "KNOWLEDGE_BASE_DISPLAY_NAME"
}
Untuk mengirim permintaan Anda, perluas salah satu opsi berikut:
Anda akan melihat respons JSON seperti berikut:
{
"name": "projects/PROJECT_ID/knowledgeBases/NDA4MTM4NzE2MjMwNDUxMjAwMA",
"displayName": "KNOWLEDGE_BASE_DISPLAY_NAME"
}
Catat nilai kolom name.
Ini adalah nama pusat informasi baru Anda.
Segmen jalur setelah knowledgeBases adalah ID pusat informasi baru Anda.
Simpan ID ini untuk permintaan di bawah.
Java
Untuk melakukan autentikasi ke Dialogflow CX, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, lihat Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
Node.js
Untuk melakukan autentikasi ke Dialogflow CX, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, lihat Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
Python
Untuk melakukan autentikasi ke Dialogflow CX, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, lihat Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
Menambahkan dokumen ke pusat informasi
Pusat informasi baru Anda saat ini tidak memiliki dokumen, jadi Anda harus menambahkan dokumen ke dalamnya. Lihat Konten yang didukung di bawah untuk mengetahui deskripsi semua opsi konten yang didukung. Anda dapat menggunakan dokumen FAQ Cloud Storage untuk contoh ini.
Contoh di bawah menunjukkan cara menggunakan Konsol Dialogflow, REST API (termasuk command line), atau library klien untuk membuat dokumen pengetahuan.
Untuk menggunakan API, panggil metode create pada jenis
Document.
UI Web
Gunakan Konsol Dialogflow untuk membuat dokumen ulasan:- Jika Anda tidak melanjutkan dari langkah-langkah di atas,
buka setelan pusat informasi:
- Buka konsol Dialogflow ES
- Pilih agen
- Klik Knowledge di menu sidebar kiri
- Klik nama pusat informasi Anda
- Klik New Document atau Create the first one
- Masukkan nama dokumen
- Pilih text/html untuk jenis MIME
- Pilih FAQ untuk Knowledge Type
- Pilih URL untuk Sumber Data
- Masukkan https://cloud.google.com/storage/docs/faq di kolom URL
- Klik CREATE
REST
Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:
- PROJECT_ID: project ID GCP Anda
- KNOWLEDGE_BASE_ID: ID pusat informasi Anda yang ditampilkan dari permintaan sebelumnya
- DOCUMENT_DISPLAY_NAME: nama dokumen informasi yang diinginkan
Metode HTTP dan URL:
POST https://dialogflow.googleapis.com/v2beta1/projects/PROJECT_ID/knowledgeBases/KNOWLEDGE_BASE_ID/documents
Meminta isi JSON:
{
"displayName": "DOCUMENT_DISPLAY_NAME",
"mimeType": "text/html",
"knowledgeTypes": "FAQ",
"contentUri": "https://cloud.google.com/storage/docs/faq"
}
Untuk mengirim permintaan Anda, perluas salah satu opsi berikut:
Anda akan melihat respons JSON seperti berikut:
{
"name": "projects/PROJECT_ID/operations/ks-add_document-MzA5NTY2MTc5Mzg2Mzc5NDY4OA"
}
Segmen jalur setelah operations adalah ID operasi Anda.
Java
Untuk melakukan autentikasi ke Dialogflow CX, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, lihat Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
Node.js
Untuk melakukan autentikasi ke Dialogflow CX, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, lihat Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
Python
Untuk melakukan autentikasi ke Dialogflow CX, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, lihat Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
Membuat dokumen adalah operasi yang berjalan lama, sehingga mungkin perlu waktu lama untuk menyelesaikannya. Anda dapat memeriksa status operasi ini untuk melihat apakah operasi telah selesai. Setelah selesai, operasi akan berisi ID dokumen yang baru dibuat. Simpan ID ini untuk pemrosesan mendatang. Untuk informasi selengkapnya, buka Operasi yang berjalan lama.
Mengelola dokumen pengetahuan
Memperbarui konten dokumen pengetahuan
Jika Anda memperbarui konten yang dirujuk oleh dokumen informasi, dokumen informasi Anda mungkin tidak otomatis dimuat ulang. Konten Anda hanya akan dimuat ulang secara otomatis jika disediakan sebagai URL publik dan Anda telah mencentang opsi Aktifkan Muat Ulang Otomatis untuk dokumen tersebut.
Untuk memuat ulang konten dokumen URL publik atau Cloud Storage secara manual, panggil metode reload pada jenis Document.
Untuk memuat ulang konten mentah yang diupload secara manual,
gunakan metode delete dan create pada
jenis
Document
untuk membuat ulang dokumen Anda.
Mencantumkan dokumen pengetahuan
Anda dapat mencantumkan semua dokumen pengetahuan untuk pusat informasi Anda.
Untuk menggunakan API, panggil metode list pada jenis
Document.
Menghapus dokumen informasi
Anda dapat menghapus dokumen informasi untuk pusat informasi Anda.
Untuk menggunakan API, panggil metode delete pada jenis
Document.
Jika tidak memiliki ID dokumen,
Anda dapat mencantumkan dokumen seperti yang dijelaskan di atas.
Konten yang didukung
Jenis dokumen informasi berikut didukung:
- FAQ: Konten dokumen berisi pasangan pertanyaan dan jawaban sebagai HTML atau CSV. Format HTML FAQ standar diuraikan secara akurat, tetapi format yang tidak biasa mungkin gagal diuraikan. CSV harus berisi pertanyaan di kolom pertama dan jawaban di kolom kedua, tanpa header. Karena format eksplisit ini, tanggal selalu diurai secara akurat.
- QA Ekstraktif: Dokumen yang teks tidak terstrukturnya diekstrak dan digunakan untuk menjawab pertanyaan.
Tabel berikut menunjukkan jenis MIME yang didukung menurut Jenis Pengetahuan dan Sumber.
| Jenis Pengetahuan \ Sumber | File yang diupload (Document.content) (TIDAK direkomendasikan) | File yang diupload (Document.raw_content) (direkomendasikan) | File dari Cloud Storage (Document.contentUri) | File dari URL publik (Document.contentUri) |
|---|---|---|---|---|
| FAQ | text/csv | text/csv | text/csv | text/html |
| UM (Uji Mutu) Ekstraktif | text/plain, text/html | text/plain, text/html, application/pdf | text/plain, text/html, application/pdf | T/A |
Konten dokumen memiliki masalah umum, batasan, dan praktik terbaik berikut:
Umum:
- File dari URL publik harus telah di-crawl oleh pengindeks Google Penelusuran, sehingga file tersebut ada dalam indeks penelusuran. Anda dapat memeriksanya dengan Google Search Console. Perhatikan bahwa pengindeks tidak membuat konten Anda tetap baru. Anda harus memperbarui dokumen pengetahuan secara eksplisit saat konten sumber berubah.
- File CSV harus menggunakan koma sebagai pemisah.
- Skor keyakinan belum dikalibrasi antara FAQ dan Artikel Pusat Informasi, jadi jika Anda menggunakan FAQ dan Artikel Pusat Informasi, hasil terbaik mungkin tidak selalu yang tertinggi.
- Dialogflow menghapus tag HTML dari konten saat membuat respons. Oleh karena itu, sebaiknya hindari tag HTML dan gunakan teks biasa jika memungkinkan.
- Respons Asisten Google memiliki batas karakter 640 per balon chat, sehingga jawaban yang panjang akan dipotong saat diintegrasikan dengan Asisten Google.
- Ukuran dokumen maksimum adalah 50 MB.
- Saat menggunakan file Cloud Storage, Anda harus menggunakan URI publik atau URI pribadi yang dapat diakses oleh akun pengguna atau akun layanan Anda.
Khusus untuk FAQ:
- CSV harus berisi pertanyaan di kolom pertama dan jawaban di kolom kedua, tanpa header.
- Gunakan CSV jika memungkinkan, karena CSV diurai dengan paling akurat.
- Konten HTML publik dengan satu pasangan Tanya Jawab tidak didukung.
- Jumlah pasangan Tanya Jawab dalam satu dokumen tidak boleh melebihi 2.000.
- Pertanyaan duplikat dengan jawaban berbeda tidak didukung.
- Anda dapat menggunakan dokumen FAQ apa pun; parser FAQ mampu menangani sebagian besar format FAQ.
Khusus untuk QA Ekstraktif:
- QA Ekstraktif saat ini bersifat eksperimental. Teknologi ini didasarkan pada teknologi serupa yang telah dicoba dan diuji di Google dalam produk seperti Penelusuran dan Asisten. Kirimkan masukan Anda kepada kami tentang seberapa baik performanya untuk Dialogflow.
- Konten dengan teks padat berfungsi paling baik. Hindari konten dengan banyak paragraf satu kalimat.
- Tabel dan daftar tidak didukung.
- Jumlah paragraf dalam satu dokumen tidak boleh melebihi 2.000.
- Jika artikelnya panjang (> 1.000 kata), coba uraikan menjadi beberapa artikel yang lebih kecil. Jika artikel membahas beberapa masalah, artikel tersebut dapat dipecah menjadi artikel yang lebih pendek yang membahas masalah satu per satu. Jika artikel hanya membahas satu masalah, fokuskan artikel pada deskripsi masalah dan buat penyelesaian masalahnya singkat.
- Idealnya, hanya konten inti artikel yang harus diberikan (deskripsi dan penyelesaian masalah). Konten tambahan seperti nama penulis, histori modifikasi, link terkait, dan iklan tidak penting.
- Coba sertakan deskripsi masalah yang dapat dibantu oleh artikel dan/atau contoh kueri yang dapat dijawab oleh artikel ini.
Menggunakan Cloud Storage
Jika konten Anda tidak bersifat publik, menyimpan konten di Cloud Storage adalah opsi yang direkomendasikan. Saat membuat dokumen pengetahuan, Anda memberikan URL untuk objek Cloud Storage Anda.
Membuat bucket dan objek Cloud Storage
Saat membuat bucket Cloud Storage:
- Pastikan Anda telah memilih project GCP yang digunakan untuk Dialogflow.
- Pastikan akun pengguna atau akun layanan yang biasa Anda gunakan untuk mengakses Dialogflow API memiliki izin baca ke objek bucket.
- Gunakan kelas Standard Storage.
- Tetapkan bucket location ke lokasi yang paling dekat dengan lokasi Anda.
Anda akan memerlukan ID lokasi (misalnya,
us-west1) untuk beberapa panggilan API, jadi catat pilihan Anda.
Ikuti petunjuk panduan memulai Cloud Storage untuk membuat bucket dan mengupload file.
Menyediakan objek Cloud Storage ke dokumen pusat informasi
Untuk menyediakan konten Anda:
- Buat pusat informasi seperti yang dijelaskan di atas.
- Buat dokumen pengetahuan seperti yang
dijelaskan di atas.
Saat memanggil metode
createpada jenisDocument, tetapkan kolomcontentUrike URL dokumen Cloud Storage Anda. Format URL ini adalahgs://bucket-name/object-name.