Peristiwa Input Fungsi Lambda dan Format Respons

currentIntent — Menyediakan maksud,, dan bidang. name slots slotDetails confirmationStatus

nluIntentConfidenceScoreadalah keyakinan yang dimiliki Amazon Lex bahwa maksud saat ini adalah yang paling cocok dengan maksud pengguna saat ini.

slotsadalah peta nama slot, dikonfigurasi untuk maksud, ke nilai slot yang telah dikenali Amazon Lex dalam percakapan pengguna. Nilai slot tetap nol sampai pengguna memberikan nilai.

Nilai slot dalam acara input mungkin tidak cocok dengan salah satu nilai yang dikonfigurasi untuk slot. Misalnya, jika pengguna menanggapi prompt “Mobil warna apa yang Anda inginkan?” dengan “pizza,” Amazon Lex akan mengembalikan “pizza” sebagai nilai slot. Fungsi Anda harus memvalidasi nilai untuk memastikan bahwa nilai tersebut masuk akal dalam konteks.

slotDetailsmemberikan informasi tambahan tentang nilai slot. resolutionsArray berisi daftar nilai tambahan yang dikenali untuk slot. Setiap slot dapat memiliki maksimal lima nilai.

originalValueBidang berisi nilai yang dimasukkan oleh pengguna untuk slot. Ketika jenis slot dikonfigurasi untuk mengembalikan nilai resolusi teratas sebagai nilai slot, originalValue mungkin berbeda dari nilai di slots bidang.

confirmationStatusmemberikan respons pengguna terhadap prompt konfirmasi, jika ada. Misalnya, jika Amazon Lex bertanya, “Apakah Anda ingin memesan pizza keju besar? ,” tergantung pada respons pengguna, nilai bidang ini bisa Confirmed atauDenied. Jika tidak, nilai bidang ini adalahNone.

Jika pengguna mengonfirmasi maksud, Amazon Lex menyetel bidang ini keConfirmed. Jika pengguna menyangkal maksud tersebut, Amazon Lex menetapkan nilai ini ke. Denied

Dalam tanggapan konfirmasi, ucapan pengguna mungkin memberikan pembaruan slot. Misalnya, pengguna mungkin mengatakan “ya, ubah ukuran menjadi sedang.” Dalam hal ini, acara Lambda berikutnya memiliki nilai slot yang diperbarui, PizzaSize disetel ke. medium Amazon Lex menetapkan confirmationStatus keNone, karena pengguna memodifikasi beberapa data slot, memerlukan fungsi Lambda untuk melakukan validasi data pengguna.

AlternativeIntents — Jika Anda mengaktifkan skor kepercayaan, Amazon Lex mengembalikan hingga empat maksud alternatif. Setiap intent menyertakan skor yang menunjukkan tingkat kepercayaan yang dimiliki Amazon Lex bahwa maksud tersebut adalah maksud yang benar berdasarkan ucapan pengguna.

Isi dari maksud alternatif sama dengan isi currentIntent lapangan. Untuk informasi selengkapnya, lihat Menggunakan Skor Keyakinan.

bot — Informasi tentang bot yang memproses permintaan.

UserID — Nilai ini disediakan oleh aplikasi klien. Amazon Lex meneruskannya ke fungsi Lambda.

InputTranscript — Teks yang digunakan untuk memproses permintaan.

Jika input adalah teks, inputTranscript bidang berisi teks yang dimasukkan oleh pengguna.

Jika input adalah aliran audio, inputTranscript bidang berisi teks yang diekstrak dari aliran audio. Ini adalah teks yang sebenarnya diproses untuk mengenali maksud dan nilai slot.

InvocationSource - Untuk menunjukkan mengapa Amazon Lex menjalankan fungsi Lambda, ia menetapkan ini ke salah satu nilai berikut:

Dalam konfigurasi intent, Anda dapat memiliki dua fungsi Lambda terpisah untuk menginisialisasi dan memvalidasi data pengguna dan memenuhi intent. Anda juga dapat menggunakan satu fungsi Lambda untuk melakukan keduanya. Dalam hal ini, fungsi Lambda Anda dapat menggunakan invocationSource nilai untuk mengikuti jalur kode yang benar.

outputDialogMode— Untuk setiap input pengguna, klien mengirimkan permintaan ke Amazon Lex menggunakan salah satu operasi API runtime, PostContent atauPostText. Amazon Lex menggunakan parameter permintaan untuk menentukan apakah respons terhadap klien adalah teks atau suara, dan menetapkan bidang ini sesuai.

