Parameter

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

Parameter CX mirip dengan parameter ES, tetapi utilitas dan cakupannya telah diperluas, dan sintaksis untuk parameter referensi telah berubah.

Menentukan, mereferensikan, menetapkan, dan mendapatkan parameter

Ada empat cara umum menggunakan 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 suatu rute.
• Ditetapkan saat runtime: Saat runtime, layanan Dialogflow, layanan Anda yang memanggil API, dan layanan webhook Anda semuanya dapat menetapkan parameter value. Misalnya, layanan Dialogflow menetapkan nilai parameter intent saat input pengguna akhir cocok dengan intent, dan input tersebut berisi data parameter.
• Mendapatkan 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 Dialogflow akan 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 untuk nama parameter yang ditampilkan oleh Dialogflow.

Jenis-jenis parameter value

Nilai parameter mendukung beberapa jenis nilai. Bagian sesi di bawah ini menjelaskan cara mereferensikan setiap jenis parameter value. Jenis-jenis berikut didukung:

Jenis	Deskripsi
Skalar	Nilai numerik atau string tunggal.
Composite	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 Daftar Ada di bawah.

String kosong parameter dan nilai null

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

Anda dapat menetapkan parameter value apa pun ke null, yang menunjukkan bahwa parameter belum ditetapkan.

Nilai asli parameter

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

Semua jenis nilai untuk referensi parameter intent dapat merujuk ke nilai asli atau yang telah 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 cocok. Data berikut digunakan untuk menetapkan parameter intent:

