步驟 5 (選用)：檢閱資訊流程的詳細資訊 (主控台) - Amazon Lex V1

支援終止通知：2025 年 9 月 15 日， AWS 將停止對 Amazon Lex V1 的支援。2025 年 9 月 15 日之後，您將無法再存取 Amazon Lex V1 主控台或 Amazon Lex V1 資源。如果您使用的是 Amazon Lex V2，請改參閱 Amazon Lex V2 指南。

本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

步驟 5 (選用)：檢閱資訊流程的詳細資訊 (主控台)

本節說明用戶端與 Amazon Lex 之間每個使用者輸入的資訊流程，包括 Lambda 函數的整合。

注意

本節假設用戶端使用PostText執行時間 API 將請求傳送至 Amazon Lex，並相應地顯示請求和回應詳細資訊。如需用戶端與用戶端使用 PostContent API 的 Amazon Lex 之間資訊流程的範例，請參閱 步驟 2a (選用)：檢閱口語化資訊流程的詳細資訊 (主控台) 。

如需 PostText 執行時間 API 的詳細資訊及關於以下步驟所示的請求與回應的更多細節，請參閱 PostText。

  1. 使用者：我想要訂花。

    1. 用戶端 (主控台) 傳送以下 PostText 請求給 Amazon Lex：

      POST /bot/OrderFlowers/alias/$LATEST/user/ignw84y6seypre4xly5rimopuri2xwnd/text
"Content-Type":"application/json"
"Content-Encoding":"amz-1.0"

{
    "inputText": "I would like to order some flowers",
    "sessionAttributes": {}
}

      請求 URI 和內文都會提供資訊給 Amazon Lex：

      • 請求 URI – 提供機器人名稱 ()OrderFlowers、機器人別名 ($LATEST) 和使用者名稱 （識別使用者的隨機字串）。末尾的 text 表示其為 PostText API 請求 (而非 PostContent)。

      • 請求本文 – 包含使用者輸入 (inputText) 和空的 sessionAttributes。用戶端發出第一次請求時，沒有工作階段屬性。稍後將由 Lambda 函數起始這些屬性。

    2. 從 inputText，Amazon Lex 會偵測意圖 (OrderFlowers)。此意圖是以 Lambda 函數設定為程式碼掛鉤，用於使用者資料初始化和驗證。因此，Amazon Lex 透過將下列資訊作為事件資料傳遞，叫用 Lambda 函數：

      {
    "messageVersion": "1.0",
    "invocationSource": "DialogCodeHook",
    "userId": "ignw84y6seypre4xly5rimopuri2xwnd",
    "sessionAttributes": {},
    "bot": {
        "name": "OrderFlowers",
        "alias": null,
        "version": "$LATEST"
    },
    "outputDialogMode": "Text",
    "currentIntent": {
        "name": "OrderFlowers",
        "slots": {
            "PickupTime": null,
            "FlowerType": null,
            "PickupDate": null
        },
        "confirmationStatus": "None"
    }
}

      如需詳細資訊，請參閱輸入事件格式。

      除了用戶端傳送的資訊之外，Amazon Lex 還包含下列其他資料：

      • messageVersion – 目前 Amazon Lex 僅支援 1.0 版本。

      • invocationSource – 表示 Lambda 函數調用的目的。在本例中，目的是執行使用者資料初始化和驗證。目前，Amazon Lex 知道使用者尚未提供所有槽資料以滿足意圖。

      • currentIntent 資訊 – 所有槽值均設定為 null。

    3. 此時，所有槽值都是 null。Lambda 函數沒有可驗證的項目。Lambda 函數會傳回下列回應給 Amazon Lex：

      {
    "sessionAttributes": {},
    "dialogAction": {
        "type": "Delegate",
        "slots": {
            "PickupTime": null,
            "FlowerType": null,
            "PickupDate": null
        }
    }
}

      如需回應格式的相關資訊，請參閱回應格式。

      注意下列事項：

      • dialogAction.type – 透過將此值設定為 Delegate，Lambda 函數會將決定下一個動作步驟的責任委派給 Amazon Lex。

        注意

        如果 Lambda 函數在使用者資料驗證中偵測到任何內容，它會指示 Amazon Lex 接下來要做什麼，如接下來幾個步驟所示。

    4. 根據 dialogAction.type，Amazon Lex 會決定下一個動作。由於沒有任何槽獲得填充，其決定引出 FlowerType 槽的值。服務將選取該槽的其中一個值引出提示「您想要訂購哪一種花？」，然後傳回以下回應給用戶端：

      包含對 FlowerType 槽之請求的 JSON 資料。

      用戶端顯示回應中的訊息。

  2. 使用者：玫瑰

    1. 用戶端會將下列PostText請求傳送至 Amazon Lex：

      POST /bot/OrderFlowers/alias/$LATEST/user/ignw84y6seypre4xly5rimopuri2xwnd/text