Fungsi Lambda dapat menggunakan informasi ini untuk menghasilkan pesan yang sesuai. Misalnya, jika klien mengharapkan respons suara, fungsi Lambda Anda dapat menampilkan Speech Synthesis Markup Language (SSML) alih-alih teks.

MessageVersion — Versi pesan yang mengidentifikasi format data peristiwa yang masuk ke fungsi Lambda dan format respons yang diharapkan dari fungsi Lambda.

SessionAttributes — Atribut sesi khusus aplikasi yang dikirimkan klien dalam permintaan. Jika Anda ingin Amazon Lex memasukkannya ke dalam respons terhadap klien, fungsi Lambda Anda harus mengirimkannya kembali ke Amazon Lex sebagai tanggapan. Untuk informasi selengkapnya, silakan lihat Mengatur Atribut Sesi

RequestAttributes - Atribut khusus permintaan yang dikirim klien dalam permintaan. Gunakan atribut permintaan untuk meneruskan informasi yang tidak perlu bertahan selama seluruh sesi. Jika tidak ada atribut permintaan, nilainya akan menjadi null. Untuk informasi selengkapnya, silakan lihat Mengatur Atribut Permintaan

recentIntentSummaryLihat — Informasi tentang keadaan suatu niat. Anda dapat melihat informasi tentang tiga maksud terakhir yang digunakan. Anda dapat menggunakan informasi ini untuk menetapkan nilai dalam intent atau kembali ke intent sebelumnya. Untuk informasi selengkapnya, lihat Mengelola Sesi Dengan Amazon Lex API.

SentimentResponse — Hasil analisis sentimen Amazon Comprehend dari ucapan terakhir. Anda dapat menggunakan informasi ini untuk mengelola alur percakapan bot Anda tergantung pada sentimen yang diungkapkan oleh pengguna. Untuk informasi selengkapnya, lihat Analisis Sentimen.

KendrareSponse — Hasil kueri ke indeks Amazon Kendra. Hanya ada dalam input ke hook kode pemenuhan dan hanya ketika intent memperluas intent bawaan. AMAZON.KendraSearchIntent Bidang berisi seluruh respons dari pencarian Amazon Kendra. Untuk informasi selengkapnya, lihat AMAZON.KendraSearchIntent.

ActiveContext - Satu atau lebih konteks yang aktif selama pergantian percakapan dengan pengguna ini.

Untuk informasi selengkapnya, lihat Mengatur Konteks Maksud.

Close— Menginformasikan Amazon Lex untuk tidak mengharapkan tanggapan dari pengguna. Misalnya, “Pesanan pizza Anda telah ditempatkan” tidak memerlukan tanggapan.

Bidang fulfillmentState wajib diisi. Amazon Lex menggunakan nilai ini untuk mengatur dialogState bidang di PostContent atau PostText respons terhadap aplikasi klien. responseCardBidang message dan adalah opsional. Jika Anda tidak menentukan pesan, Amazon Lex menggunakan pesan selamat tinggal atau pesan tindak lanjut yang dikonfigurasi untuk maksud tersebut.

"dialogAction": {
    "type": "Close",
    "fulfillmentState": "Fulfilled or Failed",
    "message": {
      "contentType": "PlainText or SSML or CustomPayload",
      "content": "Message to convey to the user. For example, Thanks, your pizza has been ordered."
    },
   "responseCard": {
      "version": integer-value,
      "contentType": "application/vnd.amazonaws.card.generic",
      "genericAttachments": [
          {
             "title":"card-title",
             "subTitle":"card-sub-title",
             "imageUrl":"URL of the image to be shown",
             "attachmentLinkUrl":"URL of the attachment to be associated with the card",
             "buttons":[ 
                 {
                    "text":"button-text",
                    "value":"Value sent to server on button click"
                 }
              ]
           } 
       ] 
     }
  }

ConfirmIntent— Menginformasikan Amazon Lex bahwa pengguna diharapkan memberikan jawaban ya atau tidak untuk mengkonfirmasi atau menolak maksud saat ini.

Anda harus memasukkan intentName dan slots bidang. slotsBidang harus berisi entri untuk setiap slot yang diisi untuk maksud yang ditentukan. Anda tidak perlu memasukkan entri di slots bidang untuk slot yang tidak terisi. Anda harus menyertakan message bidang jika bidang intent adalah confirmationPrompt null. Isi message bidang yang dikembalikan oleh fungsi Lambda lebih diutamakan daripada yang confirmationPrompt ditentukan dalam intent. responseCardBidang ini opsional.

