Konfigurieren von Konversationsprotokollen - Amazon Lex V1
Aktivieren von KonversationsprotokollenDeaktivieren von Konversationsprotokollen

Wenn Sie Amazon Lex V2 verwenden, lesen Sie stattdessen das Amazon Lex V2-Handbuch.

 

Wenn Sie Amazon Lex V1 verwenden, empfehlen wir, Ihre Bots auf Amazon Lex V2 zu aktualisieren. Wir fügen V1 keine neuen Funktionen mehr hinzu und empfehlen dringend, V2 für alle neuen Bots zu verwenden.

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

Konfigurieren von Konversationsprotokollen

Sie aktivieren und deaktivieren Konversationsprotokolle über die Konsole oder das conversationLogs-Feld der PutBotAlias-Operation. Sie können Audioprotokolle, Textprotokolle oder beides aktivieren oder deaktivieren. Die Protokollierung beginnt bei neuen Botsitzungen. Änderungen an den Protokolleinstellungen werden für aktive Sitzungen nicht berücksichtigt.

Verwenden Sie eine Amazon Logs-Protokollgruppe in IhremAWS Konto, um CloudWatch Textprotokolle zu speichern. Sie können jede gültige Protokollgruppe verwenden. Die Protokollgruppe muss sich in derselben Region befinden wie der Amazon-Lex-Bot in derselben Region befinden wie der Amazon-Lex-Bot. Weitere Informationen zum Erstellen einer CloudWatch Protokollgruppe finden Sie unter Arbeiten mit Protokollgruppen und Protokollstreams im Amazon CloudWatch Logs-Benutzerhandbuch.

Verwenden Sie einen Amazon S3 S3-Bucket in IhremAWS Konto, um Audioprotokolle zu speichern. Sie können jeden gültigen S3-Bucket verwenden. Der Bucket muss sich in derselben Region befinden wie der Amazon-Lex-Bot. Weitere Informationen zum Erstellen eines S3-Buckets finden Sie unter Erstellen eines Buckets im Amazon Simple Storage Storage Service Getting Started Guide für Amazon Simple Storage Storage Service Getting Started Guide für Amazon Simple Storage Storage Service

Sie müssen eine IAM-Rolle mit Richtlinien bereitstellen, die es Amazon Lex ermöglichen, in die konfigurierte Protokollgruppe oder den konfigurierten Bucket zu schreiben. Weitere Informationen finden Sie unter Erstellen einer IAM-Rolle und von Richtlinien für Konversationsprotokolle.

Wenn Sie eine serviceverknüpfte Rolle mithilfe von erstellenAWS Command Line Interface, müssen Sie der Rolle mithilfe der folgendencustom-suffix Option ein benutzerdefiniertes Suffix hinzufügen:

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

Die IAM-Rolle, die Sie zum Aktivieren von Konversationsprotokollen verwenden, muss über dieiam:PassRole entsprechende Berechtigung verfügen. Die folgende Richtlinie sollte an die Rolle angefügt werden.

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

Aktivieren von Konversationsprotokollen

So aktivieren Sie Protokolle über die Konsole

  1. Öffnen Sie die Amazon Lex Lex-Konsole https://console.aws.amazon.com/lex.

  2. Wählen Sie aus der Liste einen Bot aus.

  3. Wählen Sie die Registerkarte Settings (Einstellungen) und dann im linken Menü Conversation logs (Konversationsprotokolle) aus.

  4. Wählen Sie in der Liste der Aliasse das Einstellungssymbol für den Alias aus, für den Sie Konversationsprotokolle konfigurieren möchten.

  5. Wählen Sie aus, ob Text, Audio oder beides protokolliert werden soll.

  6. Geben Sie für die Textprotokollierung den Namen der Amazon CloudWatch Logs-Protokollgruppe ein.

  7. Geben Sie für die Audioprotokollierung die S3-Bucket-Informationen ein.

  8. Optional. Um Audioprotokolle zu verschlüsseln, wählen Sie den AWS KMS-Schlüssel für die Verschlüsselung aus.

  9. Wählen Sie eine IAM-Rolle mit den erforderlichen Berechtigungen aus.

  10. Wählen Sie Save (Speichern), um Konversationen zu protokollieren.

