Parameter

Parameter digunakan untuk mengambil dan mereferensikan nilai yang telah disediakan oleh pengguna akhir selama sesi. Setiap parameter memiliki nama dan jenis entity. Tidak seperti input pengguna akhir mentah, parameter adalah data terstruktur yang dapat dengan mudah digunakan untuk menjalankan beberapa logika atau menghasilkan respons.

Menentukan, mereferensikan, menetapkan, dan mendapatkan parameter

Ada empat cara umum penggunaan parameter:

• Menentukan pada waktu desain: Selama waktu desain, Anda menggunakan konsol atau API untuk menentukan parameter. Misalnya, Anda dapat menentukan parameter intent dan menggunakannya dalam frasa pelatihan untuk menunjukkan input pengguna akhir yang harus diekstrak.
• Referensi pada waktu desain: Referensi parameter adalah variabel yang menyimpan parameter value yang akan diekstrak saat runtime. Selama waktu desain, Anda menggunakan konsol atau API untuk mereferensikan parameter dalam berbagai jenis data. Misalnya, Anda dapat mereferensikan parameter sesi dalam respons fulfillment statis untuk rute.
• Ditetapkan saat runtime: Saat runtime, layanan Agen Percakapan (Dialogflow CX), layanan Anda yang memanggil API, dan layanan webhook Anda semuanya dapat menetapkan nilai parameter. Misalnya, layanan Agen Percakapan (Dialogflow CX) menetapkan nilai parameter intent saat input pengguna akhir cocok dengan intent, dan input tersebut berisi data parameter.
• Dapatkan saat runtime: Saat runtime, referensi parameter Anda berisi parameter value yang telah ditetapkan, dan Anda dapat menggunakan API atau webhook untuk mendapatkan parameter value. Misalnya, saat intent cocok dan webhook Anda dipanggil, layanan webhook Anda akan menerima parameter value untuk intent tersebut.

Penamaan parameter

Aturan berikut berlaku untuk penamaan parameter:

• Gunakan karakter berikut: [A-Z], [a-z], [0-9], ., -, _
• Nama parameter tidak peka huruf besar/kecil, sehingga Agen Percakapan (Dialogflow CX) memperlakukan Apple dan apple sebagai parameter yang sama. Kode klien webhook dan API juga harus memperlakukan nama parameter sebagai tidak peka huruf besar/kecil, karena tidak ada jaminan huruf besar/kecil untuk nama parameter yang ditampilkan oleh Agen Percakapan (Dialogflow CX).
• Saat Anda membuat parameter dengan ID atau nama tampilan yang sama dalam intent atau formulir yang berbeda, pastikan jenis entitas dan setelan lainnya sama untuk semua definisi. Jika jenis entitas atau setelan parameter lainnya berbeda, gunakan ID parameter atau nama tampilan unik untuk setiap definisi.

Jenis parameter value

Nilai parameter mendukung beberapa jenis nilai. Bagian sesi di bawah menjelaskan cara mereferensikan setiap jenis nilai parameter. Berikut adalah jenis-jenis yang didukung:

Jenis	Deskripsi
Skalar	Satu nilai numerik atau string.
Komposit	Objek JSON yang diisi dengan mencocokkan entitas gabungan, atau dengan mengisi parameter intent, yang berisi kolom original dan resolved.
Daftar	Daftar nilai skalar atau gabungan yang diisi untuk parameter yang dikonfigurasi sebagai daftar. Lihat opsi Is List di bawah.

String kosong dan nilai null parameter

Anda dapat menetapkan nilai parameter string ke "", yang menetapkan parameter ke string kosong.

Anda dapat menetapkan nilai parameter ke null, yang menunjukkan bahwa parameter belum ditetapkan.

Nilai asli parameter

Saat teks dicocokkan dengan entity tertentu saat runtime, teks tersebut sering kali di-resolve ke nilai yang lebih mudah untuk diproses. Misalnya, kata "apel" dalam input pengguna akhir dapat di-resolve sebagai "apple" untuk entitas buah.

Semua jenis nilai untuk referensi parameter intent dapat mereferensikan nilai asli atau yang di-resolve.

Hanya jenis nilai gabungan untuk referensi parameter sesi yang dapat mereferensikan nilai asli.

Parameter intent

Intent menggunakan parameter untuk mengekstrak data yang disediakan oleh pengguna akhir saat intent dicocokkan. Data berikut digunakan untuk menentukan parameter intent:

