Protokollieren von Benutzer-Prompts in Amazon Q Developer - Amazon Q Developer

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.

Protokollieren von Benutzer-Prompts in Amazon Q Developer

Administratoren können die Protokollierung aller Inline-Vorschläge und Chat-Konversationen, die Benutzer mit Amazon Q führen, in ihrer integrierten Entwicklungsumgebung (IDE) aktivieren. Diese Protokolle können bei der Prüfung, beim Debuggen, bei der Analytik und bei der Sicherstellung von Compliance helfen.

Wenn Entwickler Inline-Vorschläge verwenden, protokolliert Amazon Q die akzeptierten und aktiv abgelehnten Vorschläge. Wenn Entwickler mit Amazon Q chatten, protokolliert Amazon Q sowohl die Prompts der Entwickler als auch die Antworten von Amazon Q. Wenn Entwickler mithilfe des Befehls /dev mit dem Amazon Q Agent für Softwareentwicklung chatten, werden nur die Prompts protokolliert.

Amazon Q speichert die Protokolle in einem Amazon-S3-Bucket, den Sie in folgendem Pfad erstellen:

bucketName/prefix/AWSLogs/accountId/QDeveloperLogs/log-type/region/year/month/day/utc-hour/zipFile.gz/logFile.json

Im vorherigen Pfad entspricht log-type einem der folgenden Werte:

  • GenerateAssistantResponse – enthält Chat-Protokolle

  • GenerateCompletions – enthält Inline-Ergänzungsprotokolle

  • StartTaskAssistCodeGeneration – enthält /dev-Protokolle

Beispiele und Erläuterungen zum Inhalt von Protokolldateien finden Sie unter Beispiele für Prompt-Protokolle in Amazon Q Developer.

Für die Prompt-Protokollierungsfunktion fallen keine Gebühren an, mit Ausnahme der Speicherkosten für den Amazon-S3-Bucket, der zum Speichern der Protokolle verwendet wird, und einer geringen Gebühr für den optionalen KMS-Schlüssel, der zum Verschlüsseln des Buckets genutzt wird.

Gehen Sie wie folgt vor, um die Prompt-Protokollierung zu aktivieren.

Voraussetzungen

  • Stellen Sie sicher, dass Benutzer in einem eigenständigen Konto oder, falls Sie AWS Organizations verwenden, in einem Verwaltungskonto abonniert sind. Derzeit unterstützt Q Developer das Protokollieren der Prompts von Benutzern, die in AWS Organizationsüber Mitgliedskonten abonniert sind, nicht.

  • Erstellen Sie einen Amazon-S3-Bucket für die Prompt-Protokolle. Der Bucket muss folgende Voraussetzungen erfüllen:

    • Seien Sie in der AWS Region, in der das Amazon Q Developer-Profil installiert wurde. Dieses Profil wurde installiert, als Sie Amazon Q Developer Pro zum ersten Mal für Benutzer abonniert haben. Weitere Informationen zu diesem Profil und den Regionen, in denen es unterstützt wird, finden Sie unter Was ist das Profil von Amazon Q Developer? und Unterstützte Regionen für die Q-Developer-Konsole und das Q-Developer-Profil.

    • Seien Sie in dem AWS Konto, für das Benutzer angemeldet sind.

    • Der Bucket muss über eine Bucket-Richtlinie wie die folgende verfügen. Ersetzen Sie bucketNameregion,accountId, und prefix durch Ihre eigenen Informationen.

      JSON
      {
    "Version":"2012-10-17",		 	 	 
    "Statement": [
        {
            "Sid": "QDeveloperLogsWrite",
            "Effect": "Allow",
            "Principal": {
                "Service": "q.amazonaws.com"
            },
            "Action": [
                "s3:PutObject"
            ],
            "Resource": [
                "arn:aws:s3:::bucketName/prefix/*"
            ],
            "Condition": {
                "StringEquals": {
                    "aws:SourceAccount": "111122223333"
                },
                "ArnLike": {
                "aws:SourceArn": "arn:aws:codewhisperer:us-east-1:111122223333:*"
                }
            }
        }
    ]
}

      Wenn Sie SSE-KMS für den Bucket konfigurieren, fügen Sie die folgende Richtlinie für den KMS-Schlüssel hinzu:

      {
    "Effect": "Allow",
    "Principal": {
        "Service": "q.amazonaws.com"
    },
    "Action": "kms:GenerateDataKey",
    "Resource": "*",
    "Condition": {
        "StringEquals": {
          "aws:SourceAccount": "accountId" 
        },
        "ArnLike": {
           "aws:SourceArn": "arn:aws:codewhisperer:region:accountId:*"
        }
    }
}

      Weitere Informationen zum Schutz der Daten in Ihrem Amazon-S3-Bucket finden Sie unter Datenschutz durch Verschlüsselung im Benutzerhandbuch für Amazon Simple Storage Service.

So aktivieren Sie die Prompt-Protokollierung

  1. Öffnen Sie die Konsole von Amazon Q Developer.

    Damit Sie die Konsole von Amazon Q Developer verwenden können, müssen Sie über die unter Zulassen, dass Administratoren die Konsole von Amazon Q Developer verwenden definierten Berechtigungen verfügen.

    Anmerkung

    Sie müssen sich als eigenständiger Kontoadministrator oder Verwaltungskontoadministrator anmelden. Administratoren von Mitgliedskonten können die Prompt-Protokollierung nicht aktivieren, da die Prompt-Protokollierung für Benutzer, die in Mitgliedskonten abonniert sind, nicht unterstützt wird.

  2. Wählen Sie Einstellungen aus.

  3. Wählen Sie unter Einstellungen die Option Bearbeiten aus.

  4. Schalten Sie im Fenster „Einstellungen bearbeiten“ die Option Q Developer: Prompt-Protokollierung um.

  5. Geben Sie unter Amazon-S3-Standort den Amazon-S3-URI ein, den Sie für den Empfang der Protokolle verwenden werden. Beispiel: s3://amzn-s3-demo-bucket/qdev-prompt-logs/