Logging dei prompt degli utenti in Amazon Q Developer - Amazon Q Developer

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Logging dei prompt degli utenti in Amazon Q Developer

Gli amministratori possono abilitare registrazione dei log di tutti i suggerimenti in linea e delle conversazioni in chat che gli utenti hanno tenuto con Amazon Q nel loro ambiente di sviluppo integrato (IDE). Questi log possono esse utili per il controllo, il debug, l’analisi e la garanzia della conformità.

Quando gli sviluppatori utilizzano suggerimenti in linea, Amazon Q registrerà i suggerimenti accettati e attivamente rifiutati. Quando gli sviluppatori chattano con Amazon Q, Amazon Q registra sia i prompt degli sviluppatori che le risposte di Amazon Q. Quando gli sviluppatori chattano con Amazon Q Agent per lo sviluppo software utilizzando il comando /dev, verranno registrati solo i prompt.

Amazon Q archivia i log in un bucket Amazon S3 creato da te, nel seguente percorso:

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

Nel percorso precedente, log-type è uno dei seguenti:

  • GenerateAssistantResponse: contiene i log delle chat

  • GenerateCompletions: contiene i log di completamento in linea

  • StartTaskAssistCodeGeneration: contiene i log /dev

Per esempi e spiegazioni del contenuto dei file di log, consulta Esempi di log dei prompt in Amazon Q Developer.

Non sono previsti costi per la funzionalità di registrazione dei log dei prompt oltre al costo di storage del bucket Amazon S3 utilizzato per contenere i log e una piccola tariffa per la chiave KMS opzionale utilizzata per crittografare il bucket.

Utilizza le seguenti istruzioni per abilitare registrazione dei log dei prompt.

Prerequisiti

  • Assicurati che gli utenti si siano abbonati a un account autonomo o, se utilizzi AWS Organizations, a un account di gestione. Attualmente, Q Developer non supporta la registrazione dei log dei prompt degli utenti iscritti negli account membri in AWS Organizations.

  • Crea un bucket Amazon S3 per contenere i log dei prompt. Il bucket deve:

    • Sii nella AWS regione in cui è stato installato il profilo Amazon Q Developer. Questo profilo è stato installato quando hai abbonato gli utenti ad Amazon Q Developer Pro per la prima volta. Per ulteriori informazioni su questo profilo e sulle Regioni in cui è supportato, consulta Cos’è il profilo di Amazon Q Developer? e Regioni supportate per la console Q Developer e il profilo Q Developer.

    • Accedi all' AWS account a cui gli utenti sono abbonati.

    • Adotta una policy di bucket come quella che segue. Sostituisci bucketNameregion,accountId, e prefix con le tue informazioni.

      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:*"
                }
            }
        }
    ]
}

      Se configuri SSE-KMS sul bucket, aggiungi la seguente policy alla chiave KMS:

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

      Per maggiori informazioni sulla protezione dei dati nel tuo bucket Amazon S3, consulta Protezione dei dati con la crittografia nella Guida per l’utente di Amazon Simple Storage Service.

Per abilitare la registrazione dei log dei prompt

  1. Apri la console Amazon Q Developer.

    Per utilizzare la console Amazon Q Developer, è necessario disporre delle autorizzazioni definite in Consenti agli amministratori di utilizzare la console Amazon Q Developer.

    Nota

    Devi accedere come amministratore di account autonomo o amministratore dell’account di gestione. Gli amministratori dell’account membro non possono abilitare la registrazione dei log dei prompt perché non è supportata per gli utenti abbonati negli account membri.

  2. Seleziona Impostazioni.

  3. In Preferenze, scegli Modifica.

  4. Nella finestra Modifica preferenze, attiva la registrazione dei log dei prompt di Q Developer.

  5. In posizione Amazon S3, inserisci l’URI di Amazon S3 che utilizzerai per ricevere i log. Ad esempio: s3://amzn-s3-demo-bucket/qdev-prompt-logs/