• Nama (juga dikenal sebagai ID atau Nama Tampilan): Nama yang mengidentifikasi parameter.
• Jenis Entity: Jenis entity yang terkait dengan parameter.
• Is List: Jika benar, parameter akan diperlakukan sebagai daftar nilai.
• Samarkan dalam log: Jika benar, data parameter yang disediakan pengguna akhir akan disamarkan.

Menentukan parameter intent

Parameter intent ditentukan pada waktu desain saat membuat data intent atau saat menganotasi frasa pelatihan.

Referensi parameter intent

Catatan: Karena nilai parameter intent memiliki masa aktif yang singkat, sebaiknya gunakan referensi parameter sesi bukan referensi parameter intent.

Referensi parameter intent dapat digunakan dalam pesan respons fulfillment statis dari rute intent.

Anda dapat mereferensikan nilai asli atau nilai yang di-resolve.

Untuk mereferensikan parameter untuk intent yang saat ini cocok, gunakan salah satu format berikut:

$intent.params.parameter-id.original
$intent.params.parameter-id.resolved

Misalnya, jika ID parameter adalah date, Anda dapat mereferensikan nilai yang di-resolve sebagai $intent.params.date.resolved.

Menetapkan parameter intent

Saat input pengguna akhir cocok dengan intent saat runtime, parameter apa pun yang digunakan oleh anotasi untuk frasa pelatihan terkait akan ditetapkan oleh Agen Percakapan (Dialogflow CX).

Fulfillment untuk rute intent dapat menggunakan preset parameter fulfillment untuk menetapkan nilai parameter intent saat runtime.

Mendapatkan parameter intent

Selama giliran percakapan saat intent dicocokkan, kode Anda dapat mengakses parameter value intent.

Interaksi dengan API akan menampilkan parameter value intent. Lihat kolom respons queryResult.parameters metode detectIntent untuk jenis Session. Buka referensi Session API

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

Tutup

Nilai parameter intent terima webhook. Lihat kolom intentInfo.parameters di permintaan Webhook.

Parameter formulir

Untuk setiap halaman, Anda dapat menentukan formulir, yang merupakan daftar parameter yang harus dikumpulkan dari pengguna akhir untuk halaman tersebut. Agen berinteraksi dengan pengguna akhir untuk beberapa giliran percakapan, hingga mengumpulkan semua parameter formulir yang diperlukan, yang juga dikenal sebagai parameter halaman. Agen mengumpulkan parameter ini dalam urutan yang ditentukan di halaman. Untuk setiap parameter formulir yang diperlukan, Anda juga memberikan perintah yang digunakan agen untuk meminta informasi tersebut dari pengguna akhir. Proses ini disebut pengisian formulir.

Misalnya, Anda dapat membuat formulir yang mengumpulkan nama pengguna akhir dan nomor telepon untuk halaman Collect Customer Info.

Data berikut digunakan untuk menentukan parameter formulir:

Nama opsi konsol	Rantai kolom API	Deskripsi
Nama tampilan	Page.form.parameters[].displayName	Nama yang mengidentifikasi parameter.
Jenis entitas	Page.form.parameters[].entityType	Jenis entity yang terkait dengan parameter.
Wajib	Page.form.parameters[].required	Menunjukkan apakah parameter diperlukan. Parameter yang diperlukan harus diisi sebelum pengisian formulir selesai, dan agen akan meminta nilai kepada pengguna akhir. Lihat bagian Menetapkan parameter formulir di bawah untuk mengetahui detailnya.
Nilai Default (hanya terlihat jika Wajib tidak dicentang)	Page.form.parameters[].defaultValue	Nilai default parameter opsional. Lihat bagian Menetapkan parameter formulir di bawah untuk mengetahui detailnya.
Adalah daftar	Page.form.parameters[].isList	Jika benar, parameter akan diperlakukan sebagai daftar nilai.
Menyamarkan di log	Page.form.parameters[].redact	Jika benar, data parameter yang disediakan pengguna akhir akan disamarkan.
Fulfillment perintah awal	Page.form.parameters[].fillBehavior.initialPromptFulfillment	Perintah awal dalam bentuk fulfillment untuk meminta nilai parameter yang diperlukan dari pengguna akhir. Lihat bagian Menetapkan parameter formulir di bawah untuk mengetahui detailnya.
Pengendali peristiwa permintaan ulang	Page.form.parameters[].fillBehavior.repromptEventHandlers	Ini digunakan saat agen perlu meminta ulang pengguna akhir untuk mengisi parameter setelah upaya gagal. Lihat Pemroses permintaan ulang pengisian formulir. Jika tidak ada pengendali peristiwa perintah ulang yang ditentukan, agen akan meminta ulang dengan perintah awal setelah upaya gagal.
DTMF	Tidak tersedia	Lihat bagian DTMF di bawah.

