Registrar em log os prompts dos usuários no Amazon Q Developer - Amazon Q Developer

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

Registrar em log os prompts dos usuários no Amazon Q Developer

Os administradores podem habilitar o registro em log de todas as sugestões em linha e conversas de chat que os usuários têm com o Amazon Q em seu ambiente de desenvolvimento integrado (IDE). Esses logs podem ajudar na auditoria, depuração, análise e na garantia da conformidade.

Quando os desenvolvedores usam sugestões em linha, o Amazon Q registra em log as sugestões aceitas e ativamente rejeitadas. Quando os desenvolvedores conversam com o Amazon Q, o Amazon Q registra em log os prompts dos desenvolvedores e as respostas do Amazon Q. Quando os desenvolvedores conversam com o Amazon Q Agent para desenvolvimento de software usando o /dev comando, somente os prompts serão registrados.

O Amazon Q armazena os logs em um bucket do Amazon S3 criado por você, no seguinte caminho:

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

No caminho anterior, log-type é um dos seguintes:

  • GenerateAssistantResponse: armazena os logs de chat

  • GenerateCompletions: armazena os logs de preenchimento em linha

  • StartTaskAssistCodeGeneration: armazena os logs /dev

Para obter exemplos e explicações sobre o conteúdo do arquivo de log, consulte Exemplos de log de prompts no Amazon Q Developer.

O recurso de registro em log de prompts não é cobrado. No entanto, há o custo de armazenamento do bucket do Amazon S3 usado para armazenar os logs e uma pequena taxa pela chave do KMS opcional usada para criptografar o bucket.

Use as instruções a seguir para habilitar o registro em log de prompts.

Pré-requisitos

  • Os usuários devem estar inscritos em uma conta independente ou, se você estiver usando o AWS Organizations, em uma conta gerencial. Atualmente, o Q Developer não oferece suporte ao registro em log de prompts de usuários inscritos em contas de membro no AWS Organizations.

  • Crie um bucket do Amazon S3 para manter os logs de solicitações. O bucket deve:

    • Esteja na AWS região em que o perfil Amazon Q Developer foi instalado. O perfil foi instalado quando você atribuiu usuários ao Amazon Q Developer Pro pela primeira vez. Para obter mais informações sobre esse perfil e suas regiões compatíveis, consulte O que é o perfil do Amazon Q Developer? e Regiões compatíveis com o console do Q Developer e o perfil do Q Developer.

    • Esteja na AWS conta em que os usuários estão inscritos.

    • Tenha uma política de bucket como a que segue. Substitua bucketNameregion,accountId,, e prefix por suas próprias informações.

      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 estiver configurando o SSE-KMS no bucket, adicione a seguinte política na chave do 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:*"
        }
    }
}

      Para saber mais sobre como proteger os dados em seu bucket do Amazon S3, consulte Proteger dados com criptografia no Guia do usuário do Amazon Simple Storage Service.

Para ativar o log de prompts

  1. Abra o console do Amazon Q Developer.

    Para usar o console do Amazon Q Developer Pro, você deve ter as permissões definidas em Permitir que administradores usem o console do Amazon Q Developer.

    nota

    Você deve entrar como administrador independente da conta ou da conta gerencial. Os administradores de contas de membros não podem habilitar o registro em log de prompts porque esse registro não é compatível com usuários inscritos em contas de membros.

  2. Escolha Settings.

  3. Em Preferências, escolha Editar.

  4. Na janela Editar preferências, ative o log de prompts do Q Developer.

  5. Em Local do Amazon S3, insira a URI do Amazon S3 que você usará para receber os logs. Exemplo: s3://amzn-s3-demo-bucket/qdev-prompt-logs/