"Content-Type":"application/json"
"Content-Encoding":"amz-1.0"

{
    "inputText": "roses",
    "sessionAttributes": {}
}

      請求內文中的 inputText 會提供使用者輸入。sessionAttributes 仍為空白。

    2. Amazon Lex 會先在目前意圖的內容inputText中解譯 。服務會記住其已向具體使用者詢問過有關 FlowerType 槽的資訊。它會更新目前意圖中的槽值，並使用下列事件資料叫用 Lambda 函數：

      {
    "messageVersion": "1.0",
    "invocationSource": "DialogCodeHook",
    "userId": "ignw84y6seypre4xly5rimopuri2xwnd",
    "sessionAttributes": {},
    "bot": {
        "name": "OrderFlowers",
        "alias": null,
        "version": "$LATEST"
    },
    "outputDialogMode": "Text",
    "currentIntent": {
        "name": "OrderFlowers",
        "slots": {
            "PickupTime": null,
            "FlowerType": "roses",
            "PickupDate": null
        },
        "confirmationStatus": "None"
    }
}

      注意下列事項：

      • invocationSource – 仍為 DialogCodeHook (僅驗證使用者資料)。

      • currentIntent.slots – Amazon Lex 已將FlowerType插槽更新為玫瑰。

    3. 根據 invocationSource的值DialogCodeHook，Lambda 函數會執行使用者資料驗證。它將 roses識別為有效的槽值 （並Price設定為工作階段屬性），並將下列回應傳回給 Amazon Lex。

      {
    "sessionAttributes": {
        "Price": 25
    },
    "dialogAction": {
        "type": "Delegate",
        "slots": {
            "PickupTime": null,
            "FlowerType": "roses",
            "PickupDate": null
        }
    }
}

      注意下列事項：

      • sessionAttributes – Lambda 函數已新增 Price（玫瑰的） 做為工作階段屬性。

      • dialogAction.type – 設定為 Delegate。使用者資料有效，因此 Lambda 函數會指示 Amazon Lex 選擇下一個動作。

       

    4. 根據 dialogAction.type，Amazon Lex 選擇下一個動作。Amazon Lex 知道它需要更多槽資料，因此會根據意圖組態，挑選具有最高優先順序的下一個未填充槽 (PickupDate)。Amazon Lex 會根據意圖組態，選取其中一個引出值提示訊息：「您希望玫瑰在哪一天被撿起？」，針對此槽傳送下列回應回用戶端：

      傳送給用戶端以要求提供 PickupData 槽資訊的 JSON 資料。

      用戶端將顯示回應中的訊息 –「您想要在哪一天拿取玫瑰？」

  3. 使用者：明天

    1. 用戶端會將下列PostText請求傳送至 Amazon Lex：

      POST /bot/OrderFlowers/alias/$LATEST/user/ignw84y6seypre4xly5rimopuri2xwnd/text
"Content-Type":"application/json"
"Content-Encoding":"amz-1.0"