• Name (juga dikenal sebagai ID atau Display Name): Nama yang mengidentifikasi parameter.
• Jenis Entitas: Jenis entity yang terkait dengan parameter.
• Adalah Daftar: Jika true, parameter akan diperlakukan sebagai daftar nilai.
• Menyamarkan log: Jika true (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.

Mereferensikan parameter intent

Catatan: Karena masa aktif nilai parameter intent 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 diselesaikan.

Guna 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 parameternya adalah date, Anda dapat mereferensikan nilai yang di-resolve sebagai $intent.params.date.resolved.

Menetapkan parameter intent

Jika input pengguna akhir cocok dengan intent saat runtime, parameter apa pun yang digunakan oleh anotasi untuk frasa pelatihan terkait akan disetel oleh Dialogflow.

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 nilai parameter intent. Lihat kolom respons queryResult.parameters pada metode detectIntent untuk jenis Session. Buka referensi Session API

Pilih protokol dan versi untuk Referensi sesi:

Protocol	V3	V3beta1
REST	Referensi sesi	Referensi 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

Webhook menerima nilai parameter intent. Lihat kolom intentInfo.parameters dalam 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 tersebut dalam urutan yang ditentukan pada halaman. Untuk setiap parameter formulir yang diperlukan, Anda juga menyediakan perintah yang digunakan agen untuk meminta informasi tersebut dari pengguna akhir. Proses ini disebut pengisian formulir.

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

Pengisian formulir CX mirip dengan pengisian slot ES.

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.
Diperlukan	Page.form.parameters[].required	Menunjukkan apakah parameter diperlukan. Parameter wajib 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 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 true (benar), parameter akan diperlakukan sebagai daftar nilai.
Samarkan dalam 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 prompt ulang	Page.form.parameters[].fillBehavior.repromptEventHandlers	Ini digunakan saat agen perlu meminta ulang pengguna akhir untuk mengisi parameter setelah upaya yang gagal. Lihat Pengendali permintaan ulang pengisian formulir. Jika tidak ada pengendali peristiwa permintaan ulang yang ditentukan, agen akan meminta ulang dengan perintah awal setelah upaya yang gagal.
DTMF [if necessary for clarity, see 'target cost-per-install']	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 .

Parameter formulir referensi

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

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

$page.params.status = "FINAL"

Untuk memeriksa apakah parameter formulir tertentu diisi pada belokan 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.

Parameter value default

Anda dapat memberikan nilai default untuk parameter formulir opsional. Saat pengisian formulir dimulai, semua parameter formulir opsional yang tidak disetel akan ditetapkan ke nilai defaultnya. Nilai-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 parameter value satu per satu, tetapi Anda harus menentukan perintah untuk setiap parameter yang diperlukan secara terpisah.

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

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

Catatan: Jika pengguna akhir memberikan beberapa parameter value dalam satu giliran percakapan selama pengisian formulir, biasanya hanya satu parameter formulir yang ditetapkan. Namun, jika parameter yang sama didefinisikan sebagai parameter intent dalam intent yang direferensikan dalam alur yang sama, Dialogflow dapat menetapkan beberapa parameter bentuk dalam satu giliran percakapan. Perilaku ini merupakan pengoptimalan NLU yang mungkin terjadi atau tidak terjadi selama percakapan, sehingga perilaku ini tidak boleh diandalkan.

Penerapan parameter sesi dan intent

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

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

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

Penerapan parameter sesi dan intent 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 nilai parameter formulir saat runtime. Preset parameter fulfillment akan mengganti parameter value, 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 pada metode detectIntent untuk jenis Session. Buka referensi Session API

Pilih protokol dan versi untuk Referensi sesi:

Protocol	V3	V3beta1
REST	Referensi sesi	Referensi 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

Webhook menerima nilai parameter formulir. Lihat kolom pageInfo.formInfo.parameterInfo dalam Permintaan webhook.

Pengendali permintaan ulang pengisian formulir

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

Jika tidak ada pengendali permintaan ulang yang ditentukan, perintah 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 permintaan ulang yang ditentukan untuk peristiwa ini akan dipanggil.

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

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

Parameter sesi

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

Parameter sesi referensi

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 dalam:

• Nilai header webhook untuk autentikasi.
• Permintaan webhook fleksibel, untuk mengirim parameter value 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.

Composite

• Untuk mengakses anggota parameter dengan jenis entity gabungan:

  $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 gabungan:

  $session.params.parameter-id.original

• Untuk mengakses objek lengkap parameter dengan jenis entity gabungan, 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 terisi ditulis ke sesi oleh Dialogflow.

Fulfillment untuk rute, pengendali peristiwa, atau permintaan 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 dalam respons webhook standar atau lihat respons webhook fleksibel.

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

Pilih protokol dan versi untuk Referensi sesi:

Protocol	V3	V3beta1
REST	Referensi sesi	Referensi 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 pada metode detectIntent untuk jenis Session. Buka referensi Session API

Pilih protokol dan versi untuk Referensi sesi:

Protocol	V3	V3beta1
REST	Referensi sesi	Referensi 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

Webhook menerima parameter value sesi. Lihat kolom sessionInfo.parameters dalam Permintaan webhook.

Propagasi parameter

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

• Jika parameter intent ditetapkan oleh pencocokan intent, parameter formulir bernama seperti untuk halaman aktif akan ditetapkan ke nilai yang sama. Jenis entity parameter ditentukan oleh definisi parameter intent.
• Jika parameter intent ditetapkan oleh pencocokan intent, atau parameter formulir ditetapkan saat mengisi formulir, parameter tersebut akan menjadi parameter sesi.

DTMF untuk integrasi telepon

Anda dapat mengaktifkan dan mengonfigurasi DTMF (Pensinyalan multi-frekuensi dual-tone) 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# diinterpretasikan sebagai dtmf_digits_123pound.

Ketika mencocokkan jenis entity untuk parameter, Dialogflow akan mencoba mencocokkan bentuk normal dan khusus DTMF. Saat jenis entitas digunakan untuk input DTMF, sebaiknya Anda menentukan sinonim seperti dtmf_digits_123 untuk meningkatkan pencocokan NLU.

Jika input DTMF tidak memenuhi kondisi penghentian (baik belum mencapai panjang digit maksimum atau belum dihentikan oleh digit akhir), agen Dialogflow 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 mencocokkannya 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 ucapan dan IVR agen jika Anda belum mengaktifkannya.
2. Buat parameter halaman.
3. Di panel parameter, aktifkan Enable DTMF.
4. Tetapkan Max digit ke jumlah digit maksimum yang dapat diberikan pengguna akhir untuk parameter ini.
5. Setel Digit finish ke nilai keypad yang akan menghentikan input DTMF untuk parameter. # adalah hal umum untuk setelan ini. Digit akhir tidak ditambahkan ke kueri Dialogflow pada agen, jadi jika digit akhir adalah # dan input adalah 123#, maka input kueri sebenarnya adalah '123'

Saat membuat agen, Anda dapat menguji input DTMF di simulator.

Parameter cakupan alur

Parameter cakupan flow dapat ditentukan sebagai preset parameter fulfillment atau parameter bentuk. Parameter ini hanya dapat direferensikan jika flow yang ditetapkan untuknya aktif, dan tidak dipertahankan dalam parameter sesi.

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

$flow.parameter-name

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

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

Contoh definisi parameter cakupan flow:

Masa aktif nilai parameter cakupan alur

Catatan: Jika Anda ingin memastikan bahwa parameter value dipertahankan selama sesi, Anda dapat menggunakan parameter sesi dengan lebih mudah.

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

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

• Saat flow A bertransisi ke flow B menggunakan target transisi tertentu, alur A (alur induk) tetap berada dalam tumpukan, flow A mempertahankan nilai parameter cakupan alurnya, dan instance baru alur B (alur turunan) akan ditambahkan ke stack.
• Saat alur turunan bertransisi kembali ke flow induk menggunakan target transisi simbolis (misalnya, END_FLOW), alur turunan dihapus dari tumpukan, semua parameter value dengan cakupan alur turunan akan dihapus, dan semua parameter value dengan cakupan alur induk 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 angkanya menunjukkan instance dari jenis alur tersebut. Dalam contoh ini, B1 dan B2 adalah instance flow B yang berbeda, 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. Flow B bertransisi ke instance baru flow A (A2) menggunakan target transisi tertentu.	Instance baru flow A (A2) di bagian atas stack tidak memiliki akses ke nilai parameter flow 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.	Flow B (B2) tidak mempertahankan parameter value yang ditetapkan saat flow aktif setelah transisi kedua (B1).

Parameter cakupan permintaan

Parameter cakupan permintaan adalah parameter berumur singkat yang dibuat oleh Dialogflow yang hanya dapat direferensikan selama siklus proses permintaan saat ini, dan tidak dipertahankan dalam parameter sesi.

Parameter cakupan permintaan dibuat oleh Dialogflow untuk fitur berikut.

Pemodelan bahasa

Anda dapat mengakses kode bahasa yang terkait dengan permintaan menggunakan:

Referensi	Deskripsi
$request.language	Kode bahasa yang ditentukan dalam QueryInput.language_code.
bahasa $request.resolved	Kode bahasa sebenarnya yang digunakan oleh agen selama pemrosesan. Bahasa yang diselesaikan dapat berbeda dari 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".

Payload Kustom

Jika QueryParameters.payload disetel, 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	Nomor	Nilai sentimen antara -1.0 (sentimen negatif) dan 1.0 (sentimen positif).
$request.sentiment.magnitude	Nomor	Menunjukkan kekuatan emosi secara keseluruhan (positif dan negatif) antara 0,0 dan +inf. Tidak seperti skor, magnitudo tidak dinormalisasi; setiap ekspresi emosi di dalam input pengguna akhir (baik positif maupun negatif) berkontribusi pada magnitudo input. Input yang lebih panjang dapat memiliki magnitudo yang lebih besar.
$request.sentiment.succeeded	Boolean	True jika analisis sentimen berhasil, false jika tidak.

Penyamaran parameter

Catatan: Saat ini, hanya nilai parameter teks yang 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 Dialogflow. Parameter yang disamarkan ditampilkan sebagai $parameter-name_redacted dalam log.

Misalnya, pertimbangkan input pengguna akhir berupa "Alamat saya adalah 1600 Amphitheatre Parkway" yang menyebabkan parameter address dikirim ke "1600 Amphitheatre Parkway". Teks yang dicatat dalam log akan berupa "Alamat saya adalah $address_red sela".

Untuk mengaktifkan penyamaran parameter:

Konsol

Centang kotak Samarkan log saat membuat atau memperbarui parameter.

API

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

Pilih protokol dan versi untuk referensi Intent:

Protocol	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 benar untuk jenis Page. Buka referensi Page API

Pilih protokol dan versi untuk Referensi halaman:

Protocol	V3	V3beta1
REST	Resource halaman	Resource 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

Sebagai alternatif, Anda dapat menyamarkan semua parameter dari jenis entity tertentu.