Mengelola Sesi Dengan Amazon Lex API

Mode fokus

Mengelola Sesi Dengan Amazon Lex API - Amazon Lex V1

Beralih Maksud Melanjutkan Niat Sebelumnya Memulai Sesi Baru Memvalidasi Nilai Slot

Pemberitahuan akhir dukungan: Pada 15 September 2025, AWS akan menghentikan dukungan untuk Amazon Lex V1. Setelah 15 September 2025, Anda tidak lagi dapat mengakses konsol Amazon Lex V1 atau sumber daya Amazon Lex V1. Jika Anda menggunakan Amazon Lex V2, lihat panduan Amazon Lex V2 sebagai gantinya.

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

Saat pengguna memulai percakapan dengan bot Anda, Amazon Lex membuat sesi. Informasi yang dipertukarkan antara aplikasi Anda dan Amazon Lex membentuk status sesi untuk percakapan. Saat Anda membuat permintaan, sesi diidentifikasi dengan kombinasi nama bot dan pengenal pengguna yang Anda tentukan. Untuk informasi selengkapnya tentang pengenal pengguna, lihat userId bidang dalam PostText operasi PostContent atau.

Respons dari operasi sesi mencakup pengidentifikasi sesi unik yang mengidentifikasi sesi tertentu dengan pengguna. Anda dapat menggunakan pengenal ini selama pengujian atau untuk membantu memecahkan masalah bot Anda.

Anda dapat mengubah status sesi yang dikirim antara aplikasi Anda dan bot Anda. Misalnya, Anda dapat membuat dan memodifikasi atribut sesi yang berisi informasi khusus tentang sesi, dan Anda dapat mengubah alur percakapan dengan menyetel konteks dialog untuk menafsirkan ucapan berikutnya.

Ada dua cara Anda dapat memperbarui status sesi. Yang pertama adalah menggunakan fungsi Lambda dengan PostContent atau PostText operasi yang dipanggil setelah setiap putaran percakapan. Untuk informasi selengkapnya, lihat Menggunakan Fungsi Lambda. Yang lainnya adalah menggunakan API runtime Amazon Lex di aplikasi Anda untuk membuat perubahan pada status sesi.

Amazon Lex runtime API menyediakan operasi yang memungkinkan Anda mengelola informasi sesi untuk percakapan dengan bot Anda. Operasi adalah PutSession operasi, GetSession operasi, dan DeleteSession operasi. Anda menggunakan operasi ini untuk mendapatkan informasi tentang status sesi pengguna Anda dengan bot Anda, dan untuk memiliki kontrol halus atas status.

Gunakan GetSession operasi saat Anda ingin mendapatkan status sesi saat ini. Operasi mengembalikan status sesi saat ini, termasuk status dialog dengan pengguna Anda, atribut sesi apa pun yang telah ditetapkan, dan nilai slot untuk tiga maksud terakhir yang berinteraksi dengan pengguna.

PutSessionOperasi ini memungkinkan Anda untuk secara langsung memanipulasi status sesi saat ini. Anda dapat mengatur jenis tindakan dialog yang akan dilakukan bot selanjutnya. Ini memberi Anda kendali atas aliran percakapan dengan bot. Atur type bidang tindakan dialog Delegate agar Amazon Lex menentukan tindakan selanjutnya untuk bot.

Anda dapat menggunakan PutSession operasi untuk membuat sesi baru dengan bot dan mengatur maksud bahwa bot harus memulai. Anda juga dapat menggunakan PutSession operasi untuk mengubah dari satu maksud ke maksud lainnya. Saat membuat sesi atau mengubah intent, Anda juga dapat mengatur status sesi, seperti nilai slot dan atribut sesi. Ketika intent baru selesai, Anda memiliki opsi untuk memulai ulang maksud sebelumnya. Anda dapat menggunakan GetSession operasi untuk mendapatkan status dialog dari intent sebelumnya dari Amazon Lex dan menggunakan informasi untuk menyetel status dialog maksud.

Respons dari PutSession operasi berisi informasi yang sama dengan PostContent operasi. Anda dapat menggunakan informasi ini untuk meminta pengguna untuk informasi berikutnya, seperti yang Anda lakukan dengan respons dari PostContent operasi.

Gunakan DeleteSession operasi untuk menghapus sesi yang ada dan mulai lagi dengan sesi baru. Misalnya, ketika Anda menguji bot Anda, Anda dapat menggunakan DeleteSession operasi untuk menghapus sesi pengujian dari bot Anda.

Operasi sesi bekerja dengan fungsi Lambda pemenuhan Anda. Misalnya, jika fungsi Lambda Anda kembali Failed sebagai status pemenuhan, Anda dapat menggunakan PutSession operasi untuk menyetel jenis tindakan dialog ke close dan fulfillmentState ReadyForFulfillment untuk mencoba lagi langkah pemenuhan.

Berikut adalah beberapa hal yang dapat Anda lakukan dengan operasi sesi:

Mintalah bot memulai percakapan alih-alih menunggu pengguna.
Beralih maksud selama percakapan.
Kembali ke intent sebelumnya.
Mulai atau mulai ulang percakapan di tengah interaksi.
Validasi nilai slot dan minta bot kembali meminta nilai yang tidak valid.

Masing-masing dijelaskan lebih lanjut di bawah ini.

Beralih Maksud