{
    "inputText": "tomorrow",
    "sessionAttributes": {
        "Price": "25"
    }
}

      請求內文中的 inputText 會提供使用者輸入，且用戶端會將工作階段屬性傳回給服務。

    2. Amazon Lex 會記住內容，也就是它正在為PickupDate插槽引出資料。在此情況下，服務知道 inputText 值是用於 PickupDate 槽。然後，Amazon Lex 會傳送下列事件來叫用 Lambda 函數：

      {
    "messageVersion": "1.0",
    "invocationSource": "DialogCodeHook",
    "userId": "ignw84y6seypre4xly5rimopuri2xwnd",
    "sessionAttributes": {
        "Price": "25"
    },
    "bot": {
        "name": "OrderFlowersCustomWithRespCard",
        "alias": null,
        "version": "$LATEST"
    },
    "outputDialogMode": "Text",
    "currentIntent": {
        "name": "OrderFlowers",
        "slots": {
            "PickupTime": null,
            "FlowerType": "roses",
            "PickupDate": "2017-01-05"
        },
        "confirmationStatus": "None"
    }
}

      Amazon Lex 已currentIntent.slots透過設定 PickupDate值來更新 。另請注意， 服務sessionAttributes會將 傳遞至 Lambda 函數。

    3. 根據 invocationSource的值DialogCodeHook，Lambda 函數會執行使用者資料驗證。它會辨識PickupDate槽值是否有效，並傳回下列回應給 Amazon Lex：

      {
    "sessionAttributes": {
        "Price": 25
    },
    "dialogAction": {
        "type": "Delegate",
        "slots": {
            "PickupTime": null,
            "FlowerType": "roses",
            "PickupDate": "2017-01-05"
        }
    }
}

      注意下列事項：

      • sessionAttributes – 未改變。

      • dialogAction.type – 設定為 Delegate。使用者資料有效，Lambda 函數會指示 Amazon Lex 選擇下一個動作。

    4. 根據 dialogAction.type，Amazon Lex 選擇下一個動作。Amazon Lex 知道它需要更多槽資料，因此會根據意圖組態，挑選具有最高優先順序的下一個未填充槽 (PickupTime)。Amazon Lex 會根據意圖組態為此槽選取其中一個提示訊息 (「在 2017-01-05 的什麼時間交付玫瑰？」)，並將下列回應傳回給用戶端：

      要求提供 PickupTime 槽資訊的 JSON 資料。

      用戶端會在回應中顯示訊息 –「在 2017-01-05 的什麼時間交付玫瑰？」

  4. 使用者：下午 4 點

    1. 用戶端會將下列PostText請求傳送至 Amazon Lex：

      POST /bot/OrderFlowers/alias/$LATEST/user/ignw84y6seypre4xly5rimopuri2xwnd/text
"Content-Type":"application/json"
"Content-Encoding":"amz-1.0"

{
    "inputText": "4 pm",
    "sessionAttributes": {
        "Price": "25"
    }
}

      請求內文中的 inputText 會提供使用者輸入。用戶端將在請求中傳遞 sessionAttributes。

    2. Amazon Lex 了解內容。其明白這是稍早引出的 PickupTime 槽的資料。在這種情況下，它知道inputText值適用於 PickupTime槽。然後，Amazon Lex 會傳送下列事件來叫用 Lambda 函數：

      {
    "messageVersion": "1.0",
    "invocationSource": "DialogCodeHook",
    "userId": "ignw84y6seypre4xly5rimopuri2xwnd",
    "sessionAttributes": {
        "Price": "25"
    },
    "bot": {
        "name": "OrderFlowersCustomWithRespCard",
        "alias": null,
        "version": "$LATEST"
    },
    "outputDialogMode": "Text",
    "currentIntent": {
        "name": "OrderFlowers",
        "slots": {
            "PickupTime": "16:00",
            "FlowerType": "roses",
            "PickupDate": "2017-01-05"
        },
        "confirmationStatus": "None"
    }
}

      Amazon Lex 已currentIntent.slots透過設定 PickupTime值來更新 。

    3. 根據 invocationSource的值DialogCodeHook，Lambda 函數會執行使用者資料驗證。它會辨識PickupDate槽值是否有效，並傳回下列回應給 Amazon Lex。

      {
    "sessionAttributes": {
        "Price": 25
    },
    "dialogAction": {
        "type": "Delegate",
        "slots": {
            "PickupTime": "16:00",
            "FlowerType": "roses",
            "PickupDate": "2017-01-05"
        }
    }
}

      注意下列事項：

      • sessionAttributes – 工作階段屬性未改變。

      • dialogAction.type – 設定為 Delegate。使用者資料有效，因此 Lambda 函數會指示 Amazon Lex 選擇下一個動作。

    4. 目前，Amazon Lex 知道它擁有所有槽資料。該意圖設定了一則確認提示。因此，Amazon Lex 會傳送下列回應給使用者，要求在滿足意圖之前進行確認：

      要求確認訂購的 JSON 資料。

      用戶端將顯示回應中的訊息並等待使用者回應。

  5. 使用者：好

    1. 用戶端會將下列PostText請求傳送至 Amazon Lex：

      POST /bot/OrderFlowers/alias/$LATEST/user/ignw84y6seypre4xly5rimopuri2xwnd/text
