Untuk giliran percakapan agen, agen harus merespons pengguna akhir dengan jawaban atas pertanyaan, kueri untuk informasi, atau penghentian sesi. Agen Anda mungkin juga perlu menghubungi layanan Anda untuk menghasilkan respons dinamis atau mengambil tindakan untuk suatu giliran. Fulfillment digunakan untuk menyelesaikan semua ini.
Fulfillment dapat berisi salah satu dari hal berikut:
- Pesan respons statis.
- Panggilan webhook untuk respons dinamis dan/atau untuk mengambil tindakan.
- Preset parameter untuk menetapkan atau mengganti parameter value.
Selama giliran agen, Anda dapat (dan terkadang diinginkan) memanggil beberapa fulfillment, yang masing-masing dapat menghasilkan pesan respons. Dialogflow CX menyimpan respons ini dalam antrean respons. Setelah giliran agen selesai, Dialogflow CX akan mengirimkan respons yang diurutkan kepada pengguna akhir.
Kasus penggunaan fulfillment
Fulfillment memungkinkan Anda memberikan pesan respons di tempat berikut:
- Pemenuhan entri halaman
- Rute
- Pengendali peristiwa
- Perintah awal untuk formulir
- Pengendali reprompt untuk formulir
Untuk setiap kasus penggunaan ini, konsol akan membuka panel pengeditan fulfillment.