Menentukan dan mengelola parameter formulir

Parameter formulir ditentukan pada waktu desain saat membuat halaman.

Untuk mengubah urutan parameter formulir dengan konsol, klik judul bagian Parameters di halaman, lalu tarik baris parameter di tabel parameter.

Untuk menghapus parameter formulir, klik judul bagian Parameters di halaman, arahkan kursor ke parameter, lalu klik tombol hapus .

Referensi parameter formulir

Referensi parameter formulir tidak digunakan secara langsung. Anda hanya dapat memeriksa status pengisian setiap parameter formulir atau formulir secara keseluruhan. Anda dapat menggunakan referensi status formulir ini dalam persyaratan kondisi dari rute kondisi.

Untuk memeriksa apakah formulir lengkap halaman saat ini telah diisi, gunakan kondisi berikut:

$page.params.status = "FINAL"

Untuk memeriksa apakah parameter formulir tertentu diisi pada giliran terakhir, gunakan kondisi berikut:

$page.params.parameter-id.status = "UPDATED"

Menetapkan parameter formulir

Nilai parameter formulir dapat ditetapkan dengan berbagai cara. Subbagian berikut menjelaskan setiap mekanisme untuk menetapkan nilai parameter formulir.

Nilai parameter default

Anda dapat memberikan nilai default untuk parameter formulir opsional. Saat pengisian formulir dimulai, semua parameter formulir opsional yang tidak ditetapkan akan ditetapkan ke nilai defaultnya. Nilai ini dapat diinisialisasi atau diganti oleh beberapa mekanisme di bawah.

Jika parameter diperlukan, nilai defaultnya akan diabaikan.

Pengisian formulir

Catatan: Anda dapat menentukan fulfillment entri halaman untuk memberi tahu pengguna akhir bahwa Anda akan mengumpulkan nilai parameter satu per satu, tetapi Anda perlu menentukan perintah untuk setiap parameter yang diperlukan secara terpisah.

Agen Percakapan (Dialogflow CX) secara otomatis menetapkan parameter value yang diberikan oleh pengguna akhir selama pengisian formulir. Agen mengumpulkan parameter yang diperlukan dalam urutan yang ditentukan di halaman. Agen meminta pengguna akhir untuk memasukkan nilai yang diperlukan menggunakan fulfillment perintah awal yang Anda berikan untuk setiap parameter yang diperlukan. Parameter opsional tidak akan memicu perintah.

Jika nilai parameter yang diperlukan tidak diberikan oleh pengguna akhir setelah perintah agen, perintah awal akan diulang kecuali jika perilaku yang berbeda ditentukan dalam pengendali perintah ulang. Jika ada beberapa perintah teks awal yang ditentukan, perilaku agen akan sama dengan perilaku untuk respons teks fulfillment.

Catatan: Jika pengguna akhir memberikan beberapa nilai parameter dalam satu giliran percakapan selama pengisian formulir, biasanya hanya satu parameter formulir yang ditetapkan. Namun, jika parameter yang sama ditentukan sebagai parameter intent dalam intent yang dirujuk dalam alur yang sama, Agen Percakapan (Dialogflow CX) dapat menetapkan beberapa parameter formulir dalam satu giliran percakapan. Perilaku ini adalah pengoptimalan NLU yang mungkin terjadi atau tidak selama percakapan, sehingga perilaku ini tidak boleh diandalkan.

Penerusan parameter sesi dan intent

Saat parameter dari jenis apa pun ditetapkan saat runtime, parameter tersebut akan ditulis ke sesi dan menjadi parameter sesi.

Saat halaman pertama kali menjadi aktif, dan selama periode aktifnya, parameter formulir apa pun dengan nama yang sama seperti parameter sesi akan otomatis ditetapkan ke nilai parameter sesi.

Hal ini dapat terjadi dengan parameter intent yang cocok di rute intent atau penyebaran parameter.