"Content-Type":"application/json"
"Content-Encoding":"amz-1.0"

{
    "inputText": "yes",
    "sessionAttributes": {
        "Price": "25"
    }
}

    2. Amazon Lex 會在確認目前意圖inputText的情況下解譯 。Amazon Lex 了解使用者想要繼續訂單。這次 Amazon Lex 會呼叫 Lambda 函數，透過傳送下列事件來實現意圖，這會在傳送至 Lambda 函數invocationSourceFulfillmentCodeHook時將 設定為 。Amazon Lex 也會將 confirmationStatus設定為 Confirmed。

      {
    "messageVersion": "1.0",
    "invocationSource": "FulfillmentCodeHook",
    "userId": "ignw84y6seypre4xly5rimopuri2xwnd",
    "sessionAttributes": {
        "Price": "25"
    },
    "bot": {
        "name": "OrderFlowersCustomWithRespCard",
        "alias": null,
        "version": "$LATEST"
    },
    "outputDialogMode": "Text",
    "currentIntent": {
        "name": "OrderFlowers",
        "slots": {
            "PickupTime": "16:00",
            "FlowerType": "roses",
            "PickupDate": "2017-01-05"
        },
        "confirmationStatus": "Confirmed"
    }
}

      注意下列事項：

      • invocationSource – 這次 Amazon Lex 將此值設定為 FulfillmentCodeHook，指示 Lambda 函數滿足意圖。

      • confirmationStatus – 設定為 Confirmed。

    3. 這次 Lambda 函數會滿足OrderFlowers意圖，並傳回下列回應：

      {
    "sessionAttributes": {
        "Price": "25"
    },
    "dialogAction": {
        "type": "Close",
        "fulfillmentState": "Fulfilled",
        "message": {
            "contentType": "PlainText",
            "content": "Thanks, your order for roses has been placed and will be ready for pickup by 16:00 on 2017-01-05"
        }
    }
}

      注意下列事項：

      • 設定 dialogAction.type- Lambda 函數將此值設定為 Close，指示 Amazon Lex 不預期使用者回應。

      • dialogAction.fulfillmentState – 設定為 Fulfilled 且附上相應的 message 以傳達給使用者。

    4. Amazon Lex 會檢閱 ，fulfillmentState並將下列回應傳回給用戶端。

      然後，Amazon Lex 會將下列項目傳回給用戶端：

      確認提示的 JSON 資料。

      請注意：

      • dialogState – Amazon Lex 將此值設定為 fulfilled。

      • message – 是 Lambda 函數提供的相同訊息。

      用戶端將顯示該訊息。

  6. 現在，再次測試機器人。要建立新的 (使用者) 內容，請由測試視窗選擇 Clear (清除) 連結。接著為 OrderFlowers 意圖提供無效的槽資料。這次 Lambda 函數會執行資料驗證、將無效的槽資料值重設為 null，並要求 Amazon Lex 提示使用者提供有效的資料。例如，嘗試以下操作：

    • 花種為「茉莉」(此花種不受支援)，

    • 想要取花的日期為「昨天」。

    • 下單後再輸入其他花種，而不要回覆「好」確認下單。為了回應，Lambda 函數會更新工作階段屬性Price中的 ，保持花訂單的執行總數。

    Lambda 函數也會執行履行活動。

後續步驟

步驟 6：更新意圖組態以加入表達用語 (主控台)