终止支持通知：2025年9月15日， AWS 我们将停止对Amazon Lex V1的支持。2025 年 9 月 15 日之后，您将无法再访问 Amazon Lex V1 控制台或 Amazon Lex V1 资源。如果您使用的是 Amazon Lex V2，请改为参阅 [Amazon Lex V2 指南](https://docs.aws.amazon.com/lexv2/latest/dg/what-is.html)。

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

# 将 Lambda 函数从 Amazon Lex V1 迁移到 Amazon Lex V2
<a name="message-lambda"></a>

Amazon Lex V2 只允许机器人中的每种语言使用一个 Lambda 函数。Lambda 函数及其设置是针对您在运行时使用的机器人别名进行配置的。

如果为意图启用了对话和履行代码挂钩，则会为该语言的所有意图调用 Lambda 函数。

Amazon Lex V2 Lambda 函数的输入和输出消息格式与 Amazon Lex V1 不同。下面是 Lambda 函数输入格式的区别。
+ Amazon Lex V2 用 `interpretations` 结构取代了 `currentIntent` 和 `alternativeIntents` 结构。每种解释都包含意图、意图的 NLU 置信度分数和可选的情绪分析。
+ Amazon Lex V2 将 Amazon Lex V1 中的 `activeContexts` 和 `sessionAttributes` 移至统一的 `sessionState` 结构。此结构提供有关对话当前状态的相关信息，包括原始请求 ID。
+ Amazon Lex V2 不会返回 `recentIntentSummaryView`。改用 `sessionState` 结构中的信息。
+ Amazon Lex V2 输入在 `bot` 属性中提供了 `botId` 和 `localeId`。
+ 输入结构包含一个 `inputMode` 属性，该属性提供有关输入类型的信息：文本、语音或 DTMF。

下面是 Lambda 函数输出格式的区别：
+ Amazon Lex V1 中的 `activeContexts` 和 `sessionAttributes` 结构被 Amazon Lex V2 中的 `sessionState` 结构所取代。
+ `recentIntentSummaryView` 不包括在输出中。
+ Amazon Lex V1 `dialogAction` 结构分为两个结构，`dialogAction` 是 `sessionState` 结构的一部分，`messages` 是 `dialogAction.type` 为 `ElicitIntent` 时必需的。Amazon Lex 从此结构中选择要向用户显示的消息。

当您使用 Amazon Lex V2 构建机器人时 APIs，每种语言的每个机器人别名只有一个 Lambda 函数，而不是每个意图都有一个 Lambda 函数。如果要继续使用单独的函数，则可以创建一个路由器函数，为每个意图激活单独的函数。以下是您可以为应用程序使用或修改的路由器函数。

```
import os
import json
import boto3

# reuse client connection as global
client = boto3.client('lambda') 

def router(event):
    intent_name = event['sessionState']['intent']['name']
    fn_name = os.environ.get(intent_name)
    print(f"Intent: {intent_name} -> Lambda: {fn_name}")
    if (fn_name):
        # invoke lambda and return result
        invoke_response = client.invoke(FunctionName=fn_name, Payload = json.dumps(event))
        print(invoke_response)
        payload = json.load(invoke_response['Payload'])
        return payload
    raise Exception('No environment variable for intent: ' + intent_name)
    
def lambda_handler(event, context):
    print(event)
    response = router(event)
    return response
```

## 已更新的字段列表
<a name="lambda-migrating"></a>

下表提供了有关 Amazon Lex V2 Lambda 请求和响应中更新字段的详细信息。您可以使用这些表在版本之间映射字段。

### 请求
<a name="migrating-lambda-request"></a>

以下字段已经以 Lambda 函数请求格式进行了更新。

#### 活动的上下文
<a name="lambda-migrating-contexts"></a>

`activeContexts` 结构现在是 `sessionState` 结构的一部分。


| V1 结构 | V2 结构 | 
| --- | --- | 
|  activeContexts  |  sessionState.activeContexts  | 
|  ActiveContext [\$1]。 timeToLive  |  sessionState.activeContexts [ timeToLive  | 
|  ActiveContext [\$1]。 timeToLive。 timeToLiveInSeconds  |  sessionState.activeContexts [ timeToLive。 timeToLiveInSeconds  | 
|  ActiveContext [\$1]。 timeToLive。 turnsToLive  |  sessionState.activeContexts [ timeToLive。 turnsToLive  | 
|  activeContexts[\$1].name  |  sessionState.activeContexts[\$1].name  | 
|  activeContexts[\$1].parameters  |  sessionState.activeContexts[\$1].contextAttributes  | 

#### 替代意图
<a name="lambda-migrating-alternative"></a>

从索引 1 到 N 的解释列表包含 Amazon Lex V2 预测的替代意图列表及其置信度分数。`recentIntentSummaryView` 已从 Amazon Lex V2 的请求结构中删除。要从 `recentIntentSummaryView` 中查看详细信息，请使用 [GetSession](API_runtime_GetSession.md) 操作。


| V1 结构 | V2 结构 | 
| --- | --- | 
|  alternativeIntents  |  interpretations[1:\$1]  | 
|  recentIntentSummary查看  |  不适用  | 

#### 机器人
<a name="lambda-migrating-bot"></a>

Amazon Lex V2 中，机器人和别名都有标识符。机器人 ID 是代码挂钩输入的一部分。包含别名 ID，但不包含别名名称。Amazon Lex V2 支持同一个机器人的多个区域设置，因此包含了区域设置 ID。


| V1 结构 | V2 结构 | 
| --- | --- | 
|  自动程序  |  自动程序  | 
|  bot.name  |  bot.name  | 
|  不适用  |  bot.id  | 
|  bot.alias  |  不适用  | 
|  不适用  |  bot.aliasId  | 
|  bot.version  |  bot.version  | 
|  不适用  |  bot.localeId  | 

#### 当前意图
<a name="lambda-migrating-intent"></a>

`sessionState.intent` 结构包含活动意图的详细信息。Amazon Lex V2 还会返回 `interpretations` 结构中所有意图（包括替代意图）的列表。解释列表中的第一个元素始终与 `sessionState.intent` 相同。


| V1 结构 | V2 结构 | 
| --- | --- | 
|  currentIntent  |  sessionState.intent 或 interpretations[0].intent  | 
|  currentIntent.name  |  sessionState.intent.name 或 interpretations[0].intent.name  | 
|  当前意图。 nluConfidenceScore  |  interpretations[0].nluConfidence.score  | 

#### 对话操作
<a name="lambda-migrating-dialog"></a>

`confirmationStatus` 字段现在是 `sessionState` 结构的一部分。


| V1 结构 | V2 结构 | 
| --- | --- | 
|  currentIntent.confirmationStatus  |  sessionState.intent.confirmationState 或 interpretations[0].intent.confirmationState  | 
|  不适用  |  sessionState.intent.state 或 interpretations[\$1].intent.state  | 

#### Amazon Kendra
<a name="lambda-migrating-kendra"></a>

`kendraResponse` 字段现在是 `sessionState` 和 `interpretations` 结构的一部分。


| V1 结构 | V2 结构 | 
| --- | --- | 
|  kendraResponse  |  sessionState.intent.kendraResponse 或 interpretations[0].intent.kendraResponse  | 

#### 情绪
<a name="lambda-migrating-sentiment"></a>

`sentimentResponse` 结构已移至新 `interpretations` 结构。


| V1 结构 | V2 结构 | 
| --- | --- | 
|  sentimentResponse  |  interpretations[0].sentimentResponse  | 
|  sentimentResponse.sentimentLabel  |  interpretations[0].sentimentResponse.sentiment  | 
|  sentimentResponse.sentimentScore  |  interpretations[0].sentimentResponse.sentimentScore  | 

#### 槽值
<a name="lambda-migrating-slots"></a>

Amazon Lex V2 在 `sessionState.intent` 结构中提供了一个 `slots` 对象，其中包含用户所说内容的解析值、解释值和原始值。Amazon Lex V2 还通过将 `slotShape` 设置为 `List` 和设置 `values` 列表来支持多值插槽。`value` 字段支持单值插槽，假设它们的形状为 `Scalar`。


| V1 结构 | V2 结构 | 
| --- | --- | 
|  currentIntent.slots  |  sessionState.intent.slots 或 interpretations[0].intent.slots  | 
|  currentIntent.slots[\$1].value  |  sessionState.intent.slots[\$1].value.interpretedValue 或 interpretations[0].intent.slots[\$1].value.interpretedValue  | 
|  不适用  |  sessionState.intent.slots[\$1].value.shape 或 interpretations[0].intent.slots[\$1].shape  | 
|  不适用  |  sessionState.intent.slots[\$1].values 或 interpretations[0].intent.slots[\$1].values  | 
|  currentIntent.slotDetails  |  sessionState.intent.slots 或 interpretations[0].intent.slots  | 
|  currentIntent.slotDetails[\$1].resolutions  |  sessionState.intent.slots[\$1].resolvedValues 或 interpretations[0].intent.slots[\$1].resolvedValues  | 
|  currentIntent.slotDetails[\$1].originalValue  |  sessionState.intent.slots[\$1].originalValue 或 interpretations[0].intent.slots[\$1].originalValue  | 

#### 其他
<a name="lambda-migrating-other"></a>

Amazon Lex V2 `sessionId` 字段与 Amazon Lex V1 中的 `userId` 字段相同。Amazon Lex V2 还会发送呼叫方的 `inputMode`：文本、DTMF 或语音。


| V1 结构 | V2 结构 | 
| --- | --- | 
|  userId  |  sessionId  | 
|  inputTranscript  |  inputTranscript  | 
|  invocationSource  |  invocationSource  | 
|  outputDialogMode  |  responseContentType  | 
|  messageVersion  |  messageVersion  | 
|  sessionAttributes  |  sessionState.sessionAttributes  | 
|  requestAttributes  |  requestAttributes  | 
|  不适用  |  inputMode  | 
|  不适用  |  originatingRequestId  | 

### 响应
<a name="migrating-lambda-response"></a>

以下字段已经以 Lambda 函数响应消息格式进行了更新。

#### 活动的上下文
<a name="lambda-migrating-resonse-context"></a>

`activeContexts` 结构已移至 `sessionState` 结构。


| V1 结构 | V2 结构 | 
| --- | --- | 
|  activeContexts  |  sessionState.activeContexts  | 
|  ActiveContext [\$1]。 timeToLive  |  sessionState.activeContexts [ timeToLive  | 
|  ActiveContext [\$1]。 timeToLive。 timeToLiveInSeconds  |  sessionState.activeContexts [ timeToLive。 timeToLiveInSeconds  | 
|  ActiveContext [\$1]。 timeToLive。 turnsToLive  |  sessionState.activeContexts [ timeToLive。 turnsToLive  | 
|  activeContexts[\$1].name  |  sessionState.activeContexts[\$1].name  | 
|  activeContexts[\$1].parameters  |  sessionState.activeContexts[\$1].contextAttributes  | 

#### 对话操作
<a name="lambda-migrating-response-dialog"></a>

`dialogAction` 结构已移至 `sessionState` 结构。现在，您可以在对话框操作中指定多条消息，`genericAttachments` 结构现在是 `imageResponseCard` 结构。


| V1 结构 | V2 结构 | 
| --- | --- | 
|  dialogAction  |  sessionState.dialogAction  | 
|  dialogAction.type  |  sessionState.dialogAction.type  | 
|  DialogAction。 slotToElicit  |  sessionState.intent.dialog slotToElicit  | 
|  dialogAction.type.fulfillmentState  |  sessionState.intent.state  | 
|  dialogAction.message  |  消息  | 
|  dialogAction.message.contentType  |  messages[\$1].contentType  | 
|  dialogAction.message.content  |  messages[\$1].content  | 
|  dialogAction.responseCard  |  消息 [\$1]。 imageResponseCard  | 
|  dialogAction.responseCard.version  |  不适用  | 
|  dialogAction.responseCard.contentType  |  messages[\$1].contentType  | 
|  dialogAction.responseCard.genericAttachments  |  不适用  | 
|  dialogAction.responseCard.genericAttachments[\$1].title  |  消息 [\$1]。 imageResponseCard. 标题  | 
|  dialogAction.responseCard.genericAttachments[\$1].subTitle  |  消息 [\$1]。 imageResponseCard.subtitle  | 
|  dialogAction.responseCard.genericAttachments[\$1].imageUrl  |  消息 [\$1]。 imageResponseCard.imageUrl  | 
|  dialogAction.responseCard.genericAttachments[\$1].buttons  |  消息 [\$1]。 imageResponseCard. 按钮  | 
|  dialogAction.responseCard.genericAttachments[\$1].buttons[\$1].value  |  消息 [\$1]。 imageResponseCard.buttons [\$1] .value  | 
|  dialogAction.responseCard.genericAttachments[\$1].buttons[\$1].text  |  消息 [\$1]。 imageResponseCard.buttons [\$1] .text  | 
|  DialogAction。 kendraQueryRequest有效载荷  |  DialogAction。 kendraQueryRequest有效载荷  | 
|  DialogAction。 kendraQueryFilter字符串  |  DialogAction。 kendraQueryFilter字符串  | 

#### 意图和插槽
<a name="lambda-migrating-response-slots"></a>

作为 `dialogAction` 结构一部分的意图和插槽字段现在已成为 `sessionState` 结构的一部分。


| V1 结构 | V2 结构 | 
| --- | --- | 
|  dialogAction.intentName  |  sessionState.intent.name  | 
|  dialogAction.slots  |  sessionState.intent.slots  | 
|  dialogAction.slots[\$1].key  |  sessionState.intent.slots[\$1].key  | 
|  dialogAction.slots[\$1].value  |  sessionState.intent.slots[\$1].value.interpretedValue  | 
|  不适用  |  sessionState.intent.slots[\$1].value.shape  | 
|  不适用  |  sessionState.intent.slots[\$1].values  | 

#### 其他
<a name="lambda-migrating-response-other"></a>

`sessionAttributes` 结构现在是 `sessionState` 结构的一部分。`recentIntentSummaryReview` 结构已删除。


| V1 结构 | V2 结构 | 
| --- | --- | 
|  sessionAttributes  |  sessionState.sessionAttributes  | 
|  recentIntentSummary查看  |  不适用  |