Penyebaran parameter intent dan sesi adalah satu-satunya mekanisme untuk menetapkan parameter formulir opsional ke nilai dari input pengguna akhir, tetapi mekanisme ini juga dapat menetapkan atau mengganti nilai parameter formulir yang diperlukan.

Preset parameter fulfillment

Fulfillment untuk rute, pengendali peristiwa, atau permintaan ulang formulir dapat menggunakan preset parameter fulfillment untuk menetapkan parameter value formulir saat runtime. Setelan default parameter fulfillment akan mengganti nilai parameter, termasuk nilai default parameter.

Setelan parameter webhook

Webhook Anda dapat menetapkan nilai parameter formulir saat runtime. Lihat kolom pageInfo.formInfo.parameterInfo di respons Webhook.

Mendapatkan parameter formulir

Interaksi dengan API akan menampilkan nilai parameter formulir. Lihat kolom respons queryResult.parameters metode detectIntent untuk jenis Session. Buka referensi Session API

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

Tutup

Nilai parameter formulir penerimaan webhook. Lihat kolom pageInfo.formInfo.parameterInfo di permintaan Webhook.

Pengendali perintah ulang pengisian formulir

Pengendali permintaan ulang, yang juga dikenal sebagai pengendali peristiwa tingkat parameter, digunakan untuk menentukan perilaku perintah parameter yang kompleks untuk parameter yang diperlukan. Misalnya, pengendali permintaan ulang dapat digunakan untuk mengubah perintah saat pengguna akhir gagal memberikan nilai setelah perintah awal, dan untuk bertransisi ke halaman lain setelah N upaya gagal.

Jika tidak ada pengendali permintaan ulang yang ditentukan, permintaan awal akan digunakan untuk meminta ulang pengguna akhir sesuai kebutuhan.

Jika pengguna akhir merespons dengan input yang tidak terduga, peristiwa sys.no-match-* atau sys.no-input-* akan dipanggil, dan pengendali perintah ulang yang ditentukan untuk peristiwa ini akan dipanggil.

Seperti pengendali peristiwa lainnya, pengendali perintah ulang adalah jenis pengendali status yang dapat dikonfigurasi dengan satu atau kedua hal berikut:

• Fulfillment untuk memberikan pesan perintah ulang pengguna akhir dan/atau preset parameter.
• Target transisi untuk mengubah halaman saat ini.

Parameter sesi

Saat parameter dari jenis apa pun ditetapkan saat runtime, parameter tersebut akan ditulis ke sesi dan menjadi parameter sesi. Parameter ini tidak ditentukan secara eksplisit pada waktu desain. Anda dapat mereferensikan parameter sesi ini kapan saja selama sesi.

Referensi parameter sesi

Referensi parameter sesi dapat digunakan dalam pesan respons statis untuk jenis fulfillment berikut:

• Fulfillment entri halaman
• Pemenuhan rute
• Fulfillment pengendali peristiwa
• Fulfillment perintah formulir
• Fulfillment permintaan ulang formulir

Referensi juga dapat digunakan di:

• Nilai header webhook untuk autentikasi.
• Permintaan webhook fleksibel, untuk mengirim nilai parameter ke webhook.

Untuk mereferensikan parameter sesi, gunakan format berikut:

Skalar

Untuk mengakses parameter dengan jenis entity skalar:

$session.params.parameter-id

Misalnya, jika ID parameter adalah date, Anda dapat mereferensikan nilai sebagai $session.params.date.

Komposit

• Untuk mengakses anggota parameter dengan jenis entity komposit:

  $session.params.parameter-id.member-name

  Misalnya, jika ID parameter adalah location, Anda dapat mereferensikan nilai anggota zip-code sebagai $session.params.location.zip-code.

• Untuk mengakses nilai asli parameter dengan jenis entity komposit:

  $session.params.parameter-id.original

• Untuk mengakses objek lengkap parameter dengan jenis entity komposit, gunakan fungsi sistem IDENTITY.

Daftar

• Untuk mengakses daftar lengkap elemen:

  $session.params.parameter-id

  Misalnya, jika ID parameter daftar adalah colors dan nilai yang diekstrak dari kueri pengguna adalah ["red", "blue", "yellow"], Anda dapat mereferensikan semua nilai sebagai $session.params.colors.

• Untuk mengakses elemen ke-i dari parameter daftar:

  $session.params.parameter-id[i]

  Misalnya, jika ID parameter daftar adalah colors, Anda dapat mereferensikan nilai pertama sebagai $session.params.colors[0].

