設定對話日誌 - Amazon Lex V1

如果您使用的是 Amazon Lex V2,請改參閱 Amazon Lex V2 指南

 

如果您使用的是 Amazon Lex V1,建議您將機器人升級至 Amazon Lex V2。我們不再將新功能新增至 V1,強烈建議所有新機器人都使用 V2。

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

設定對話日誌

您可以使用主控台或 PutBotAlias 操作的 conversationLogs 欄位,啟用和停用對話日誌。您可以開啟或關閉音訊日誌、文字日誌或兩者。記錄會在新的機器人工作階段開始。對於作用中的工作階段,不會反映日誌設定的變更。

若要存放文字日誌,請在您的AWS帳戶中使用 Amazon CloudWatch 日誌日誌群組。您可以使用任何有效的日誌群組。日誌群組必須和 Amazon Lex 機器人位於相同的區域中。如需有關建立 CloudWatch 日誌群組的詳細資訊,請參閱《Amazon Lo CloudWatch gs 使用者指南》中的使用者指南中的使用者指南中的使用者指南

若要存放音訊日誌,請在您的AWS帳戶中使用 Amazon S3 儲存貯體。您可以使用任何有效的 S3 儲存貯體。儲存貯體必須和 Amazon Lex 機器人位於相同的區域中。如需有關建立 S3 儲存貯體的詳細資訊,請參閱《Amazon Simple Storage Service 入門指南》中的建立儲存貯體。

您必須提供 IAM 角色,其中包含允許 Amazon Lex 寫入已設定的日誌群組或儲存貯體的政策。如需詳細資訊,請參閱建立對話日誌的 IAM 角色和政策

如果您使用建立服務連結角色AWS Command Line Interface,則必須使用下列custom-suffix選項將自訂尾碼新增至角色:

aws iam create-service-linked-role \ --aws-service-name lex.amazon.aws.com \ --custom-suffix suffix

您用來啟用交談記錄的 IAM 角色必須具有iam:PassRole權限。下列政策應連接至角色。

{ "Version": "2012-10-17", "Statement": [ { "Effect": "Allow", "Action": "iam:PassRole", "Resource": "arn:aws:iam::account:role/role" } ] }

啟用對話日誌

使用主控台開啟日誌
  1. 打開 Amazon Lex 控制台 https://console.aws.amazon.com/lex

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

  3. 選擇 Settings (設定) 標籤,然後從左側功能表中選擇 Conversation logs (對話日誌)

  4. 在別名清單中,為您要設定對話日誌的別名選擇設定圖示。

  5. 選取要記錄文字、音訊或兩者。

  6. 對於文字記錄,請輸入 Amazon CloudWatch 日誌記錄群組名稱。

  7. 若要記錄音訊,請輸入 S3 儲存貯體資訊。

  8. 選用。若要加密音訊日誌,請選擇要用於加密的 AWS KMS 金鑰。

  9. 選擇具有必要許可的 IAM 角色。

  10. 選擇 Save (儲存) 以開始記錄對話。

使用 API 開啟文字日誌
  1. 使用 conversationLogs 欄位的 logSettings 成員中的項目呼叫 PutBotAlias 操作

    • destination 成員設定為 CLOUDWATCH_LOGS

    • logType 成員設定為 TEXT

    • resourceArn成員設定為日誌目標之日誌群組 (ARN) 的日誌群組的 CloudWatch 日誌群組的日誌群組的 Amazon Resource Name (ARN)

  2. iamRoleArn IAM 角色的 Amazon Resource Name (ARN) 設定為在指定 Resource Name (ARN)。conversationLogs

使用 API 開啟音訊日誌
  1. 使用 conversationLogs 欄位的 logSettings 成員中的項目呼叫 PutBotAlias 操作

    • destination 成員設定為 S3

    • logType 成員設定為 AUDIO

    • resourceArn 成員設定為音訊日誌儲存所在之 Amazon S3 儲存貯體的 ARN

    • 選用。若要使用特定 AWS KMS 金鑰加密音訊日誌,請設定金鑰 ARN 的 kmsKeyArn 成員,而此金鑰用於加密。

  2. iamRoleArn IAM 角色的 Amazon Resource Name (ARN) 設定為在指定 Resource Name (ARN)。conversationLogs

停用對話日誌

使用主控台關閉日誌
  1. 打開 Amazon Lex 控制台 https://console.aws.amazon.com/lex

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

  3. 選擇 Settings (設定) 標籤,然後從左側功能表中選擇 Conversation logs (對話日誌)

  4. 在別名清單中,為您要設定對話日誌的別名選擇設定圖示。

  5. 清除文字、音訊或兩者的核取方塊以關閉記錄。

  6. 選擇 Save (儲存) 以停止記錄對話。

使用 API 關閉日誌
  • 呼叫沒有 conversationLogs 欄位的 PutBotAlias 操作。

使用 API 關閉文字日誌
    • 如果您是記錄音訊

      • 呼叫只對 AUDIO 具有 logSettings 項目的 PutBotAlias 操作。

      • PutBotAlias 操作的呼叫必須沒有 TEXTlogSettings 項目。

    • 如果您不是記錄音訊

      • 呼叫沒有 conversationLogs 欄位的 PutBotAlias 操作。

使用 API 關閉音訊日誌
    • 如果您是記錄文字

      • 呼叫只對 TEXT 具有 logSettings 項目的 PutBotAlias 操作。

      • PutBotAlias 操作的呼叫必須沒有 AUDIOlogSettings 項目。

    • 如果您不是記錄文字

      • 呼叫沒有 conversationLogs 欄位的 PutBotAlias 操作。