Respons agen (opsi dialog)
Tentukan pesan respons agen pada waktu desain saat membuat fulfillment. Saat runtime, respons ini ditambahkan ke antrean respons.
Ada beberapa jenis pesan respons, yang dijelaskan dalam subbagian berikut. Saat menggunakan konsol, panel fulfillment memiliki kartu Agent dialogue awal, tetapi Anda dapat mengklik Add dialogue response untuk menambahkan lebih banyak kartu untuk jenis pesan respons lainnya.
Respons teks statis
Pesan respons teks statis memberikan dialog teks kepada pengguna. Jika panggilan API atau panggilan integrasi deteksi intent Anda menggunakan sintesis ucapan, teks ini akan menghasilkan konten audio. Untuk pesan ini, teks yang diberikan menggunakan Speech Synthesis Markup Language (SSML).
Anda dapat menentukan beberapa kartu respons teks dan beberapa respons teks dalam setiap kartu. Jika Anda menentukan beberapa kartu, kartu tersebut akan digabungkan untuk satu respons saat runtime. Jika Anda menentukan beberapa respons dalam satu kartu, salah satu pesan dalam kartu akan dipilih secara acak saat runtime.
Pesan teks ini dapat berisi referensi parameter dan fungsi sistem inline.
Payload kustom
Beberapa integrasi mendukung respons payload kustom untuk menangani respons lengkap. Payload kustom ini harus disediakan dalam format JSON yang ditentukan dalam dokumentasi integrasi. Misalnya, lihat format payload kustom Dialogflow CX Messenger.
Anda dapat menyertakan referensi parameter dalam JSON payload kustom. Gabungkan dalam tanda petik ganda untuk memperlakukannya sebagai nilai string JSON. Contoh:
{
"someField": "$session.params.date"
}
JSON payload kustom harus dibatasi hingga 24 tingkat kedalaman.
Anda juga dapat mengirim payload kustom ke integrasi yang Anda kembangkan. Input ini tidak akan diproses oleh Dialogflow CX, jadi Anda harus menanganinya dalam logika bisnis Anda sendiri.
Untuk mengetahui informasi selengkapnya, lihat template payload kustom.
Pengalihan ke agen langsung
Respons ini memberi sinyal kepada pemanggil API intent deteksi bahwa percakapan harus dialihkan ke agen manusia. Dialogflow CX menggunakan sinyal ini hanya untuk mengidentifikasi percakapan yang dialihkan untuk tujuan pengukuran; sinyal ini tidak mengubah status sesi.
Sistem atau integrasi Anda dapat menggunakan sinyal ini untuk melakukan tindakan apa pun yang diperlukan untuk mengalihkan percakapan. Karena Dialogflow CX tidak menerapkan struktur pada data ini, Anda dapat memilih struktur apa pun yang sesuai dengan sistem Anda.
Metadata keberhasilan percakapan
Respons ini memberi sinyal kepada pemanggil API deteksi intent bahwa percakapan dengan agen Dialogflow CX berhasil. Dialogflow CX menggunakan sinyal ini untuk mengidentifikasi percakapan yang berhasil untuk tujuan pengukuran, dan tidak mengubah status sesi dengan cara apa pun.
Sistem atau integrasi Anda dapat menggunakan sinyal ini untuk melakukan tindakan apa pun yang diperlukan. Dialogflow CX tidak menerapkan struktur apa pun pada data ini, sehingga Anda dapat memilih struktur apa pun yang sesuai dengan sistem Anda.
Memutar audio yang telah direkam sebelumnya
Respons ini memutar file audio untuk integrasi yang mendukung fitur ini.
Persyaratan format file audio mungkin berbeda untuk integrasi yang berbeda. Misalnya, lihat persyaratan untuk Gateway Telepon Dialogflow CX.
Untuk integrasi telepon partner, URL untuk file audio harus dapat diakses oleh partner. URL yang tersedia untuk publik, seperti file publik di Cloud Storage, selalu dapat diakses oleh partner. Partner juga dapat memberikan akses terbatas untuk file audio. Lihat dokumentasi partner untuk mengetahui detailnya.
Teks audio output
Respons ini mirip dengan respons teks, tetapi hanya berlaku untuk sintesis ucapan. Jika agen Anda dapat menangani sesi teks dan suara, Anda dapat menggunakan respons teks dan teks audio output yang unik untuk menciptakan pengalaman pengguna yang berbeda untuk teks versus suara. Jika teks audio output diberikan untuk sesi suara, respons teks biasa akan diabaikan.
Jika agen Anda menangani sesi teks dan suara, dan Anda menginginkan pesan respons yang sama, gunakan respons teks untuk sesi teks dan suara.
Teks audio output digabungkan dengan cara yang mirip dengan respons teks. Jika respons teks audio output adalah campuran teks dan SSML, hasil penyambungan akan diperlakukan sebagai SSML. Idealnya, Anda harus menggunakan teks atau SSML secara konsisten.
Respons bersyarat
Jenis respons ini memberikan respons bersyarat:
Format umumnya adalah:
if [condition] [response] elif [condition] [response] elif [condition] [response] else [response] endif
dengan:
[condition]menggunakan format yang sama dengan kondisi rute.[response]adalah respons teks.- Blok
elifdanelsebersifat opsional.
Contoh:
if $session.params.user-age >= 21 Ok, you may enter. else Sorry, you cannot enter. endif
[condition] dan [response] dapat menggunakan fungsi sistem inline untuk
menghasilkan nilai dinamis selama percakapan. Untuk mengetahui informasi selengkapnya, lihat
fungsi sistem dan
kondisi rute. [condition] diselesaikan berdasarkan status sesi di awal fulfillment. Jika [response] mengandalkan status sesi, parameter ini akan di-resolve
berdasarkan status sesi yang diperbarui di akhir fulfillment.
Untuk agen multibahasa,
[condition] bersifat umum untuk semua bahasa, sedangkan [response] bersifat
khusus bahasa. Saat Anda mengubah [condition] untuk satu bahasa di konsol,
bagian ini akan diperbarui dalam semua bahasa agen. Karena menjadi kondisi baru, [response] akan dihapus untuk semua bahasa selain bahasa yang Anda pilih saat memperbarui [condition].
Transfer panggilan telepon
Transfer panggilan hanya tersedia untuk Gateway Telepon Dialogflow CX.
Untuk beberapa integrasi telepon, Anda dapat menentukan nomor telepon di AS untuk transfer panggilan. Saat runtime, ketika agen Dialogflow CX memicu fulfillment dengan transfer panggilan, panggilan akan ditransfer ke nomor yang ditentukan dan penanganan agen akan ditangguhkan.
Respons alat penyimpanan data
Jenis respons ini mengonfigurasi respons agen yang ditampilkan dari alat penyimpanan data yang ditautkan. Jika Anda mengonfigurasi alat penyimpanan data dalam fulfillment ini, kartu respons alat penyimpanan data akan diisi secara otomatis.
- Link sumber: Tetapkan jumlah maksimum kutipan yang akan ditampilkan kepada pengguna setelah respons. Kutipan adalah link ke sumber informasi di penyimpanan data, yang dirender sebagai tombol. Nilai defaultnya adalah 1.
- Kutipan inline: Batasi jumlah kutipan inline yang ditampilkan per kalimat, bukan mencantumkan link setelah respons.
- Penggantian respons generatif: Konfigurasikan agen untuk mencoba respons yang dihasilkan AI jika penyimpanan data menampilkan hasil kosong. Jika gagal, agen akan menggunakan respons statis.
- Respons statis: Masukkan respons teks statis di kolom terakhir untuk dikirimkan kepada pengguna kata demi kata.
Pesan respons khusus saluran
Saat menentukan fulfillment, Anda dapat membuat pesan respons khusus saluran untuk membuat respons yang ditargetkan untuk chat teks, suara, SMS, atau integrasi tertentu yang mendukung saluran. Setiap pesan respons yang tidak spesifik untuk suatu saluran disebut pesan respons default.
Saat runtime, Dialogflow CX memilih pesan respons default atau pesan respons khusus saluran saat permintaan deteksi intent menentukan saluran. Sebagai praktik terbaik, Anda harus menentukan pesan respons default, meskipun Anda menggunakan pesan respons khusus saluran. Pesan respons default berfungsi sebagai penggantian saat sistem Anda gagal menyediakan saluran yang valid.
Nama channel adalah kolom kustom yang dapat Anda tetapkan ke teks apa pun. Jika menggunakan Dialogflow CX API secara langsung untuk panggilan runtime, Anda dapat menggunakan nama saluran apa pun yang Anda inginkan. Jika menggunakan integrasi yang ada, Anda harus menggunakan nama channel yang dikenali oleh integrasi tersebut.
Menetapkan pesan respons khusus saluran pada waktu desain
Untuk memberikan pesan respons khusus saluran untuk fulfillment saat menggunakan konsol:
- Klik Tambahkan saluran setelah menambahkan pesan respons default untuk menambahkan pesan respons khusus saluran. Klik Tambahkan saluran lagi untuk menambahkan saluran lainnya.
Untuk memberikan pesan respons khusus saluran untuk fulfillment saat menggunakan API:
- Tetapkan kolom
Fulfillment.messages[i].channelke saluran yang dipilih untuk setiap pesan respons. Jika kolom ini tidak ditetapkan, respons akan diperlakukan sebagai pesan respons default.
Menggunakan pesan respons khusus saluran saat runtime
Jika Anda menggunakan integrasi yang sudah ada dan mendukung saluran, implementasi integrasi akan melakukan langkah-langkah ini.
Untuk menerima pesan respons khusus saluran, Anda harus menentukan saluran
dalam pesan permintaan deteksi intent. Lihat kolom queryParams.channel di
metode detectIntent dari jenis Sessions.
Pilih protokol dan versi untuk Referensi sesi:
| Protokol | V3 | V3beta1 |
|---|---|---|
| REST | Resource sesi | Resource sesi |
| RPC | Antarmuka sesi | Antarmuka sesi |
| C++ | SessionsClient | Tidak tersedia |
| C# | SessionsClient | Tidak tersedia |
| Go | SessionsClient | Tidak tersedia |
| Java | SessionsClient | SessionsClient |
| Node.js | SessionsClient | SessionsClient |
| PHP | Tidak tersedia | Tidak tersedia |
| Python | SessionsClient | SessionsClient |
| Ruby | Tidak tersedia | Tidak tersedia |
Dialogflow CX menampilkan pesan respons default jika permintaan tidak menentukan saluran atau jika fulfillment tidak menemukan saluran yang cocok.
Template payload kustom
Jika Anda sering menggunakan payload kustom, gunakan template payload kustom. Payload kustom terkadang berukuran besar dan kompleks, sehingga penggunaan template akan menyederhanakan proses pembuatan agen.
Sediakan template ini di setelan agen agar tersedia untuk dipilih saat membuat fulfillment untuk agen Anda.
Misalnya, payload JSON untuk tombol "ya" dan "tidak" dapat ditentukan sebagai template payload kustom. Saat membuat fulfillment yang memerlukan tombol ini, pilih template saat membuat fulfillment.
Saat Anda memilih template untuk payload kustom fulfillment, konten template akan disisipkan ke dalam payload. Kemudian, Anda dapat mengedit payload sesuai kebutuhan.
Jika Anda mengubah template, perubahan tidak akan diterapkan secara otomatis ke semua payload fulfillment yang telah dirujuk.
Untuk membuat template payload kustom, lihat setelan umum agen.
Untuk memilih template payload kustom saat membuat fulfillment, klik Select template saat membuat payload kustom fulfillment.
Panggilan webhook
Saat fulfillment memicu webhook, agen akan mengirimkan permintaan ke layanan Anda. Webhook Anda dapat melakukan tindakan, memberikan pesan respons dinamis, mengganti nilai parameter, dan mengubah halaman saat ini.
Berikut ini penjelasan setelan webhook untuk fulfillment:
| X | Item |
|---|---|
| Mengaktifkan webhook | Tindakan ini akan mengaktifkan webhook untuk fulfillment. |
| Webhook | Pilih resource webhook. |
| Tag | Tag teks yang Anda berikan di sini akan diisi di kolom WebhookRequest.fulfillmentInfo.tag permintaan webhook yang dikirim ke layanan webhook Anda. Hal ini dapat digunakan untuk mengontrol perilaku webhook dengan cara yang spesifik untuk fulfillment. |
| Menampilkan respons sebagian | Memungkinkan pembatalan pemutaran respons sebagian. Untuk mengetahui detailnya, lihat Setelan ucapan lanjutan. |
Parameter presets
Gunakan fulfillment untuk memberikan preset yang menetapkan atau mengganti nilai parameter saat ini. Preset ini diterapkan sebelum menyelesaikan pesan respons statis atau memanggil webhook.
Anda juga dapat menggunakan fungsi sistem untuk menetapkan parameter ke nilai yang dihasilkan secara dinamis.
Contohnya antara lain:
Menetapkan parameter
nowke waktu saat ini:Parameter Nilai sekarang $sys.func.NOW() Menambahkan parameter yang ada
countersebanyak 1:Parameter Nilai counter $sys.func.ADD($session.params.counter, 1) Menetapkan parameter
new-costke nilai parameterother-cost, sekaligus mempertahankan nilai objek gabungan penuh:Parameter Nilai new-cost $sys.func.IDENTITY($session.params.other-cost)
Alat penyimpanan data
Untuk mengetahui informasi selengkapnya tentang fitur ini, lihat dokumentasi alat penyimpanan data.
Setelan ucapan lanjutan
Setelan ucapan lanjutan ini dapat mengganti setelan ucapan halaman, setelan ucapan alur, dan setelan ucapan agen.
Antrean respons
Selama giliran agen, Anda dapat memanggil beberapa fulfillment, yang masing-masing dapat menghasilkan pesan respons. Dialogflow CX mengelola respons ini dalam antrean respons.
Respons sebagian untuk API streaming
Secara default, Dialogflow CX hanya mengirimkan respons yang diurutkan kepada pengguna akhir setelah giliran agen berakhir. Anda juga dapat mengaktifkan opsi Return partial response dalam fulfillment untuk menampilkan respons dalam antrean sebagai respons sebagian saat menggunakan API streaming. Untuk mempelajari lebih lanjut, lihat Siklus proses halaman.
Misalnya, jika webhook Anda kemungkinan akan berjalan lama, Anda dapat menambahkan respons statis dalam fulfillment dan mengaktifkan respons sebagian. Hal ini menyebabkan Dialogflow CX mengosongkan antrean respons dan mengirim semua pesan sebagai respons sebagian sebelum memanggil webhook.
Respons sebagian tidak didukung untuk hal berikut:
- Input audio di simulator.
- Integrasi telepon partner mungkin tidak mendukung respons sebagian. Lihat dokumentasi partner untuk memverifikasi.
Untuk menguji fitur ini di simulator, aktifkan respons sebagian.

