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 membangun agen, biasanya digunakan 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 Maksud di menu sidebar kiri.
- Pilih maksud.
- Scroll ke bawah ke bagian Respons.
Jika Anda membangun 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 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 di platform terkait. 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 tab tersebut.
- 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 tab dan respons platform lainnya 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 diberikan oleh pengguna akhir atau peristiwa saat runtime.
Respons teks
Secara default, respons Teks mengirimkan respons teks kepada pengguna akhir.
Jika text-to-speech diaktifkan untuk agen atau diminta oleh permintaan deteksi maksud, teks yang diberikan digunakan untuk menyintesis ucapan dan memutar audio. Dalam hal ini, teks yang diberikan 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 tekan Enter untuk memasukkan respons teks lain.
Batasan berikut berlaku:
- Maksimum 300 entri teks per respons teks
Respons gambar
Respons Gambar mengirimkan gambar kepada pengguna akhir. Kolom ini berisi kolom berikut:
- URL yang dapat diakses secara publik untuk gambar
Respons kartu
Respons Kartu mengirimkan gambar, judul kartu, subjudul 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
- 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 satu intent. Misalnya, jika agen Anda mendukung bahasa Inggris, Prancis, platform X, dan platform Y, intent dapat memiliki maksimal 40 kartu:
- 10 kartu berbahasa Inggris untuk platform X
- 10 kartu berbahasa Inggris untuk platform Y
- 10 kartu 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:
Maksimal satu respons balasan cepat per platform dan per bahasa untuk satu maksud. Misalnya, jika agen Anda mendukung bahasa Inggris, Prancis, platform X, dan platform Y, maka maksud dapat memiliki maksimal 4 balasan cepat:
- 1 balasan cepat berbahasa Inggris untuk platform X
- 1 balasan cepat dalam bahasa Inggris untuk platform Y
- 1 balasan cepat dalam bahasa Prancis untuk platform X
- 1 balasan cepat dalam bahasa Prancis untuk platform Y
Maksimal 10 entri teks per respons balasan cepat.
Maksimal 20 karakter per entri teks.
Mensintesis respons ucapan
Respons Synthesize Speech digunakan untuk menyintesis ucapan dari respons teks dan memutar audio. Teks yang diberikan dapat secara opsional menggunakan Speech Synthesis Markup Language (SSML).
Kolomnya adalah:
- Teks atau SSML
Batasan berikut berlaku:
- Hanya didukung oleh integrasi gateway telepon Dialogflow
- Maksimal 20 respons ucapan yang disintesis per maksud
Memutar respons audio
Respons Play 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
Respons transfer panggilan
Respons Transfer Call digunakan untuk mentransfer pemanggil untuk integrasi telepon.
Kolomnya adalah:
- Nomor telepon yang menjadi 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 yang tidak standar. Payload kustom ini disediakan dalam format JSON yang ditentukan dalam dokumentasi platform.
Anda juga dapat mengirim payload kustom ke integrasi yang Anda kembangkan. Tidak akan diproses oleh Dialogflow, jadi Anda harus menanganinya dalam logika bisnis Anda sendiri.
Anda dapat mengonfigurasi payload kustom untuk beberapa platform. Untuk mengonfigurasi ini, 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 mengetahui informasi selengkapnya.