Menetapkan parameter sesi

Saat pengisian formulir selesai, parameter yang diisi akan ditulis ke sesi oleh Agen Percakapan (Dialogflow CX).

Fulfillment untuk rute, pengendali peristiwa, atau perintah ulang formulir dapat menggunakan preset parameter fulfillment untuk menetapkan nilai parameter sesi saat runtime.

Webhook Anda dapat menetapkan nilai parameter sesi saat runtime. Lihat kolom sessionInfo.parameters di respons webhook standar atau lihat respons webhook fleksibel.

Interaksi dengan API dapat menetapkan parameter value sesi. Lihat kolom permintaan queryParams.parameters metode detectIntent untuk jenis Session. Buka referensi Session API

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

Tutup

Mendapatkan parameter sesi

Interaksi dengan API akan menampilkan nilai parameter sesi. Lihat kolom respons queryResult.parameters metode detectIntent untuk jenis Session. Buka referensi Session API

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

Tutup

Nilai parameter sesi penerimaan webhook. Lihat kolom sessionInfo.parameters di permintaan Webhook.

Penerusan parameter

Saat input pengguna akhir memberikan parameter value, parameter tersebut dapat disebarkan ke tingkat lain:

• Saat parameter intent ditetapkan oleh kecocokan intent, parameter formulir dengan nama yang sama untuk halaman aktif ditetapkan ke nilai yang sama. Jenis entity parameter ditentukan oleh definisi parameter intent.
• Jika parameter intent ditetapkan oleh kecocokan intent, atau parameter formulir ditetapkan saat mengisi formulir, parameter tersebut akan menjadi parameter sesi.

DTMF untuk integrasi telepon

Anda dapat mengaktifkan dan mengonfigurasi DTMF (Sinyal nada ganda multi-frekuensi) untuk parameter. Setelah diaktifkan, pengguna akhir untuk agen yang menggunakan integrasi telepon dapat menggunakan keypad telepon untuk memberikan parameter value.

Untuk mengurangi ambiguitas, input DTMF dapat ditafsirkan dalam bentuk normal dan khusus DTMF (direkomendasikan):

• Bentuk normal hanyalah nilai keypad seperti yang dimasukkan oleh pengguna akhir. Misalnya, 123#.
• Formulir khusus DTMF mengonversi input menjadi dtmf_digits_[digits], dengan [digits] adalah digit DTMF asli dengan * diganti dengan star dan # diganti dengan pound. Misalnya, 123# ditafsirkan sebagai dtmf_digits_123pound.

Saat mencocokkan jenis entitas untuk parameter, Agen Percakapan (Dialogflow CX) akan mencoba mencocokkan formulir normal dan khusus DTMF. Jika jenis entity digunakan untuk input DTMF, sebaiknya tentukan sinonim seperti dtmf_digits_123 untuk meningkatkan pencocokan NLU.

Jika input DTMF tidak memenuhi kondisi penghentian (belum mencapai panjang digit maksimum atau belum dihentikan oleh digit selesai), agen Agen Percakapan (Dialogflow CX) akan terus menunggu input lainnya. Selama periode ini, jika waktu tunggu tanpa ucapan dipicu, agen akan memanggil peristiwa tanpa input. Jika hanya ucapan ucapan yang terdeteksi, agen akan cocok dengan input ucapan. Jika input ucapan dan DTMF terdeteksi, input ucapan akan dihapus dan hanya input DTMF yang dipertimbangkan.

Untuk mengaktifkan dan menyesuaikan DTMF untuk parameter:

Konsol

1. Aktifkan Setelan lanjutan dari setelan IVR dan ucapan agen jika Anda belum mengaktifkannya.
2. Buat parameter halaman.
3. Di panel parameter, aktifkan Enable DTMF.
4. Tetapkan Max digits ke jumlah maksimum digit yang dapat diberikan pengguna akhir untuk parameter ini.
5. Tetapkan Finish digit ke nilai keypad yang akan menghentikan input DTMF untuk parameter. Penggunaan # untuk setelan ini sudah umum. Digit akhir tidak ditambahkan ke kueri Agen Percakapan (Dialogflow CX) di agen, jadi jika digit akhir adalah # dan inputnya adalah 123#, input kueri yang sebenarnya akan menjadi '123'

Saat mem-build agen, Anda dapat menguji input DTMF di simulator.

