Playbook dapat menerima dan memunculkan informasi konteks menggunakan parameter yang ditentukan secara eksplisit. Parameter digunakan untuk menyimpan informasi tentang percakapan seperti pilihan pengguna, hasil tindakan, dan sebagainya. Anda dapat meneruskan nilai parameter ini di antara playbook dan alur Dialogflow CX.
Pernyataan parameter
Anda dapat menentukan parameter input dan parameter output.
Saat menggunakan Agen Vertex AI, Anda dapat menentukan parameter di halaman editor agen.
Saat menggunakan Dialogflow CX, parameter akan ditetapkan per playbook menggunakan tab Parameters setelah Anda membuat playbook.
Parameter memiliki nama, deskripsi, dan salah satu jenis berikut:
- String
- Nomor
- Boolean
- Jenis parameter khusus alat
Anda juga dapat menentukan apakah parameter berupa daftar.
Parameter input
Dengan parameter input, playbook dapat menggunakan nilai yang diteruskan dari alur dan playbook lainnya. Misalnya, playbook dapat menerima nama pilihan pengguna sebagai parameter dan menggunakannya untuk berterima kasih kepada pengguna secara pribadi, atau dapat menerima ID pesanan sebagai parameter dan menggunakannya untuk mengambil detail pesanan menggunakan alat.
Parameter input ditentukan per playbook, dan playbook tidak memiliki visibilitas jenis parameter Dialogflow CX lainnya secara default. Saat alur Dialogflow CX bertransisi ke playbook, parameter halaman dan sesi akan disebarkan ke playbook jika playbook target memiliki parameter input dengan nama yang sama. Untuk menyampaikan informasi dari alur ke playbook selama transisi, tentukan parameter input playbook dengan nama yang sama dengan parameter sesi atau halaman yang ada sebelum transisi.
Buat contoh untuk mengontrol pengaruh nilai parameter input terhadap tindakan. Misalnya, jika parameter input harus memengaruhi cara agen merujuk kepada pengguna, buat contoh yang menentukan nilai untuk parameter tersebut, lalu gunakan nilai yang sama dalam tindakan ucapan dalam contoh. Lihat parameter penerusan untuk mengetahui detailnya.
Parameter output
Parameter output memungkinkan playbook memunculkan informasi yang akan digunakan oleh alur atau playbook lainnya. Misalnya, playbook dapat mengumpulkan nomor pesanan dari pengguna dan memunculkannya melalui parameter output, atau playbook dapat menggunakan alat untuk memesan penerbangan dan memunculkan nomor konfirmasi melalui parameter output.
Buat contoh untuk mengontrol cara playbook menentukan nilai untuk setiap parameter output. Misalnya, jika parameter output yang merepresentasikan nomor konfirmasi harus memperoleh nilainya dari output penggunaan alat, buat contoh jika output penggunaan alat tersebut cocok dengan nilai parameter output playbook.
Meneruskan parameter
Tidak seperti flow, Playbook tidak mendukung penyisipan parameter value dengan sintaksis tertentu. Sebagai gantinya, playbook mengandalkan petunjuk dan contoh beberapa perintah untuk menentukan cara penggunaan parameter value, dan cara memutuskan nilai saat menentukan parameter value.
Pertimbangkan agen yang dirancang untuk penjualan tiket acara dengan playbook berikut:
- Playbook bernama
Ticket ordering
yang melakukan pemesanan menggunakan alat bernamaTicket sales API
.- Playbook ini menerima parameter input dengan jenis
number
dan namaevent_id
. - Alat
Ticket sales API
mengharapkan permintaan yang menyertakanevent_id
.
- Playbook ini menerima parameter input dengan jenis
- Playbook bernama
Event selection
yang membantu pengguna memilih acara, lalu mengarahkan mereka keTicket ordering
dengan parameterevent_id
untuk membeli tiket.
Dalam contoh ini, untuk memastikan bahwa event_id
dapat diteruskan dengan andal dari
Event selection
ke Ticket ordering
dan dari Ticket ordering
ke
Ticket sales API
, diperlukan beberapa
contoh.
Playbook Ticket ordering
harus menyertakan beberapa contoh yang:
- Memiliki parameter input
event_id
yang ditentukan dengan beberapa nilai realistis yang berbeda di setiap contoh. - Sertakan tindakan penggunaan alat dengan isi permintaan yang menyertakan nilai
event_id
realistis yang sama seperti yang ditetapkan dalam parameter input.
Playbook Event selection
harus menyertakan beberapa contoh yang:
- Sertakan ucapan pengguna saat pengguna memilih peristiwa dengan beberapa
event_id
realistis, yang berbeda di setiap contoh. - Sertakan pemanggilan playbook
Ticket ordering
yang menetapkan parameterevent_id
keevent_id
realistis yang sama seperti yang ditentukan oleh pemilihan pengguna.
Selain menambahkan contoh, coba tambahkan petunjuk spesifik ke instructions, sasaran, atau detail alat yang menjelaskan cara penggunaan parameter. Misalnya,
playbook Ticket ordering
menyertakan petunjuk berikut:
- Use parameter event_id to send a buy_tickets request with ${TOOL: Ticket sales API}
Dengan adanya contoh dan petunjuk yang dijelaskan, playbook Event selection
menentukan event_id
dengan benar berdasarkan pilihan pengguna, dan
meneruskannya sebagai parameter input bernama event_id
ke
Ticket ordering playbook
. Kemudian, Ticket ordering
akan meneruskan event_id
yang sama
dalam isi permintaan ke Ticket sales API
. Playbook bergantung pada contoh
dengan parameter value yang berbeda untuk membantu menyimpulkan bagaimana parameter harus digunakan.