在 Amazon 日誌中查看文本 CloudWatch 日誌 - Amazon Lex

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

在 Amazon 日誌中查看文本 CloudWatch 日誌

Amazon Lex V2 會將您對話的文字日誌儲存在 Amazon CloudWatch 日誌中。若要檢視記錄檔，請使用 CloudWatch 記錄主控台或 API。如需詳細資訊，請參閱 Amazon Logs 使用者指南中的使用篩選器模式和CloudWatch 日誌見解查詢語法搜尋 CloudWatch 日誌資料。

若要使用 Amazon Lex V2 主控台檢視日誌

  1. 打開 Amazon Lex V2 控制台 https://console.aws.amazon.com/lexv2。

  2. 從清單中選擇一個機器人。

  3. 從左側功能表中選擇「分析」，然後選擇CloudWatch 指標。

  4. 在指標頁面上檢視機器人的CloudWatch 指標。

您也可以使用主 CloudWatch 控台或 API 來檢視您的記錄項目。若要尋找日誌項目，請導覽至您針對別名設定的日誌群組。您可以在 Amazon Lex V2 主控台或使用DescribeBot別名作業，找到日誌的日誌串流前置詞。

您可以在多個記錄串流中找到使用者語音的記錄項目。對話中的表達用語在其中一個日誌串流中具有指定前綴的項目。記錄資料流中的項目包含下列資訊：

訊息版

訊息結構描述版本。

機器人

有關客戶正在與之互動的機器人的詳細信息。

messages

機器人傳回給使用者的回應。

语言上下文

有關處理此語音的資訊。

工作階段狀態

使用者與機器人之間交談的目前狀態。如需詳細資訊，請參閱 管理對話。

解釋

Amazon Lex V2 確定的意圖清單可以滿足使用者的話語。 使用可信度分數。

解釋來源

表示插槽是否由 Amazon Lex 或 Amazon 基岩解決。價值觀：Lex | 基岩

sessionId

具有交談之使用者工作階段的識別碼。

inputTranscript

來自用戶的輸入的轉錄。

  • 對於文字輸入，這是使用者輸入的文字。對於 DTMF 輸入，這是使用者輸入的金鑰。

  • 對於語音輸入，這是 Amazon Lex V2 將使用者語音轉換成的文字，以叫用意圖或填滿插槽。

原始 InputTranscript

在套用任何文字處理之前，使用者輸入的原始成績單。注意：文字處理僅適用於 en-US 和 en-GB 地區設定。

抄錄

用戶輸入的潛在轉錄列表。如需詳細資訊，請參閱 使用語音轉錄信心分數。

原始转录

使用語音轉錄信心得分。如需詳細資訊，請參閱 使用語音轉錄信心分數。

失誤行為

指出 Amazon Lex V2 是否能夠辨識使用者的話語。

requestId

Amazon Lex V2 為使用者輸入產生的請求識別碼。

timestamp

使用者輸入的時間戳記。

开发者覆盖

指出是否已使用對話方塊程式碼掛接更新交談流程。如需使用對話方塊程式碼掛接的詳細資訊，請參閱〈〉使用AWS Lambda函數啟用自訂邏輯。

輸入模式

指示輸入的類型。可以是音訊、DTMF 或文字。

requestAttributes

處理用戶的輸入時使用的請求屬性。

音訊屬性

如果音訊交談記錄已啟用且使用者輸入為音訊格式，則包括音訊輸入的總持續時間、語音的持續時間和音訊中的靜音持續時間。它還包括指向音頻文件的鏈接。

駁船

指出使用者輸入是否中斷先前的機器人回應。

回應原因

產生回應的原因。可為下列其中一個：

  • UtteranceResponse— 響應用戶輸入

  • StartTimeout-服務器生成的響應時，用戶沒有提供輸入

  • StillWaitingResponse— 當用戶請求機器人等待時，服務器生成的響應

  • FulfillmentInitiated— 服務器生成的響應，履行即將啟動

  • FulfillmentStartedResponse— 服務器生成的響應，履行已經開始

  • FulfillmentUpdateResponse-在履行過程中定期服務器生成的響應

  • FulfillmentCompletedResponse— 服務器在履行完成時生成的響應。

operationName

用來與機器人互動的 API。可以是PutSession、RecognizeText、或其RecognizeUtterance中之一StartConversation。