Endpointing cerdas

Jika smart endpointing diaktifkan untuk agen, Anda dapat menyesuaikan perilaku smart endpointing untuk parameter numerik.

1. Tetapkan Minimum digits untuk memberi petunjuk kepada smart endpointer untuk menunggu hingga semua digit dikumpulkan.
2. Tetapkan Perbaiki transkrip untuk meningkatkan pengenalan ucapan angka dengan memperbaiki error transkripsi angka umum. Hal ini hanya didukung untuk permintaan yang menentukan kode bahasa en atau en-*.
3. Tetapkan Waktu tunggu untuk menentukan waktu tambahan yang akan ditunggu Agen Percakapan (Dialogflow CX) hingga pengguna memberikan input lainnya.

Parameter cakupan flow

Parameter cakupan alur dapat ditentukan sebagai preset parameter fulfillment atau parameter formulir. Parameter ini hanya dapat direferensikan saat alur yang menentukannya aktif, dan tidak dipertahankan ke dalam parameter sesi.

Untuk menentukan atau mereferensikan parameter cakupan alur, gunakan sintaksis berikut:

$flow.parameter-name

Misalnya, jika nama parameternya adalah date, Anda dapat menentukan atau mereferensikan parameter sebagai $flow.date.

Perhatikan bahwa penggunaan awalan $ saat menentukan parameter berbeda dengan jenis parameter lain yang tidak menggunakan $ untuk definisi parameter.

Contoh definisi parameter cakupan alur:

Masa berlaku parameter value cakupan flow

Catatan: Jika Anda ingin memastikan bahwa nilai parameter dipertahankan selama sesi, akan lebih mudah untuk menggunakan parameter sesi.

Hal ini jarang terjadi, tetapi dalam kasus lanjutan tertentu, Anda mungkin perlu memahami cara nilai parameter cakupan alur dipertahankan (atau dihapus) saat alur menjadi tidak aktif, lalu aktif kembali.

Apakah parameter value cakupan flow dipertahankan saat flow menjadi tidak aktif, lalu aktif kembali bergantung pada stack flow dan instance flow di stack.

• Saat alur A bertransisi ke alur B menggunakan target transisi tertentu, alur A (alur induk) tetap berada di stack, alur A mempertahankan nilai parameter cakupan alurnya, dan instance baru alur B (alur turunan) ditambahkan ke stack.
• Saat alur turunan bertransisi kembali ke alur induk menggunakan target transisi simbolis (misalnya, END_FLOW), alur turunan akan dihapus dari stack, semua nilai parameter cakupan alur turunan akan dihapus, dan semua nilai parameter cakupan alur induk akan dipertahankan.
• Dengan menggunakan serangkaian transisi dengan target transisi tertentu, stack alur dapat berisi beberapa instance dari satu jenis alur. Setiap instance jenis alur memiliki nilai parameter cakupan alur yang unik. Misalnya: A1 -> B1 -> C1 -> B2, dengan A, B, dan C adalah jenis alur, dan angka menunjukkan instance jenis alur tersebut. Dalam contoh ini, B1 dan B2 adalah instance yang berbeda dari alur B, dan memiliki parameter cakupan alur yang unik.

Contoh:

Transisi	Hasil
Alur A (A1) menjadi aktif. Alur B (B1) menjadi aktif menggunakan target transisi tertentu. Flow B bertransisi kembali ke flow A (A1) yang memulainya menggunakan target transisi simbolis.	Alur A mempertahankan nilai parameter.
Alur A (A1) menjadi aktif. Alur B (B1) menjadi aktif menggunakan target transisi tertentu. Alur B bertransisi ke instance baru alur A (A2) menggunakan target transisi tertentu.	Instance baru alur A (A2) di bagian atas stack tidak memiliki akses ke nilai parameter alur A (A1) di bagian bawah stack.
Alur A (A1) menjadi aktif. Alur B (B1) menjadi aktif menggunakan target transisi tertentu. Alur A (A1) menjadi aktif menggunakan target transisi simbolis. Alur B (B2) menjadi aktif menggunakan target transisi tertentu.	Alur B (B2) tidak mempertahankan nilai parameter yang ditetapkan saat aktif setelah transisi kedua (B1).

Parameter cakupan permintaan

Parameter cakupan permintaan adalah parameter berumur pendek yang dibuat oleh Agen Percakapan (Dialogflow CX) yang hanya dapat direferensikan selama siklus proses permintaan saat ini, dan tidak dipertahankan ke dalam parameter sesi.

