Banyak platform integrasi mendukung pesan respons kaya khusus platform. Pesan-pesan ini dapat digunakan untuk memberikan lebih dari sekadar respons teks kepada pengguna akhir. Ada berbagai jenis respons yang dapat dipilih. Misalnya, Anda dapat menampilkan gambar, memutar audio, atau menyediakan tombol. Setiap platform mendukung subkumpulan jenis respons yang tersedia.
Di mana data ini dapat ditemukan
Saat membangun agen, cara yang paling umum adalah menggunakan Konsol Dialogflow ES (buka dokumentasi, buka konsol). Petunjuk di bawah berfokus pada penggunaan konsol. Untuk mengakses data respons intent:
- Buka Dialogflow ES Console.
- Pilih agen.
- Pilih Intent di menu sidebar kiri.
- Pilih intent.
- Scroll ke bawah ke bagian Respons.
Jika Anda membuat agen menggunakan API, bukan konsol, lihat Referensi intent. Nama kolom API mirip dengan nama kolom konsol. Petunjuk di bawah menyoroti perbedaan penting antara konsol dan API.
Menambahkan pesan respons kaya
Bagian Respons memiliki tab untuk setiap platform, termasuk platform default. Anda dapat menentukan respons untuk platform default, yang dapat digunakan di semua platform.
Anda dapat menentukan respons untuk tab khusus platform, yang hanya berfungsi pada platform yang sesuai. Anda juga dapat memilih untuk menggunakan respons default untuk platform tertentu, sehingga Anda tidak perlu membuat respons teks duplikat untuk semua platform.
Untuk menambahkan pesan respons kaya:
- Pilih tab untuk platform yang Anda inginkan. Jika tab platform yang diinginkan tidak ditampilkan, klik tombol tambahkan add dan pilih tab tersebut.
- Klik tombol Tambahkan Respons. Dropdown menampilkan jenis respons yang didukung oleh platform.
- Pilih jenis respons. Hal tersebut dijelaskan di bawah.
- Masukkan kolom untuk jenis respons yang dipilih.
- Tambahkan lebih banyak tab platform dan respons sesuai kebutuhan. Anda dapat menambahkan hingga 10 pesan yang diurutkan di setiap tab.
- Klik Simpan.
Anda dapat menggunakan referensi parameter dalam respons untuk mereferensikan parameter yang disediakan oleh pengguna akhir atau peristiwa saat runtime.
Respons teks
Secara default, respons Teks mengirim respons teks kepada pengguna akhir.
Jika text-to-speech diaktifkan untuk agen atau diminta oleh deteksi permintaan intent, teks yang disediakan akan digunakan untuk menyintesis ucapan dan memutar audio. Dalam hal ini, teks yang disediakan dapat menggunakan Bahasa Markup Sintesis Ucapan (SSML) secara opsional.
Kolom tersebut adalah:
- Daftar entri teks atau SSML
Saat memasukkan respons, tekan Shift + Enter untuk memasukkan baris baru atau cukup Enter untuk memasukkan respons teks lain.
Batasan berikut berlaku:
- Maksimal 300 entri teks per respons teks
Respons gambar
Respons Gambar mengirim gambar ke pengguna akhir. Kolom tersebut berisi kolom berikut:
- URL gambar yang dapat diakses secara publik
Respons kartu
Respons Kartu mengirimkan gambar, judul kartu, subtitel kartu, dan tombol interaktif kepada pengguna akhir. Gaya kartu bervariasi menurut platform.
Anda dapat mengonfigurasi tombol untuk mengarahkan pengguna akhir ke URL atau mengirim teks yang telah dikonfigurasi sebelumnya ke Dialogflow seolah-olah pengguna akhir memberikan ekspresi.
Beberapa kolom bersifat opsional, bergantung pada platform:
- URL gambar yang dapat diakses secara publik
- Judul kartu
- Subtitel kartu
- Daftar tombol dengan kolom berikut:
- Judul tombol
- Teks yang akan dikirim sebagai ekspresi pengguna akhir atau URL yang akan dibuka
Batasan berikut berlaku:
Maksimum 10 kartu per platform dan per bahasa untuk intent. Misalnya, jika agen Anda mendukung bahasa Inggris, Prancis, platform X, dan platform Y, intent dapat memiliki maksimal 40 kartu:
- 10 kartu bahasa Inggris untuk platform X
- 10 kartu bahasa Inggris untuk platform Y
- 10 kartu Prancis untuk platform X
- 10 kartu Prancis untuk platform Y
Respons balasan cepat
Respons Balas Cepat akan mengirimkan tombol kepada pengguna akhir. Anda dapat mengonfigurasi tombol untuk mengirim teks yang telah dikonfigurasi sebelumnya ke Dialogflow seolah-olah pengguna akhir memberikan ekspresi.
Kolom tersebut adalah:
- Judul tombol
- Daftar entri teks yang akan dikirim sebagai ekspresi pengguna akhir
Batasan berikut berlaku:
Maksimal satu respons balasan cepat per platform dan per bahasa untuk satu intent. Misalnya, jika agen Anda mendukung bahasa Inggris, Prancis, platform X, dan platform Y, intent dapat memiliki maksimal 4 balasan cepat:
- 1 balasan cepat bahasa Inggris untuk platform X
- 1 balasan cepat bahasa Inggris untuk platform Y
- 1 balasan cepat berbahasa Prancis untuk platform X
- 1 balasan cepat bahasa Prancis untuk platform Y
Maksimal 10 entri teks per respons balasan cepat.
Maksimum 20 karakter per entri teks.
Sintesis respons ucapan
Respons Synthesize Speech digunakan untuk menyintesis ucapan dari respons teks dan memutar audio. Teks yang disediakan dapat secara opsional menggunakan Bahasa Markup Sintesis Ucapan (SSML).
Kolom tersebut adalah:
- Teks atau SSML
Batasan berikut berlaku:
- Hanya didukung oleh integrasi gateway ponsel Dialogflow
- Maksimum 20 respons sintesis ucapan per intent
Putar respons audio
Respons Putar Audio digunakan untuk memutar file audio. File audio disediakan dalam bucket Cloud Storage.
Kolom tersebut adalah:
- URI objek Cloud Storage dalam format
gs://bucket-name/object-name.
Batasan berikut berlaku:
- Hanya didukung oleh integrasi gateway ponsel Dialogflow
- Spesifikasi file audio: saluran tunggal (mono) audio PCM linear (2 byte / sampel) pada 8kHz
- Maksimum 20 respons pemutaran audio per intent
Transfer respons panggilan
Respons Transfer Call digunakan untuk mentransfer pemanggil untuk integrasi telepon.
Kolom tersebut adalah:
- Nomor telepon yang menjadi tujuan transfer.
Batasan berikut berlaku:
Hanya didukung oleh integrasi gateway ponsel Dialogflow
Hanya nomor telepon AS yang didukung
Respons payload kustom
Beberapa platform mendukung respons payload kustom untuk menangani respons lanjutan non-standar. Payload kustom ini disediakan dalam format JSON yang ditentukan dalam dokumentasi platform.
Anda juga dapat mengirim payload kustom ke integrasi yang Anda kembangkan. Ini tidak akan diproses oleh Dialogflow, jadi Anda harus menanganinya dalam logika bisnis Anda sendiri.
Anda dapat mengonfigurasi payload kustom untuk berbagai platform. Untuk mengonfigurasinya, gunakan platform default dan format JSON yang mirip dengan berikut ini:
{
"facebook": {
"attachment": {
"type": "",
"payload": {}
}
},
"slack": {
"text": "",
"attachments": []
}
}
Jenis respons Asisten Google
Integrasi Asisten Google menyediakan banyak jenis pesan respons. Untuk mengetahui informasi selengkapnya, lihat referensi respons Asisten Google.
Jenis respons tambahan
Jenis pesan lainnya didukung oleh berbagai platform. Anda dapat melihat daftar lengkapnya di referensi REST pesan respons. Lihat dokumentasi integrasi platform untuk informasi selengkapnya.