{
    "message-version": "2.0",
    "bot": {
        "id": "string",
        "name": "string",
        "aliasId": "string",
        "aliasName": "string",
        "localeId": "string",
        "version": "string"
    },
    "messages": [
        {
            "contentType": "PlainText | SSML | CustomPayload | ImageResponseCard",
            "content": "string",
            "imageResponseCard": {
                "title": "string",
                "subtitle": "string",
                "imageUrl": "string",
                "buttonsList": [
                    {
                        "text": "string",
                        "value": "string"
                    }
                ]
            }
        }
    ],
    "utteranceContext": {
        "activeRuntimeHints": {
            "slotHints": {
                "string": {
                    "string": {
                        "runtimeHintValues": [
                            {
                                "phrase": "string"
                            },
                            {
                                "phrase": "string"
                            }
                        ]
                    }
                }
            }
        },
        "slotElicitationStyle": "string"
    },
    "sessionState": {
        "dialogAction": {
            "type": "Close | ConfirmIntent | Delegate | ElicitIntent | ElicitSlot",
            "slotToElicit": "string"
        },
        "intent": {
            "name": "string",
            "slots": {
                "string": { 
                    "value": { 
                       "interpretedValue": "string",
                       "originalValue": "string",
                       "resolvedValues": [ "string" ]
                    }
                 },  
                "string": {
                    "shape": "List",
                    "value": {
                        "originalValue": "string",
                        "interpretedValue": "string",
                        "resolvedValues": [ "string" ]
                    },
                    "values": [
                        {
                            "shape": "Scalar",
                            "value": {
                                "originalValue": "string",
                                "interpretedValue": "string",
                                "resolvedValues": [ "string" ]
                            }
                        },
                        {
                            "shape": "Scalar",
                            "value": {
                                "originalValue": "string",
                                "interpretedValue": "string",
                                "resolvedValues": [ "string" ]
                            }
                        }
                    ]
                }
            },
            "kendraResponse": {
                // Only present when intent is KendraSearchIntent. For details, see 
                // https://docs.aws.amazon.com/kendra/latest/dg/API_Query.html#API_Query_ResponseSyntax
                },
            "state": "InProgress | ReadyForFulfillment | Fulfilled | Failed",
            "confirmationState": "Confirmed | Denied | None"
        },
        "originatingRequestId": "string",
        "sessionAttributes": {
            "string": "string"
        },
        "runtimeHints": {
            "slotHints": {
                "string": {
                    "string": {
                        "runtimeHintValues": [
                            {
                                "phrase": "string"
                            },
                            {
                                "phrase": "string"
                            }
                        ]
                    }
                }
            }
        }
    },
   "dialogEventLogs": [
        {
	  // only for conditional
     "conditionalEvaluationResult":[
      // all the branches until true

     {
     "conditionalBranchName": "string",
     "expressionString": "string",
     "evaluatedExpression": "string",
     "evaluationResult": "true | false"
     }
    ],
  "dialogCodeHookInvocationLabel": "string",
  "response": "string",
  "nextStep": {
        "dialogAction": {
            "type": "Close | ConfirmIntent | Delegate | ElicitIntent | ElicitSlot",
            "slotToElicit": "string"
        },
	      "intent": {
                          "name": "string",
           "slots": {
               }
        }
       }
    ]
    "interpretations": [
        {
            "interpretationSource": "Bedrock | Lex",
            "nluConfidence": "string",
            "intent": {
                "name": "string",
                "slots": {
                    "string": {
                        "value": {
                            "originalValue": "string",
                            "interpretedValue": "string",
                            "resolvedValues": [ "string" ]
                        }
                    },
                    "string": {
                        "shape": "List",
                        "value": {
                            "interpretedValue": "string",
                            "originalValue": "string",
                            "resolvedValues": [ "string" ]
                        },
                        "values": [
                            {
                                "shape": "Scalar",
                                "value": {
                                    "interpretedValue": "string",
                                    "originalValue": "string",
                                    "resolvedValues": [ "string" ]
                                }
                            },
                            {
                                "shape": "Scalar",
                                "value": {
                                    "interpretedValue": "string",
                                    "originalValue": "string",
                                    "resolvedValues": [ "string" ]
                                }

                            }
                        ]
                    }
                },
                "kendraResponse": {
                    // Only present when intent is KendraSearchIntent. For details, see 
                    // https://docs.aws.amazon.com/kendra/latest/dg/API_Query.html#API_Query_ResponseSyntax
                    },
                "state": "InProgress | ReadyForFulfillment | Fulfilled | Failed",
                "confirmationState": "Confirmed | Denied | None"
                },
            "sentimentResponse": {
                "sentiment": "string",
                "sentimentScore": {
                    "positive": "string",
                    "negative": "string",
                    "neutral": "string",
                    "mixed": "string"
                }
            }
        }
    ],
    "sessionId": "string",
    "inputTranscript": "string",
    "rawInputTranscript": "string",
    "transcriptions": [
        {
            "transcription": "string",
            "rawTranscription": "string",
            "transcriptionConfidence": "number",
            },
            "resolvedContext": {
                "intent": "string"
            },
            "resolvedSlots": {
                "string": {
                    "name": "slotName",
                    "shape": "List",
                    "value": { 
                        "originalValue": "string",
                        "resolvedValues": [
                            "string"
                        ]
                    }
                }
            }
        }
    ],
    "missedUtterance": "bool",
    "requestId": "string",
    "timestamp": "string",
    "developerOverride": "bool",
    "inputMode": "DTMF | Speech | Text",
    "requestAttributes": {
        "string": "string"
    },
    "audioProperties": {
        "contentType": "string",
        "s3Path": "string",
        "duration": {
            "total": "integer",
            "voice": "integer",
            "silence": "integer"
        }
    },
    "bargeIn": "string",
    "responseReason": "string",
    "operationName": "string"
}

記錄項目的內容取決於交易的結果以及機器人和要求的組態。

  • 若 missedUtterance 欄位是 true，則 intent、slots 和 slotToElicit 不會顯示在輸入中。

  • 如果音訊日誌已停用或 inputDialogMode 欄位是 Text，則 s3PathForAudio 欄位不會出現。

  • 只有在您為機器人定義回應卡片時，才會顯示 responseCard 欄位。

  • 只有在請求中指定了請求屬性時，才會顯示 requestAttributes 對映。

  • 只有當提出搜索 Amazon Kendra 索引的請求時，該kendraResponseAMAZON.KendraSearchIntent字段才存在。

  • 在機器人的 Lambda 函數中指定替代意圖時，此developerOverride欄位為真。

  • 只有在請求中指定了工作階段屬性時，才會顯示 sessionAttributes 映射。

  • 只有在您設定機器人傳回情緒值時，才會顯示 sentimentResponse 映射。

注意

即使 messageVersion 中沒有對應的變更，輸入格式也可能變更。如果出現新欄位，您的程式碼不應擲出錯誤。