Parameter cakupan permintaan dibuat oleh Agen Percakapan (Dialogflow CX) untuk fitur berikut.

Parameter bawaan

Anda dapat mengakses berbagai data yang terkait dengan permintaan menggunakan:

Referensi	Deskripsi
$request.agent-id	ID agen.
$request.session-id	ID sesi.
$request.language	Kode bahasa yang ditentukan di QueryInput.language_code.
$request.resolved-language	Kode bahasa sebenarnya yang digunakan oleh agen selama pemrosesan. Bahasa yang di-resolve dapat berbeda dengan bahasa yang ditentukan dalam permintaan. Misalnya, jika agen hanya mendukung "en", sedangkan bahasa yang ditentukan dalam permintaan adalah "en-US", bahasa yang di-resolve adalah "en".
$request.user-utterance	Ucapan pengguna saat ini yang ditentukan dalam permintaan.
$request.last-agent-utterance	Ucapan terbaru yang dikirim oleh agen.

Payload Kustom

Jika QueryParameters.payload ditetapkan, Anda dapat mengakses parameter yang sesuai melalui $request.payload.param-id.

Analisis Sentimen

Referensi sentimen berikut tersedia saat analisis sentimen diaktifkan:

Referensi	Jenis	Deskripsi
$request.sentiment.score	Angka	Skor sentimen antara -1,0 (sentimen negatif) dan 1,0 (sentimen positif).
$request.sentiment.magnitude	Angka	Menunjukkan kekuatan emosi secara keseluruhan (baik positif maupun negatif) antara 0,0 dan +inf. Tidak seperti skor, magnitudo tidak dinormalisasi; setiap ekspresi emosi dalam input pengguna akhir (baik positif maupun negatif) berkontribusi pada magnitudo input. Input yang lebih panjang mungkin memiliki magnitudo yang lebih besar.
$request.sentiment.succeeded	Boolean	Benar jika analisis sentimen berhasil, salah jika tidak.

Penyamaran parameter

Catatan: Saat ini, hanya input pengguna teks yang dapat disamarkan.

Untuk parameter intent atau formulir apa pun, Anda dapat mengaktifkan penyamaran parameter, yang akan menyamarkan data parameter runtime pengguna akhir dari log dan penyimpanan internal Agen Percakapan (Dialogflow CX). Parameter yang disamarkan ditampilkan sebagai $parameter-name_redacted dalam log.

Misalnya, pertimbangkan input pengguna akhir "Alamat saya adalah 1600 Amphitheatre Parkway" yang menghasilkan parameter address yang dikirim ke "1600 Amphitheatre Parkway". Teks yang dicatat ke dalam log akan menjadi "Alamat saya adalah $address_redacted".

Untuk mengaktifkan penyamaran parameter:

Konsol

Centang kotak Samarkan di log saat membuat atau memperbarui parameter.

API

Tetapkan kolom parameters[].redact ke true untuk jenis Intent. Buka referensi Intent API

Pilih protokol dan versi untuk referensi Intent:

Protokol	V3	V3beta1
REST	Resource intent	Resource intent
RPC	Antarmuka intent	Antarmuka intent
C++	IntentsClient	Tidak tersedia
C#	IntentsClient	Tidak tersedia
Go	IntentsClient	Tidak tersedia
Java	IntentsClient	IntentsClient
Node.js	IntentsClient	IntentsClient
PHP	Tidak tersedia	Tidak tersedia
Python	IntentsClient	IntentsClient
Ruby	Tidak tersedia	Tidak tersedia

Tutup

Tetapkan kolom form.parameters[].redact ke true untuk jenis Page. Buka referensi Page API

Pilih protokol dan versi untuk Referensi halaman:

Protokol	V3	V3beta1
REST	Referensi halaman	Referensi halaman
RPC	Antarmuka halaman	Antarmuka halaman
C++	PagesClient	Tidak tersedia
C#	PagesClient	Tidak tersedia
Go	PagesClient	Tidak tersedia
Java	PagesClient	PagesClient
Node.js	PagesClient	PagesClient
PHP	Tidak tersedia	Tidak tersedia
Python	PagesClient	PagesClient
Ruby	Tidak tersedia	Tidak tersedia

Tutup

Atau, Anda dapat menyembunyikan semua parameter jenis entity tertentu.