支援終止通知：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 會將 `currentIntent`和 `alternativeIntents` 結構取代為 `interpretations`結構。每個解釋都包含意圖、意圖的 NLU 可信度分數，以及選用的情緒分析。
+ Amazon Lex V2 會將 Amazon Lex V1 `activeContexts``sessionAttributes`中的 移至統一`sessionState`結構。此結構提供對話目前狀態的相關資訊，包括原始請求 ID。
+ Amazon Lex V2 不會傳回 `recentIntentSummaryView`。請改用 `sessionState`結構中的資訊。
+ Amazon Lex V2 輸入在 `bot` 屬性`localeId`中提供 `botId`和 。
+ 輸入結構包含 `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  | 
|  activeContexts【\$1】.timeToLive  |  sessionState.activeContexts[\$1].timeToLive  | 
|  activeContexts【\$1】.timeToLive.timeToLiveInSeconds  |  sessionState.activeContexts[\$1].timeToLive.timeToLiveInSeconds  | 
|  activeContexts【\$1】.timeToLive.turnsToLive  |  sessionState.activeContexts[\$1].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】  | 
|  recentIntentSummaryView  |  N/A  | 

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

在 Amazon Lex V2 中，機器人和別名具有識別符。機器人 ID 是 Codehook 輸入的一部分。包含別名 ID，但不包含別名名稱。Amazon Lex V2 支援相同機器人的多個地區設定，因此包含地區設定 ID。


| V1 結構 | V2 結構 | 
| --- | --- | 
|  機器人  |  機器人  | 
|  bot.name  |  bot.name  | 
|  N/A  |  bot.id  | 
|  bot.alias  |  N/A  | 
|  N/A  |  bot.aliasId  | 
|  bot.version  |  bot.version  | 
|  N/A  |  bot.localeId  | 

#### 目前意圖
<a name="lambda-migrating-intent"></a>

`sessionState.intent` 結構包含作用中意圖的詳細資訊。Amazon Lex V2 也會傳回`interpretations`結構中所有意圖的清單，包括替代意圖。解譯清單中的第一個元素一律與 相同`sessionState.intent`。


| V1 結構 | V2 結構 | 
| --- | --- | 
|  currentIntent  |  sessionState.intent OR 解釋【0】.intent  | 
|  currentIntent.name  |  sessionState.intent.name OR 解釋 【0】.intent.name  | 
|  currentIntent.nluConfidenceScore  |  interpretations【0】.nluConfidence.score  | 

#### 對話方塊動作
<a name="lambda-migrating-dialog"></a>

`confirmationStatus` 欄位現在是 `sessionState` 結構的一部分。


| V1 結構 | V2 結構 | 
| --- | --- | 
|  currentIntent.confirmationStatus  |  sessionState.intent.confirmationState OR interpretations【0】.intent.confirmationState  | 
|  N/A  |  sessionState.intent.state OR 解釋 【\$1】.intent.state  | 

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

`kendraResponse` 欄位現在是 `sessionState`和 `interpretations`結構的一部分。


| V1 結構 | V2 結構 | 
| --- | --- | 
|  kendraResponse  |  sessionState.intent.kendraResponse OR 解釋 【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 OR interpretations【0】.intent.slots  | 
|  currentIntent.slots[\$1].value  |  sessionState.intent.slots[\$1].value.interpretedValue OR interpretations【0】.intent.slots【\$1】.value.interpretedValue  | 
|  N/A  |  sessionState.intent.slots[\$1].value.shape OR interpretations【0】.intent.slots【\$1】.shape  | 
|  N/A  |  sessionState.intent.slots[\$1].values OR interpretations【0】.intent.slots【\$1】.values  | 
|  currentIntent.slotDetails  |  sessionState.intent.slots OR interpretations【0】.intent.slots  | 
|  currentIntent.slotDetails[\$1].resolutions  |  sessionState.intent.slots[\$1].resolvedValues OR interpretations【0】.intent.slots【\$1】.resolvedValues  | 
|  currentIntent.slotDetails[\$1].originalValue  |  sessionState.intent.slots[\$1].originalValue OR 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  | 
|  N/A  |  inputMode  | 
|  N/A  |  originatingRequestId  | 

### 回應
<a name="migrating-lambda-response"></a>

下列欄位已在 Lambda 函數回應訊息格式中變更。

#### 作用中內容
<a name="lambda-migrating-resonse-context"></a>

`activeContexts` 結構已移至 `sessionState`結構。


| V1 結構 | V2 結構 | 
| --- | --- | 
|  activeContexts  |  sessionState.activeContexts  | 
|  activeContexts【\$1】.timeToLive  |  sessionState.activeContexts[\$1].timeToLive  | 
|  activeContexts【\$1】.timeToLive.timeToLiveInSeconds  |  sessionState.activeContexts[\$1].timeToLive.timeToLiveInSeconds  | 
|  activeContexts【\$1】.timeToLive.turnsToLive  |  sessionState.activeContexts[\$1].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.dialogAction.slotToElicit  | 
|  dialogAction.type.fulfillmentState  |  sessionState.intent.state  | 
|  dialogAction.message  |  messages  | 
|  dialogAction.message.contentType  |  messages【\$1】.contentType  | 
|  dialogAction.message.content  |  messages【\$1】.content  | 
|  dialogAction.responseCard  |  messages【\$1】.imageResponseCard  | 
|  dialogAction.responseCard.version  |  N/A  | 
|  dialogAction.responseCard.contentType  |  messages【\$1】.contentType  | 
|  dialogAction.responseCard.genericAttachments  |  N/A  | 
|  dialogAction.responseCard.genericAttachments[\$1].title  |  messages【\$1】.imageResponseCard.title  | 
|  dialogAction.responseCard.genericAttachments[\$1].subTitle  |  messages【\$1】.imageResponseCard.subtitle  | 
|  dialogAction.responseCard.genericAttachments[\$1].imageUrl  |  messages【\$1】.imageResponseCard.imageUrl  | 
|  dialogAction.responseCard.genericAttachments[\$1].buttons  |  messages【\$1】.imageResponseCard.buttons  | 
|  dialogAction.responseCard.genericAttachments[\$1].buttons[\$1].value  |  messages【\$1】.imageResponseCard.buttons[\$1].value  | 
|  dialogAction.responseCard.genericAttachments[\$1].buttons[\$1].text  |  messages【\$1】.imageResponseCard.buttons[\$1].text  | 
|  dialogAction.kendraQueryRequestPayload  |  dialogAction.kendraQueryRequestPayload  | 
|  dialogAction.kendraQueryFilterString  |  dialogAction.kendraQueryFilterString  | 

#### 意圖和槽
<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  | 
|  N/A  |  sessionState.intent.slots[\$1].value.shape  | 
|  N/A  |  sessionState.intent.slots[\$1].values  | 

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

`sessionAttributes` 結構現在是`sessionState`結構的一部分。結構`recentIntentSummaryReview`已移除。


| V1 結構 | V2 結構 | 
| --- | --- | 
|  sessionAttributes  |  sessionState.sessionAttributes  | 
|  recentIntentSummaryView  |  N/A  |