Banyak platform integrasi mendukung pesan respons lengkap khusus platform. 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 subset jenis respons yang tersedia.
Tempat menemukan data ini
Saat membuat agen, hal yang paling umum adalah menggunakan konsol Dialogflow ES (kunjungi dokumentasi, buka konsol). Petunjuk di bawah berfokus pada penggunaan konsol. Untuk mengakses data respons intent:
- Buka konsol Dialogflow ES.
- 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 ini menyoroti perbedaan penting antara konsol dan API.
Menambahkan pesan respons lengkap
Bagian Responses 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 di 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 lengkap:
- Pilih tab untuk platform yang Anda inginkan. Jika tab platform yang diinginkan tidak ditampilkan, klik tombol tambahkan add dan pilih.
- Klik tombol Tambahkan Respons. Dropdown menampilkan jenis respons yang didukung oleh platform.
- Pilih jenis respons. Hal ini dijelaskan di bawah.
- Masukkan kolom untuk jenis respons yang dipilih.
- Tambahkan lebih banyak tab dan respons platform 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 Text mengirim respons teks kepada pengguna akhir.
Jika text-to-speech diaktifkan untuk agen atau diminta oleh permintaan intent deteksi, teks yang disediakan akan digunakan untuk menyintesis ucapan dan memutar audio. Dalam hal ini, teks yang disediakan dapat secara opsional menggunakan Speech Synthesis Markup Language (SSML).
Kolomnya 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:
- Maksimum 300 entri teks per respons teks
Respons gambar
Respons Gambar mengirim gambar ke pengguna akhir. Kolom ini berisi kolom berikut:
- URL yang dapat diakses secara publik untuk gambar
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 yang dapat diakses secara publik untuk gambar
- Judul kartu
- Subjudul 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 berbahasa Inggris untuk platform Y
- 10 kartu bahasa Prancis untuk platform X
- 10 kartu Prancis untuk platform Y
Respons balasan cepat
Respons Balasan Cepat mengirimkan tombol kepada pengguna akhir. Anda dapat mengonfigurasi tombol untuk mengirim teks yang telah dikonfigurasi sebelumnya ke Dialogflow seolah-olah pengguna akhir memberikan ekspresi.
Kolomnya adalah:
- Judul tombol
- Daftar entri teks yang akan dikirim sebagai ekspresi pengguna akhir
Batasan berikut berlaku:
Maksimum satu respons balasan cepat per platform dan per bahasa untuk intent. Misalnya, jika agen Anda mendukung bahasa Inggris, Prancis, platform X, dan platform Y, intent dapat memiliki maksimal 4 balasan cepat:
- 1 balasan cepat dalam bahasa Inggris untuk platform X
- 1 respons cepat dalam bahasa Inggris untuk platform Y
- 1 respons cepat bahasa Prancis untuk platform X
- 1 respons cepat bahasa Prancis untuk platform Y
Maksimum 10 entri teks per respons balasan cepat.
Maksimal 20 karakter per entri teks.
Menyintetis 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).
Kolomnya adalah:
- Teks atau SSML
Batasan berikut berlaku:
- Hanya didukung oleh integrasi gateway telepon Dialogflow
- Maksimum 20 respons ucapan sintesis per intent
Memutar respons audio
Respons Putar Audio digunakan untuk memutar file audio. File audio disediakan di bucket Cloud Storage.
Kolomnya adalah:
- URI objek Cloud Storage dalam format
gs://bucket-name/object-name.
Batasan berikut berlaku:
- Hanya didukung oleh integrasi gateway telepon Dialogflow
- Spesifikasi file audio: satu saluran (mono) audio PCM linear (2 byte / sampel) pada 8 kHz
- Maksimum 20 respons audio putar per intent
Mentransfer respons panggilan
Respons Transfer Panggilan digunakan untuk mentransfer pemanggil untuk integrasi telepon.
Kolomnya adalah:
- Nomor telepon tujuan transfer.
Batasan berikut berlaku:
Hanya didukung oleh integrasi gateway telepon 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. Dialog ini tidak akan diproses oleh Dialogflow, jadi Anda harus menanganinya dalam logika bisnis Anda sendiri.
Anda dapat mengonfigurasi payload kustom untuk beberapa platform. Untuk mengonfigurasinya, gunakan platform default dan format JSON yang mirip dengan berikut:
{
"facebook": {
"attachment": {
"type": "",
"payload": {}
}
},
"slack": {
"text": "",
"attachments": []
}
}
Jenis respons Asisten Google
Integrasi Asisten Google menyediakan banyak jenis pesan respons. Untuk 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.