So aktivieren Sie Textprotokolle mit der API

  1. Rufen Sie die PutBotAlias-Operation mit einem Eintrag im logSettings-Element des conversationLogs-Feldes auf.

    • Setzen Sie das destination-Element auf CLOUDWATCH_LOGS.

    • Setzen Sie das logType-Element auf TEXT.

    • Geben Sie dasresourceArn Mitglied auf den Amazon-Ressourcennamen (ARN) der CloudWatch Protokollgruppe für die -Konsole als Ziel für die Die

  2. Geben Sie demiamRoleArn Element desconversationLogs Felds auf den Amazon-Ressourcennamen (ARN) einer IAM-Rolle an, die Berechtigung zum Aktivieren von Konversationsprotokollen für die angegebenen Ressourcen an.

So aktivieren Sie Audioprotokolle mit der API

  1. Rufen Sie die PutBotAlias-Operation mit einem Eintrag im logSettings-Element des conversationLogs-Feldes auf.

    • Setzen Sie das destination-Element auf S3.

    • Setzen Sie das logType-Element auf AUDIO.

    • Setzen Sie das resourceArn-Element auf den ARN des Amazon S3-Buckets, in dem die Audioprotokolle gespeichert sind.

    • Optional. Um Audioprotokolle mit einem bestimmten AWS KMS-Schlüssel zu verschlüsseln, setzen Sie das kmsKeyArn-Element auf den ARN des Schlüssels, der für die Verschlüsselung verwendet wird.

  2. Geben Sie demiamRoleArn Element desconversationLogs Felds auf den Amazon-Ressourcennamen (ARN) einer IAM-Rolle an, die Berechtigung zum Aktivieren von Konversationsprotokollen für die angegebenen Ressourcen an.

Deaktivieren von Konversationsprotokollen

So deaktivieren Sie Protokolle über die Konsole

  1. Öffnen Sie die Amazon Lex Lex-Konsole https://console.aws.amazon.com/lex.

  2. Wählen Sie aus der Liste einen Bot aus.

  3. Wählen Sie die Registerkarte Settings (Einstellungen) und dann im linken Menü Conversation logs (Konversationsprotokolle) aus.

  4. Wählen Sie in der Liste der Aliasse das Einstellungssymbol für den Alias aus, für den Sie Konversationsprotokolle konfigurieren möchten.

  5. Entfernen Sie die Markierung bei Text, Audio oder beidem, um die Protokollierung zu deaktivieren.

  6. Wählen Sie Save (Speichern), um die Protokollierung von Konversationen zu beenden.

So deaktivieren Sie Protokolle mit der API

  • Rufen Sie die PutBotAlias-Operation ohne das conversationLogs-Feld auf.

So deaktivieren Sie Textprotokolle mit der API

    • Wenn Sie Audio protokollieren:

      • Rufen Sie die PutBotAlias-Operation mit einem logSettings-Eintrag nur für AUDIO auf.

      • Der Aufruf der PutBotAlias-Operation darf keinen logSettings-Eintrag für TEXT haben.

    • Wenn Sie keine Audiodaten protokollieren

      • Rufen Sie die PutBotAlias-Operation ohne das conversationLogs-Feld auf.

So deaktivieren Sie Audioprotokolle mit der API

    • Wenn Sie Text protokollieren

      • Rufen Sie die PutBotAlias-Operation mit einem logSettings-Eintrag nur für TEXT auf.

      • Der Aufruf der PutBotAlias-Operation darf keinen logSettings-Eintrag für AUDIO haben.

    • Wenn Sie keinen Text protokollieren

      • Rufen Sie die PutBotAlias-Operation ohne das conversationLogs-Feld auf.