Mengatur Atribut Permintaan

Atribut permintaan berisi informasi khusus permintaan dan hanya berlaku untuk permintaan saat ini. Aplikasi klien mengirimkan informasi ini ke Amazon Lex. Gunakan atribut permintaan untuk meneruskan informasi yang tidak perlu bertahan untuk seluruh sesi. Anda dapat membuat atribut permintaan Anda sendiri atau Anda dapat menggunakan atribut standar. Untuk mengirim atribut permintaan, gunakanx-amz-lex-request-attributes header dalamPostContent ataurequestAttributes bidang dalamPostText permintaan. Karena atribut permintaan tidak bertahan di seluruh permintaan seperti atribut sesi, atribut tersebut tidak ditampilkanPostContent atauPostText ditanggapi.

catatan

Untuk mengirim informasi yang tetap ada di seluruh permintaan, gunakan atribut sesi.

Namespacex-amz-lex: dicadangkan untuk atribut permintaan yang telah ditetapkan. Jangan membuat atribut permintaan dengan awalanx-amz-lex:.

Mengatur Atribut Permintaan yang Telah Ditetapkan

Amazon Lex menyediakan atribut permintaan yang telah ditentukan untuk mengelola cara memproses informasi yang dikirim ke bot Anda. Atribut tidak bertahan untuk seluruh sesi, jadi Anda harus mengirim atribut yang telah ditetapkan dalam setiap permintaan. Semua atribut yang telah ditetapkan berada dix-amz-lex: namespace.

Selain atribut yang telah ditentukan sebelumnya berikut, Amazon Lex menyediakan atribut yang telah ditentukan sebelumnya untuk platform perpesanan. Untuk daftar atribut tersebut, lihatMenyebarkan Amazon Lex Bot pada Platform Pesan.

Mengatur Jenis Respons

Jika Anda memiliki dua aplikasi klien yang memiliki kemampuan berbeda, Anda mungkin perlu membatasi format pesan dalam respons. Misalnya, Anda mungkin ingin membatasi pesan yang dikirim ke klien Web untuk teks biasa, tetapi memungkinkan klien seluler untuk menggunakan teks biasa dan Speech Synthesis Markup Language (SSMP). Untuk mengatur format pesan yang dikembalikan olehPostContent danPostText operasi, gunakan atributx-amz-lex:accept-content-types" request.

Anda dapat menetapkan atribut ke kombinasi dari jenis pesan berikut:

• PlainText—Pesan berisi teks UTF-8 biasa.

• SSML—Pesan berisi teks yang diformat untuk output suara.

• CustomPayload—Pesan berisi format kustom yang telah Anda buat untuk klien Anda. Anda dapat menetapkan payload untuk memenuhi kebutuhan aplikasi Anda.

Amazon Lex hanya mengembalikan pesan dengan jenis yang ditentukan diMessage bidang respons. Anda dapat mengatur lebih dari satu nilai dengan memisahkan nilai dengan koma. Jika Anda menggunakan grup pesan, setiap grup pesan harus berisi setidaknya satu pesan dari jenis yang ditentukan. Jika tidak, Anda mendapatkanNoUsableMessageException kesalahan. Untuk informasi selengkapnya, lihat Grup Pesan.

catatan

Atributx-amz-lex:accept-content-types request tidak berpengaruh pada isi tubuh HTML. Isi responsPostText operasi selalu teks UTF-8 biasa. Tubuh responsPostContent operasi berisi data dalam format yang ditetapkan dalamAccept header dalam permintaan.

Mengatur Zona Waktu Pilihan Zona Waktu Pilihan

Untuk mengatur zona waktu yang digunakan untuk menyelesaikan tanggal sehingga relatif terhadap zona waktu pengguna, gunakan atributx-amz-lex:time-zone request. Jika Anda tidak menentukan zona waktu dalamx-amz-lex:time-zone atribut, default tergantung pada wilayah yang Anda gunakan untuk bot Anda.

Wilayah	Zona waktu default
US East (N. Virginia)	America/New_York
US West (Oregon)	America/Los_Angeles
Asia Pasifik (Singapura)	Asia/Singapore
Asia Pacific (Sydney)	Australia/Sydney
Asia Pacific (Tokyo)	Asia/Tokyo
Europe (Frankfurt)	Europe/Berlin
Europe (Ireland)	Europe/Dublin
Europe (London)	Europe/London

Misalnya, jika pengguna merespons sebagaitomorrow tanggapan atas prompt “Hari apa Anda ingin paket Anda dikirimkan?” tanggal aktual paket dikirimkan tergantung pada zona waktu pengguna. Misalnya, ketika pukul 01:00 16 September di New York, sekarang pukul 22:00 15 September di Los Angeles. Jika layanan Anda berjalan di Wilayah AS Timur (Virginia Utara) dan seseorang di Los Angeles memesan paket yang akan dikirim “besok” menggunakan zona waktu default, paket akan dikirimkan pada tanggal 17, bukan tanggal 16. Namun, jika Anda menetapkan atributx-amz-lex:time-zone request keAmerica/Los_Angeles, paket akan dikirimkan pada tanggal 16.

Anda dapat mengatur atribut ke salah satu nama zona waktu Internet Assigned Number Authority (IANA). Untuk daftar nama zona waktu, lihat Daftar zona waktu database tz di Wikipedia.

Mengatur Atribut Permintaan yang Ditetapkan Pengguna

Atribut permintaan yang ditentukan pengguna adalah data yang Anda kirim ke bot Anda di setiap permintaan. Anda mengirim informasi diamz-lex-request-attributes headerPostContent permintaan atau direquestAttributes bidangPostText permintaan.

Untuk mengirim atribut permintaan ke Amazon Lex, Anda membuat string-to-string peta atribut. Berikut ini menunjukkan cara memetakan atribut permintaan:

{
   "attributeName": "attributeValue",
   "attributeName": "attributeValue"
}

UntukPostText operasi, Anda memasukkan peta ke dalam badan permintaan menggunakanrequestAttributes bidang, sebagai berikut:

"requestAttributes": {
   "attributeName": "attributeValue",
   "attributeName": "attributeValue"
}

UntukPostContent operasi, Anda base64 menyandikan peta, dan kemudian mengirimkannya sebagaix-amz-lex-request-attributes header.

Jika Anda mengirim data biner atau terstruktur dalam atribut request, Anda harus terlebih dahulu mengubah data ke string sederhana. Untuk informasi selengkapnya, lihat Mengatur Atribut Kompleks Kompleks.