支援終止通知：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)。
本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。
# 設定對話日誌
您可以使用主控台或 `PutBotAlias` 操作的 `conversationLogs` 欄位，啟用和停用對話日誌。您可以開啟或關閉音訊日誌、文字日誌或兩者。記錄會在新的機器人工作階段開始。對於作用中的工作階段，不會反映日誌設定的變更。
若要存放文字日誌，請在 AWS 您的帳戶中使用 Amazon CloudWatch Logs 日誌群組。您可以使用任何有效的日誌群組。日誌群組必須與 Amazon Lex 機器人位於相同的區域。如需建立 CloudWatch Logs 日誌群組的詳細資訊，請參閱《*Amazon CloudWatch Logs 使用者指南》中的*[使用日誌群組和日誌串流](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/Working-with-log-groups-and-streams.html)。
若要存放音訊日誌，請在 AWS 您的帳戶中使用 Amazon S3 儲存貯體。您可以使用任何有效的 S3 儲存貯體。儲存貯體必須與 Amazon Lex 機器人位於相同的區域。如需建立 S3 儲存貯體的詳細資訊，請參閱《*Amazon Simple Storage Service 入門指南*》中的[建立儲存貯體](https://docs.aws.amazon.com/AmazonS3/latest/gsg/CreatingABucket.html)。
您必須為 IAM 角色提供政策，讓 Amazon Lex 能夠寫入已設定的日誌群組或儲存貯體。如需詳細資訊，請參閱[建立對話日誌的 IAM 角色和政策](conversation-logs-policies.md#conversation-logs-role-and-policy)。
如果您使用 建立服務連結角色 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`許可。下列政策應連接至角色。
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": "iam:PassRole",
"Resource": "arn:aws:iam::111122223333:role/role"
}
]
}
```
------
## 啟用對話日誌
**使用主控台開啟日誌**
1. 開啟 Amazon Lex 主控台 https：//[https://console.aws.amazon.com/lex](https://console.aws.amazon.com/lex)。
1. 從清單中選擇一個機器人。
1. 選擇 **Settings (設定)** 標籤，然後從左側功能表中選擇 **Conversation logs (對話日誌)**。
1. 在別名清單中，為您要設定對話日誌的別名選擇設定圖示。
1. 選取要記錄文字、音訊或兩者。
1. 針對文字記錄，輸入 Amazon CloudWatch Logs 日誌群組名稱。
1. 若要記錄音訊，請輸入 S3 儲存貯體資訊。
1. 選用。若要加密音訊日誌，請選擇用於加密的 AWS KMS 金鑰。
1. 選擇具有必要許可的 IAM 角色。
1. 選擇 **Save (儲存)** 以開始記錄對話。
**使用 API 開啟文字日誌**
1. 使用 `conversationLogs` 欄位的 `logSettings` 成員中的項目呼叫 [PutBotAlias](API_PutBotAlias.md) 操作
+ 將 `destination` 成員設定為 `CLOUDWATCH_LOGS`
+ 將 `logType` 成員設定為 `TEXT`
+ 將`resourceArn`成員設定為 CloudWatch Logs 日誌群組的 Amazon Resource Name (ARN)，這是日誌的目的地
1. 將 `conversationLogs` 欄位`iamRoleArn`的成員設定為 IAM 角色的 Amazon Resource Name (ARN)，該角色具有在指定資源上啟用對話日誌所需的許可。
**使用 API 開啟音訊日誌**
1. 使用 `conversationLogs` 欄位的 `logSettings` 成員中的項目呼叫 [PutBotAlias](API_PutBotAlias.md) 操作
+ 將 `destination` 成員設定為 `S3`
+ 將 `logType` 成員設定為 `AUDIO`
+ 將 `resourceArn` 成員設定為音訊日誌儲存所在之 Amazon S3 儲存貯體的 ARN
+ 選用。若要使用特定 AWS KMS 金鑰加密音訊日誌，請設定用於加密之金鑰的 ARN `kmsKeyArn`成員。
1. 將 `conversationLogs` 欄位`iamRoleArn`的成員設定為 IAM 角色的 Amazon Resource Name (ARN)，該角色具有在指定資源上啟用對話日誌所需的許可。
## 停用對話日誌
**使用主控台關閉日誌**
1. 開啟 Amazon Lex 主控台 https：//[https://console.aws.amazon.com/lex](https://console.aws.amazon.com/lex)。
1. 從清單中選擇一個機器人。
1. 選擇 **Settings (設定)** 標籤，然後從左側功能表中選擇 **Conversation logs (對話日誌)**。
1. 在別名清單中，為您要設定對話日誌的別名選擇設定圖示。
1. 清除文字、音訊或兩者的核取方塊以關閉記錄。
1. 選擇 **Save (儲存)** 以停止記錄對話。
**使用 API 關閉日誌**
+ 呼叫沒有 `conversationLogs` 欄位的 `PutBotAlias` 操作。
**使用 API 關閉文字日誌**
+
+ 如果您是記錄音訊
+ 呼叫只對 `AUDIO` 具有 `logSettings` 項目的 [PutBotAlias](API_PutBotAlias.md) 操作。
+ 對 `PutBotAlias` 操作的呼叫必須沒有 `TEXT` 的 `logSettings` 項目。
+ 如果您不是記錄音訊
+ 呼叫沒有 `conversationLogs` 欄位的 [PutBotAlias](API_PutBotAlias.md) 操作。
**使用 API 關閉音訊日誌**
+
+ 如果您是記錄文字
+ 呼叫只對 `TEXT` 具有 `logSettings` 項目的 [PutBotAlias](API_PutBotAlias.md) 操作。
+ 對 `PutBotAlias` 操作的呼叫必須沒有 `AUDIO` 的 `logSettings` 項目。
+ 如果您不是記錄文字
+ 呼叫沒有 `conversationLogs` 欄位的 [PutBotAlias](API_PutBotAlias.md) 操作。