Lambda 函數輸入事件和回應格式

currentIntent – 提供意圖 name、slots slotDetails 和 confirmationStatus 欄位。

nluIntentConfidenceScore是 Amazon Lex 對當前意圖最符合用户當前意圖的信心。

slots是槽名稱 (為意圖所設定) 與 Amazon Lex 在使用者對話中識別出的槽值的對應。槽值會保持 null，直到使用者提供值為止。

輸入事件中的槽值可能不符合為槽所設定的其中一個值。例如，如果使用者對提示「您想要什麼顏色的車？」 和「比薩」，」Amazon Lex 將傳回「比薩」做為槽值。您的函數應該驗證值，以確保內容符合邏輯。

slotDetails 會提供有關槽值的更多資訊。resolutions 陣列包含為槽所識別的其他值清單。每個槽最多可有 5 個值。

originalValue 欄位包含使用者為槽輸入的值。當槽類型設定為傳回最常用的解析值來做為槽值時，originalValue 可能與 slots 欄位中的值不同。

confirmationStatus 提供對確認提示 (如果有的話) 的使用者回應。例如，如果 Amazon Lex 詢問「您是否要訂購大型起士比薩？ 」，根據使用者的回應，此欄位的值可以是Confirmed或者Denied。否則，此欄位的值會式 None。

如果使用者確認意圖、Amazon Lex 會將此欄位設定為Confirmed。如果使用者拒絕意圖、Amazon Lex 會將此值設定為Denied。

在確認回應中，使用者表達用語可能會提供槽更新。例如，使用者可能說「是，大小改為中型。」 在這種情況下，後續 Lambda 事件會有已更新的槽值PizzaSize設定為medium。Amazon Lex 設定confirmationStatus至None，因為使用者修改了一些槽資料，而需要使用 Lambda 函數執行使用者資料驗證。

替代用途— 如果啟用置信度分數，Amazon Lex 將返回最多四個備選方法。每個意圖都包含一個分數，表明 Amazon Lex 對意圖是基於用户言論的正確意圖的信心程度。

備選意圖的內容與currentIntent欄位。如需詳細資訊，請參閱 使用可信度分數。

bot – 處理請求之機器人的相關資訊。

userId— 此值是由用户端應用程式提供。Amazon Lex 傳遞給 Lambda 函數。

inputTranscript – 用來處理請求的文字。

如果輸入是文字，inputTranscript 欄位會包含使用者輸入的文字。

如果輸入是音訊串流，inputTranscript 欄位會包含從音訊串流擷取的文字。這是實際處理以識別意圖和槽值的文字。

invocationSource— 指明為什 Amazon Lex 叫 Lambda 函數，它會將此設定為下列其中一個值：

在您的意圖組態中，可以有兩個單獨的 Lambda 函數來初始化和驗證使用者資料，以及滿足意圖。您也可以使用一個 Lambda 函數來執行兩者。在這種情況下，Lambda 函數可以使用invocationSource值以遵循正確的程式碼路徑。

outputDialogMode— 對於每個使用者輸入，用户端會使用 Amazon Lex 中一個執行時間 API 操作，PostContent或者PostText。Amazon Lex 使用請求參數來判斷回應用户端的是文字還是語音，並相應設定此欄位。

Lambda 函數可以使用此資訊來產生適當的訊息。例如，如果用户端預期語音回應，Lambda 函數可以傳回語音合成標記語言 (SSML)，而非文字。

messageVersion— 事件的訊息，可識別進入 Lambda 函數的格式以及從 Lambda 函數的回應預期的格式。

sessionAttributes— 用户端在請求中傳送的應用程式特定的工作階段屬性。如果您希望 Amazon Lex 將其包含在對用户端的回應中，您的 Lambda 函數應該在回應中把這些傳回 Amazon Lex。如需詳細資訊，請參閱「」設定工作階段屬性

requestAttributes— 用户端在請求中傳送的請求特定的工作階段屬性。使用請求屬性來傳遞不需要在整個工作階段內保留的資訊。若無請求屬性，則數值將為 null。如需詳細資訊，請參閱「」設定請求屬性

recentIntentSummaryView— 關於意圖狀態的資訊。您可以查看最近使用之三個意圖的相關資訊。您可以使用此資訊來設定意圖中的值，或返回先前的意圖。如需詳細資訊，請參閱 使用 Amazon Lex API 管理工作階段。

sentimentResponse— Amazon Comprehend 情緒分析最後表達用語的結果。您可以根據使用者表達的情緒，使用此資訊來管理機器人的對話流程。如需詳細資訊，請參閱 情緒分析。

kendraResponse— 查詢 Amazon Kendra 索引的結果。只會出現在履行程式碼掛勾的輸入中，以及只有在意圖延伸 AMAZON.KendraSearchIntent 內建意圖時才會出現。欄位包含來自 Amazon Kendra 搜尋的整個回應。如需詳細資訊，請參閱 AMAZON.KendraSearchIntent。

活動文本— 一個或多個在與用户進行對話期間處於活動狀態的上下文。

如需詳細資訊，請參閱 設定意圖上下文。

Close— 通知 Amazon Lex 不預期使用者回應。例如，「您訂購的比薩已下單」不需要回應。

fulfillmentState 欄位是必要的。Amazon Lex 使用此值來設置dialogState欄位PostContent或者PostText回應用程式。message 和 responseCard 欄位是選用的。如果您不指定訊息，Amazon Lex 會使用針對意圖設定的再見訊息或後續追蹤訊息。

"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— 通知 Amazon Lex 預期使用者給予是或否的回答，以確認或拒絕目前的意圖。

您必須包含 intentName 與 slots 欄位。針對指定的意圖所填入的每個槽，slots 欄位都必須包含項目。您不需要為未填入的槽 slots 欄位中包含項目。​ 如果意圖的 message 欄位為空值，您必須為納入 confirmationPrompt 欄位。的內容message欄 Lambda 會優先於confirmationPrompt在意圖中指定。此 responseCard 欄位為選用。

"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— 引導 Amazon Lex 根據機器人組態選擇後續動作。如果回應不包含任何工作階段屬性，Amazon Lex 會保留現有的屬性。如果您希望槽值為空，您就不需在請求中包含槽欄位。如果您的履行函數沒有移除任何槽就傳回 DependencyFailedException 對話方塊動作，您將收到 Delegate 例外狀況。

kendraQueryRequestPayload 和 kendraQueryFilterString 欄位是選用的，只有當意圖是從 AMAZON.KendraSearchIntent 內建意圖衍生而來時才會使用。如需詳細資訊，請參閱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— 通知 Amazon Lex 預期使用者以包含意圖的表達用語回應。例如，「我想要大型比薩。」，亦即指出 OrderPizzaIntent。「大型」的表達用語在另一方面，並不足以讓 Amazon Lex 推斷使用者的意圖。

message 和 responseCard 欄位是選用的。如果您未提供訊息，Amazon Lex 會使用其中一個機器人的澄清提示。如果未定義釐清提示，Amazon Lex 會傳回 400 錯誤請求例外狀況。

{
  "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— 通知 Amazon Lex 預期使用者在回應中提供槽值。

intentName、slotToElicit 和 slots 欄位是必要的。message 和 responseCard 欄位是選用的。如果您不指定訊息，Amazon Lex 會使用為槽設定的其中一個槽引出提示。

  "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"
                 }
              ]
           } 
       ] 
     }
  }