Lambda 函数输入事件和响应格式

currentIntent – 提供目的 name、slots、slotDetails 和 confirmationStatus 字段。

nluIntentConfidenceScore 是 Amazon Lex 对当前意图最符合用户当前意图的信心程度。

slots 是从为意图配置的插槽名称到 Amazon Lex 在用户会话中识别出的插槽值的映射。槽值保持为空，直到用户提供一个值。

输入事件中的槽值可能与为槽配置的值之一不匹配。例如，如果用户对“您想要什么颜色的车？”提示给出的响应是 “披萨”，Amazon Lex 会将“披萨”返回为插槽值。您的函数应对这些值进行验证，以确保它们在上下文中有意义。

slotDetails 提供有关槽值的附加信息。resolutions 数组包含为槽识别的附加值的列表。每个槽最多可以有五个值。

originalValue 字段包含用户为槽输入的值。在将槽类型配置为将最高解析值返回为槽值时，originalValue 可能与 slots 字段中的值不同。

confirmationStatus 向确认提示 (如果有) 提供用户响应。例如，如果 Amazon Lex 询问“是否要订购大份的芝士披萨？”，根据用户响应，此字段的值可能为 Confirmed 或 Denied。否则，此字段的值为 None。

如果用户确认意图，则 Amazon Lex 会将此字段设置为 Confirmed。如果用户拒绝意图，则 Amazon Lex 会将此值设置为 Denied。

在确认响应中，用户表达可能提供槽更新。例如，用户可能会说“是的，改为中份的。” 在这种情况下，后续 Lambda 事件具有更新的插槽值，PizzaSize 将设置为 medium。Amazon Lex 将 confirmationStatus 设置为 None，因为用户修改了一些插槽数据，需要 Lambda 函数执行用户数据验证。

alternativeIntents — 如果您启用置信度分数，Amazon Lex 最多会返回四个替代意图。每个意图都包含一个分数，该分数表明 Amazon Lex 根据用户的言语对意图是正确意图的信心程度。

替代意图的内容与 currentIntent 字段的内容相同。有关更多信息，请参阅使用置信度分数。

bot – 用于处理请求的自动程序的相关信息。

userId — 此值由客户端应用程序提供。Amazon Lex 将此值传递给 Lambda 函数。

inputTranscript – 用于处理请求的文本。

如果输入为文本，则 inputTranscript 字段包含用户输入的文本。

如果输入为音频流，则 inputTranscript 字段包含从该音频流中提取的文本。这是经过实际处理以识别目的和槽值的文本。

invocationSource — 要指示 Amazon Lex 调用 Lambda 函数的原因，它会将此处设置为以下值之一：

在您的意图配置中，您可以拥有两个单独的 Lambda 函数来初始化和验证用户数据并履行意图。您也可使用一个 Lambda 函数执行以上两种操作。在这种情况下，您的 Lambda 函数可以使用 invocationSource 值来遵循正确的代码路径。

outputDialogMode — 对于每个用户输入，客户端将使用其中一个运行时 API 操作、PostContent 或 PostText 来向 Amazon Lex 发送请求。Amazon Lex 使用请求参数来确定对客户端的响应是文本还是语音，并相应地设置此字段。

Lambda 函数可使用此信息生成相应的消息。例如，如果客户端需要语音响应，则您的 Lambda 函数可以返回语音合成标记语言 (SSML) 而不是文本。

messageVersion — 消息的版本，用于标识进入 Lambda 函数的事件数据的格式以及来自 Lambda 函数的响应的预期格式。

sessionAttributes — 客户端在请求中发送的特定于应用程序的会话属性。如果您希望 Amazon Lex 在对客户端的响应中包含这些属性，则您的 Lambda 函数应在响应中将它们发送回 Amazon Lex。有关更多信息，请参阅设置会话属性。

requestAttributes — 客户端在请求中发送的特定于请求的属性。可以使用请求属性传递不需要在整个会话中保留的信息。如果没有请求属性，该值将为空。有关更多信息，请参阅设置请求属性。

recentIntentSummaryView — 有关意图状态的信息。您可以看到有关所用最后三个意图的信息。您可以使用此信息在意图中设置值或返回到之前的意图。有关更多信息，请参阅使用 Amazon Lex API 管理会话。

sentimentResponse — 最后一个语句的 Amazon Comprehend 情绪分析结果。您可以使用此信息，根据用户表达的情绪来管理自动程序的对话流。有关更多信息，请参阅情绪分析。

kendraResponse — 对 Amazon Kendra 索引的查询结果。仅出现在实现代码挂钩的输入中，并且仅当目的扩展 AMAZON.KendraSearchIntent 内置目的时。该字段包含来自 Amazon Kendra 搜索的整个响应。有关更多信息，请参阅AMAZON.KendraSearchIntent。

activeContexts — 在与用户的这一轮对话中处于活动状态的一个或多个上下文。

有关更多信息，请参阅设置意图上下文。

Close — 通知 Amazon Lex 不要期望用户进行响应。例如，“您的披萨已下单”不需要响应。

fulfillmentState 字段为必填项。Amazon Lex 使用此值在对客户端应用程序的 PostContent 或 PostText 响应中设置 dialogState 字段。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 字段无需包含条目。如果目的的 confirmationPrompt 字段为空，则您必须包括 message 字段。Lambda 函数返回的 message 字段的内容优先于意图中指定的 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 将保留现有属性。如果您希望槽值为空，则无需在请求中包含槽字段。如果您的实现函数返回 Delegate 对话操作而没有删除任何槽，您将收到 DependencyFailedException 异常。

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