Amazon Lex V2 を使用している場合は、代わりに Amazon Lex V2 ガイドを参照してください。

Amazon Lex V1 を使用している場合は、ボットを Amazon Lex V2 にアップグレードすることをお勧めします。V1 には新機能を追加されませんので、すべての新しいボットには V2 を使用することを強くお勧めします。

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

会話ログの設定

会話ログを有効または無効にするには、コンソールまたは PutBotAlias オペレーションの conversationLogs フィールドを使用します。オーディオログ、テキストログ、またはその両方をオンまたはオフにできます。新しいボットセッションでログ記録が開始されます。ログ設定への変更は、アクティブなセッションでは反映されません。

テキストログを保存するには、AWS アカウントで Amazon CloudWatch Logs ロググループを使用します。任意の有効なロググループを使用できます。ロググループは、Amazon Lex ボットと同じリージョンに存在する必要があります。CloudWatch Logs ロググループの詳細については、「Amazon CloudWatch Logs User Guide」(Amazon CloudWatch Logs ユーザーガイド) の「Working with Log Groups and Log Streams」(ロググループとログストリームの使用) を参照してください。

オーディオログを保存するには、AWS アカウントで Amazon S3 バケットを使用します。任意の有効な S3 バケットを使用できます。バケットは Amazon Lex ボットと同じリージョンにある必要があります。S3 バケットの作成の詳細については、「Amazon Simple Storage Service Getting Started Guide」(Amazon Simple Storage Service 入門ガイド) の「Create a Bucket」(バケットの作成) を参照してください。

設定済みのロググループまたはバケットへの Amazon Lex による書き込みを有効にするポリシーのある IAM ロールを指定する必要があります。詳細については、「会話ログ用の 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"
        }
    ]
}

会話ログの有効化

コンソールを使用してログを有効にするには

Amazon Lex コンソール (https://console.aws.amazon.com/lex) を開きます。
リストからボットを選択します。
[Settings] (設定) タブを選択し、左側のメニューから [Conversation logs] (会話ログ) を選択します。
エイリアスのリストで、会話ログを設定するエイリアスの設定アイコンを選択します。
テキスト、オーディオ、またはその両方をログに記録するかどうかを選択します。
テキストログの場合は、Amazon CloudWatch Logs のロググループ名を入力します。
オーディオのログ記録の場合は、S3 バケット情報を入力します。
オプション。オーディオログを暗号化するには、暗号化に使用する AWS KMS キーを選択します。
必要な権限を持つ IAM ロールを選択します。
[Save] (保存) を選択して、会話のログ記録を開始します。

API を使用してテキストログを有効にするには

conversationLogs フィールドの logSettings メンバーのエントリを使用して PutBotAlias オペレーションを呼び出す
- destination メンバーを CLOUDWATCH_LOGS に設定する
- logType メンバーを TEXT に設定する
- ログの送信先である CloudWatch Logs ロググループの Amazon リソースネーム (ARN) に resourceArn メンバーを設定する
conversationLogs フィールドの iamRoleArn メンバーを、指定したリソースで会話ログを有効にするために必要なアクセス権限を持つ IAM ロールの Amazon リソースネーム (ARN) に設定します。

API を使用してオーディオログを有効にするには

conversationLogs フィールドの logSettings メンバーのエントリを使用して PutBotAlias オペレーションを呼び出す
- destination メンバーを S3 に設定する
- logType メンバーを AUDIO に設定する
- resourceArn メンバーをオーディオログが保存されている Amazon S3 バケットの ARN に設定する
- オプション。特定の AWS KMS キーでオーディオログを暗号化するには、暗号化に使用するキーの ARN の kmsKeyArn メンバーを設定します。
conversationLogs フィールドの iamRoleArn メンバーを、指定したリソースで会話ログを有効にするために必要なアクセス権限を持つ IAM ロールのAmazon リソースネーム (ARN) に設定します。

会話ログの無効化

コンソールを使用してログをオフにするには

Amazon Lex コンソール (https://console.aws.amazon.com/lex) を開きます。
リストからボットを選択します。
[Settings] (設定) タブを選択し、左側のメニューから [Conversation logs] (会話ログ) を選択します。
エイリアスのリストで、会話ログを設定するエイリアスの設定アイコンを選択します。
ログ記録をオフにするには、テキスト、オーディオ、またはその両方からチェックを外します。
会話のログ記録を停止するには、[Save] (保存) を選択します。

API を使用してログをオフにするには

conversationLogs フィールドを使用しないで PutBotAlias オペレーションを呼び出します。

API を使用してテキストログを無効にするには

- オーディオをログ記録する場合
  - AUDIO の logSettings エントリのみを使用して PutBotAlias オペレーションを呼び出します。
  - PutBotAlias オペレーションの呼び出しには、TEXT の logSettings エントリを含めることはできません。
- オーディオをログ記録しない場合
  - conversationLogs フィールドを使用しないで PutBotAlias オペレーションを呼び出します。

API を使用してオーディオログをオフにするには

- テキストをログ記録する場合
  - TEXT の logSettings エントリのみを使用して PutBotAlias オペレーションを呼び出します。
  - PutBotAlias オペレーションの呼び出しには、AUDIO の logSettings エントリを含めることはできません。
- テキストをログ記録していない場合
  - conversationLogs フィールドを使用しないで PutBotAlias オペレーションを呼び出します。

ブラウザで JavaScript が無効になっているか、使用できません。

AWS ドキュメントを使用するには、JavaScript を有効にする必要があります。手順については、使用するブラウザのヘルプページを参照してください。

ドキュメントの表記規則

会話ログの IAM ポリシー

会話ログの暗号化