Dalam contoh berikut, anggaplah webhook Anda memerlukan waktu 5 detik untuk menyelesaikan dan Anda tidak mengaktifkan respons sebagian. Giliran percakapan agen Dialogflow CX belum berakhir hingga webhook selesai. Selama giliran 5 detik ini, respons akan diantrekan saat menunggu webhook, dan tidak akan ditampilkan kepada pengguna akhir hingga giliran selesai. Hal ini menyebabkan pengalaman pengguna yang buruk.
Jika Anda mengaktifkan respons sebagian di fulfillment pertama, Dialogflow CX akan menampilkan pesan fulfillment pertama dengan cepat dan memanggil webhook. Setelah webhook selesai, Dialogflow CX akan menampilkan respons akhir. Skenario ini meningkatkan pengalaman pengguna akhir karena pengguna akhir diberi tahu untuk menunggu sebentar. Selain itu, panggilan webhook dijalankan secara serentak dengan respons yang dikirim ke pengguna akhir.
Bahasa Markup Sintesis Ucapan (SSML)
Anda dapat menggunakan Speech Synthesis Markup Language (SSML) di kolom fulfillment teks atau teks audio output. Dengan begitu, Anda dapat menyesuaikan respons audio dengan memberikan detail tentang jeda dan format audio untuk akronim, tanggal, waktu, singkatan, atau teks yang harus disensor.
Untuk mengetahui detail sintaksis, lihat Dokumentasi SSML Text-to-Speech.