Anda dapat menggunakan PutSession operasi untuk beralih dari satu maksud ke maksud lainnya. Anda juga dapat menggunakannya untuk beralih kembali ke intent sebelumnya. Anda dapat menggunakan PutSession operasi untuk mengatur atribut sesi atau nilai slot untuk maksud baru.

Panggil PutSession operasi. Tetapkan nama maksud ke nama maksud baru dan setel tindakan dialog ke. Delegate Anda juga dapat mengatur nilai slot atau atribut sesi yang diperlukan untuk maksud baru.
Amazon Lex akan memulai percakapan dengan pengguna menggunakan maksud baru.

Melanjutkan Niat Sebelumnya

Untuk melanjutkan intent sebelumnya, Anda menggunakan GetSession operasi untuk mendapatkan ringkasan intent, lalu gunakan PutSession operasi untuk menyetel intent ke status dialog sebelumnya.

Panggil GetSession operasi. Respons dari operasi mencakup ringkasan status dialog dari tiga intent terakhir yang berinteraksi dengan pengguna.
Menggunakan informasi dari ringkasan maksud, panggil PutSession operasi. Ini akan mengembalikan pengguna ke intent sebelumnya di tempat yang sama dalam percakapan.

Dalam beberapa kasus mungkin perlu untuk melanjutkan percakapan pengguna Anda dengan bot Anda. Misalnya, katakan bahwa Anda telah membuat bot layanan pelanggan. Aplikasi Anda menentukan bahwa pengguna perlu berbicara dengan perwakilan layanan pelanggan. Setelah berbicara dengan pengguna, perwakilan dapat mengarahkan percakapan kembali ke bot dengan informasi yang mereka kumpulkan.

Untuk melanjutkan sesi, gunakan langkah-langkah yang mirip dengan ini:

Aplikasi Anda menentukan bahwa pengguna perlu berbicara dengan perwakilan layanan pelanggan.
Gunakan GetSession operasi untuk mendapatkan status dialog intent saat ini.
Perwakilan layanan pelanggan berbicara kepada pengguna dan menyelesaikan masalah.
Gunakan PutSession operasi untuk mengatur status dialog maksud. Ini mungkin termasuk menyetel nilai slot, menyetel atribut sesi, atau mengubah maksud.
Bot melanjutkan percakapan dengan pengguna.

Anda dapat menggunakan checkpointLabel parameter PutSession operasi untuk memberi label maksud sehingga Anda dapat menemukannya nanti. Misalnya, bot yang meminta informasi pelanggan mungkin masuk ke Waiting intent sementara pelanggan mengumpulkan informasi. Bot membuat label pos pemeriksaan untuk maksud saat ini dan kemudian memulai intent. Waiting Ketika pelanggan kembali, bot dapat menemukan maksud sebelumnya menggunakan label pos pemeriksaan dan beralih kembali.

Maksud harus ada dalam recentIntentSummaryView struktur yang dikembalikan oleh GetSession operasi. Jika Anda menentukan label pos pemeriksaan dalam permintaan GetSession operasi, itu akan mengembalikan maksimum tiga maksud dengan label pos pemeriksaan itu.

Gunakan GetSession operasi untuk mendapatkan keadaan sesi saat ini.
Gunakan PutSession operasi untuk menambahkan label pos pemeriksaan ke maksud terakhir. Jika perlu, Anda dapat menggunakan PutSession panggilan ini untuk beralih ke maksud yang berbeda.
Ketika tiba waktunya untuk beralih kembali ke maksud berlabel, panggil GetSession operasi untuk mengembalikan daftar maksud terbaru. Anda dapat menggunakan checkpointLabelFilter parameter sehingga Amazon Lex hanya mengembalikan maksud dengan label pos pemeriksaan yang ditentukan.

Memulai Sesi Baru

Jika Anda ingin bot memulai percakapan dengan pengguna Anda, Anda dapat menggunakan PutSession operasi.

Buat maksud selamat datang tanpa slot dan pesan kesimpulan yang meminta pengguna untuk menyatakan maksud. Misalnya, “Apa yang ingin Anda pesan? Anda bisa mengatakan 'Pesan minuman' atau 'Pesan pizza. '”
Panggil PutSession operasi. Tetapkan nama maksud ke nama maksud selamat datang Anda dan setel tindakan dialog ke. Delegate
Amazon Lex akan merespons dengan permintaan dari niat selamat datang Anda untuk memulai percakapan dengan pengguna Anda.

Memvalidasi Nilai Slot

Anda dapat memvalidasi tanggapan terhadap bot Anda menggunakan aplikasi klien Anda. Jika respons tidak valid, Anda dapat menggunakan PutSession operasi untuk mendapatkan respons baru dari pengguna Anda. Misalnya, bot pemesanan bunga Anda hanya dapat menjual tulip, mawar, dan bunga lili. Jika pengguna memesan anyelir, aplikasi Anda dapat melakukan hal berikut:

Periksa nilai slot yang dikembalikan dari PostContent respons PostText atau.
Jika nilai slot tidak valid, hubungi PutSession operasi. Aplikasi Anda harus menghapus nilai slot, mengatur slotToElicit bidang, dan menetapkan dialogAction.type nilainyaelicitSlot. Secara opsional, Anda dapat mengatur messageFormat bidang message dan jika Anda ingin mengubah pesan yang digunakan Amazon Lex untuk memperoleh nilai slot.