"dialogAction": {
    "type": "ConfirmIntent",
    "message": {
      "contentType": "PlainText or SSML or CustomPayload",
      "content": "Message to convey to the user. For example, Are you sure you want a large pizza?"
    },
   "intentName": "intent-name",
   "slots": {
      "slot-name": "value",
      "slot-name": "value",
      "slot-name": "value"  
   },
   "responseCard": {
      "version": integer-value,
      "contentType": "application/vnd.amazonaws.card.generic",
      "genericAttachments": [
          {
             "title":"card-title",
             "subTitle":"card-sub-title",
             "imageUrl":"URL of the image to be shown",
             "attachmentLinkUrl":"URL of the attachment to be associated with the card",
             "buttons":[ 
                 {
                    "text":"button-text",
                    "value":"Value sent to server on button click"
                 }
              ]
           } 
       ] 
     }
  }
                         

Delegate— Mengarahkan Amazon Lex untuk memilih tindakan berikutnya berdasarkan konfigurasi bot. Jika respons tidak menyertakan atribut sesi apa pun, Amazon Lex mempertahankan atribut yang ada. Jika Anda ingin nilai slot menjadi nol, Anda tidak perlu memasukkan bidang slot dalam permintaan. Anda akan mendapatkan DependencyFailedException pengecualian jika fungsi pemenuhan Anda mengembalikan tindakan Delegate dialog tanpa menghapus slot apa pun.

kendraQueryFilterStringBidang kendraQueryRequestPayload dan bersifat opsional dan hanya digunakan ketika maksud berasal dari maksud AMAZON.KendraSearchIntent bawaan. untuk informasi selengkapnya, lihat. AMAZON.KendraSearchIntent

  "dialogAction": {
   "type": "Delegate",
   "slots": {
      "slot-name": "value",
      "slot-name": "value",
      "slot-name": "value"  
   },
   "kendraQueryRequestPayload": "Amazon Kendra query",
   "kendraQueryFilterString": "Amazon Kendra attribute filters"
  }

ElicitIntent— Menginformasikan Amazon Lex bahwa pengguna diharapkan untuk merespons dengan ucapan yang menyertakan maksud. Misalnya, “Saya ingin pizza besar,” yang menunjukkanOrderPizzaIntent. Ucapan “besar,” di sisi lain, tidak cukup bagi Amazon Lex untuk menyimpulkan maksud pengguna.

responseCardBidang message dan adalah opsional. Jika Anda tidak memberikan pesan, Amazon Lex menggunakan salah satu permintaan klarifikasi bot. Jika tidak ada prompt klarifikasi yang ditentukan, Amazon Lex mengembalikan pengecualian 400 Permintaan Buruk.

{
  "dialogAction": {
    "type": "ElicitIntent",
    "message": {
      "contentType": "PlainText or SSML or CustomPayload",
      "content": "Message to convey to the user. For example, What can I help you with?"
    },
    "responseCard": {
      "version": integer-value,
      "contentType": "application/vnd.amazonaws.card.generic",
      "genericAttachments": [
          {
             "title":"card-title",
             "subTitle":"card-sub-title",
             "imageUrl":"URL of the image to be shown",
             "attachmentLinkUrl":"URL of the attachment to be associated with the card",
             "buttons":[ 
                 {
                    "text":"button-text",
                    "value":"Value sent to server on button click"
                 }
              ]
           } 
       ] 
    }
 }                       
                        

ElicitSlot— Menginformasikan Amazon Lex bahwa pengguna diharapkan memberikan nilai slot dalam respons.

slotsBidang intentNameslotToElicit,, dan diperlukan. responseCardBidang message dan adalah opsional. Jika Anda tidak menentukan pesan, Amazon Lex menggunakan salah satu permintaan elisitasi slot yang dikonfigurasi untuk slot.

  "dialogAction": {
    "type": "ElicitSlot",
    "message": {
      "contentType": "PlainText or SSML or CustomPayload",
      "content": "Message to convey to the user. For example, What size pizza would you like?"
    },
   "intentName": "intent-name",
   "slots": {
      "slot-name": "value",
      "slot-name": "value",
      "slot-name": "value"  
   },
   "slotToElicit" : "slot-name",
   "responseCard": {
      "version": integer-value,
      "contentType": "application/vnd.amazonaws.card.generic",
      "genericAttachments": [
          {
             "title":"card-title",
             "subTitle":"card-sub-title",
             "imageUrl":"URL of the image to be shown",
             "attachmentLinkUrl":"URL of the attachment to be associated with the card",
             "buttons":[ 
                 {
                    "text":"button-text",
                    "value":"Value sent to server on button click"
                 }
              ]
           } 
       ] 
     }
  }