Perguntas frequentes sobre o Amazon CodeWhisperer

O CodeWhisperer ajuda a acelerar o desenvolvimento de software, fornecendo sugestões de código que reduzem o esforço total de desenvolvimento e que permitem mais tempo para criação, solução de problemas complexos e criação de código diferenciado. Além das sugestões de código de uso geral, o CodeWhisperer foi criado para fornecer sugestões de código para usar as APIs da AWS. O CodeWhisperer também pode ajudar você a melhorar a segurança das aplicações, ajudando a detectar e corrigir vulnerabilidades de segurança.

À medida que você escreve o código, o CodeWhisperer analisa os comentários em inglês e o código circundante para inferir qual código é necessário para concluir a tarefa em questão. O CodeWhisperer sugere um ou mais trechos de código diretamente no editor de código, acelerando seu trabalho à medida que você codifica. As sugestões de código do CodeWhisperer são baseadas em grandes modelos de linguagem (LLMs) treinados em bilhões de linhas de código, incluindo Amazon e código-fonte aberto. Você pode aceitar a sugestão principal de forma mais rápida e fácil (tecla tab), ver mais sugestões (teclas de seta) ou continuar escrevendo seu próprio código. Sempre analise uma sugestão de código antes de aceitá-la, e talvez seja necessário editá-la para garantir que ela faça exatamente o pretendido.

O CodeWhisperer usa seu conteúdo, como trechos de código, comentários, localização do cursor e conteúdo de arquivos abertos no IDE, como entradas para fornecer sugestões de código.

Seu conteúdo é transmitido usando o protocolo TLS para garantir a comunicação segura entre o IDE e o serviço CodeWhisperer. O conteúdo é criptografado em trânsito para evitar espionagem ou ataques intermediários. Para usuários individuais do CodeWhisperer, podemos reter conteúdo para fins de melhoria do serviço com base nas configurações do usuário. Armazenamos esse conteúdo de maneira segura com criptografia em repouso e controles de acesso rígidos.
 

Disponível como parte do Kit de ferramentas da AWS para Visual Studio (VS) Code e JetBrains, o CodeWhisperer atualmente oferece suporte para Python, Java, JavaScript, TypeScript, C#, Go, Rust, PHP, Ruby, Kotlin, C, C++, scripts Shell, SQL, Scala, JSON, YAML e HCL. Além do VS Code e da família JetBrains de IDEs (incluindo IntelliJ, PyCharm, GoLand, CLion, PhpStorm, RubyMine, Rider, WebStorm, DataGrip e Visual Studio (versão de demonstração)), o CodeWhisperer também está disponível para o AWS Cloud9, o console do Lambda, o JupyterLab e o SageMaker Studio, além das suas linhas de comando favoritas, incluindo o terminal macOS, iTerm2 e o terminal VS Code integrado. 

Para começar a usar o VS Code, os IDEs do JetBrains ou o Visual Studio (versão de demonstração), assista a esses vídeos curtos. Você também pode seguir as instruções na documentação.

O CodeWhisperer está disponível por padrão no AWS Cloud9 e no console do Lambda. Para obter mais informações, use os links a seguir para instruções sobre como começar a usar o CodeWhisper nos seguintes IDEs:

• Console do Lambda
• AWS Cloud9 
• JupyterLab 
• Amazon SageMaker Studio
• Terminal, shell e linha de comando

Quando o CodeWhisperer estiver ativado, você receberá sugestões de código no seu editor de código enquanto digita. Para acionar manualmente o CodeWhisperer, use Option+C (macOS) ou Alt+C (Windows).

O CodeWhisperer funciona com mais eficiência quando os comentários do desenvolvedor são curtos e mapeados para tarefas discretas menores, de modo que nenhuma função ou bloco de código seja muito longo. Da mesma forma, o CodeWhisperer pode gerar sugestões de código úteis quando os desenvolvedores usam nomes intuitivos para vários elementos de código, como nomes de função. Quanto mais código estiver disponível como contexto circundante, melhor será a sugestão.

Sim. Você pode pausar sugestões automáticas na seção CodeWhisperer do painel Ferramentas do desenvolvedor no AWS Toolkit. As sugestões automáticas permanecerão pausadas até que você as retome. Para acionar manualmente o CodeWhisperer, use Option+C (macOS) ou Alt+C (Windows).

O rastreador de referência do CodeWhisperer detecta se uma sugestão de código pode ser semelhante a dados específicos de treinamento de código aberto do CodeWhisperer. O rastreador de referência pode sinalizar essas sugestões com um URL do repositório e informações de licença do projeto ou pode filtrá-las opcionalmente. Dessa maneira, você pode encontrar e revisar mais facilmente o código referenciado e ver como ele é usado no contexto de outro projeto, antes de decidir usá-lo. Todas as referências são registradas em log para revisão posterior, garantindo que seu fluxo de código não seja perturbado e que você possa continuar codificando sem interrupção.

Você pode escanear seu código para identificar vulnerabilidades de segurança difíceis de encontrar e obter sugestões de código para ajudar a corrigir os problemas identificados. A verificação de segurança integrada foi projetada para detectar problemas como credenciais expostas e injeção de logs. As sugestões de código baseadas em IA generativa ajudam a corrigir as vulnerabilidades identificadas e são adaptadas ao código da sua aplicação para que você possa aceitar correções rapidamente e com confiança. A verificação de segurança está disponível para Java, Python, JavaScript e agora disponível para TypeScript, C#, AWS CloudFormation (YAML, JSON), AWS CDK (TypeScript, Python) e HashiCorp Terraform (HCL). Atualmente, as sugestões de código para ajudar a corrigir vulnerabilidades estão disponíveis para códigos escritos em Java, Python e JavaScript.

O CodeWhisperer é um serviço de IA generativa desenvolvido por um modelo de base (FM) treinado em várias fontes de dados, incluindo código-fonte da Amazon e código-fonte aberto. Além disso, você também pode acessar o Amazon Q via CodeWhisperer no IDE. O Amazon Q foi desenvolvido com base no Amazon Bedrock, um serviço totalmente gerenciado para criar aplicações de IA generativa que oferece uma escolha de FMs de alta performance da Amazon e das principais empresas de IA. O Amazon Q usa vários FMs para concluir suas tarefas e usa a lógica para rotear tarefas para o FM que é mais adequado para o trabalho.

Assim como no seu IDE, você é o proprietário do código que escreve, incluindo qualquer sugestão de código fornecida pelo CodeWhisperer. Você é responsável pelo código que escreve, incluindo as sugestões do CodeWhisperer que você aceita. Sempre revise as sugestões de código antes de aceitá-las. Talvez seja necessário fazer edições para garantir que o código faça exatamente o que você pretendia.

Como uma IA generativa, o CodeWhisperer cria um novo código com base no que os modelos subjacentes aprenderam com o código no qual foram treinados e no contexto que você forneceu como código anterior e comentários. Embora o CodeWhisperer não tenha sido projetado para reproduzir código a partir de dados de treinamento, é possível que, em raras ocasiões, ele gere um código semelhante ao código disponível publicamente. Se o CodeWhisperer detectar que sua saída corresponde ao código disponível publicamente, o rastreador de referência integrado notificará você com uma referência ao tipo de licença (por exemplo, MIT ou Apache) e um URL para o código disponível publicamente. Dessa maneira, você pode encontrar e revisar mais facilmente o código referenciado e ver como ele é usado no contexto de outro projeto, antes de decidir usá-lo ou não. Para garantir que seu fluxo de codificação não seja perturbado, todas as referências são registradas em log para você revisar posteriormente, para que você possa continuar codificando sem interrupção.

Sim. Na configuração do CodeWhisperer, você pode desmarcar a opção “Incluir sugestões com referências de código”. Isso evitará que o CodeWhisperer faça sugestões que incluam referências a um código-fonte aberto licenciado conhecido. Para usuários do nível individual gratuito do CodeWhisperer, essa configuração está disponível no IDE. Com o CodeWhisperer Professional, o administrador da AWS pode configurar centralmente essa configuração no nível da organização a partir do Console de Gerenciamento da AWS.

O CodeWhisperer pode filtrar sugestões de código que incluem frases tóxicas e sugestões que contêm estruturas de código comumente conhecidas que indicam tendências.

O CodeWhisperer foi projetado para evitar a sugestão de código com vulnerabilidades de segurança, e o maior número possível de vulnerabilidades de segurança é filtrado. No entanto, dada a natureza generativa do CodeWhisperer, não podemos descartar completamente sugestões de código com problemas de segurança. Portanto, o CodeWhisperer vem com um atributos de verificação de código integrado que detecta vulnerabilidades de segurança nos seus projetos Python, Java e JavaScript, incluindo sugestões de código do CodeWhisperer e código escrito por você.

O CodeWhisperer foi treinado em várias fontes de dados, incluindo código-fonte da Amazon e código-fonte aberto. O CodeWhisperer foi treinado e validado para gerar sugestões de código a partir de comentários em inglês. Considerando os vários exemplos no conjunto de dados de treinamento, é possível que o CodeWhisperer forneça sugestões de código a partir de comentários escritos em idiomas diferentes do inglês; no entanto, esse não é um caso de uso compatível.

O uso do CodeWhisperer Individual é gratuito. Basta criar um ID do builder AWS e fazer login com ele. O processo de inscrição leva apenas alguns minutos e não exige um cartão de crédito ou uma conta da AWS.

O CodeWhisperer Professional custa USD 19 por usuário/mês e oferece aos administradores a capacidade de habilitar o CodeWhisperer para sua organização com autenticação única (SSO). Os administradores podem integrar mais facilmente o CodeWhisperer às soluções existentes de identidade da força de trabalho, fornecer acesso a usuários e grupos e definir configurações em toda a organização, como incluir ou excluir sugestões com referências de código. Para obter mais detalhes, consulte Preços do Amazon CodeWhisperer.
 

O CodeWhisperer é independente de região da AWS e está disponível para desenvolvedores em todo o mundo. O CodeWhisperer está atualmente hospedado na região Leste dos EUA (Norte da Virgínia). Como administrador do CodeWhisperer Professional, você poderá configurar o CodeWhisperer como uma aplicação autorizada entre regiões se tiver o Centro de Identidade do IAM em outras regiões.

Um administrador da AWS pode habilitar o CodeWhisperer para uma organização por meio do Console de Gerenciamento da AWS. Como pré-requisito, os administradores devem configurar o SSO por meio do Centro de Identidade do IAM, caso ele ainda não esteja habilitado para suas organizações. Depois que a autenticação SSO estiver configurada, os administradores poderão habilitar o CodeWhisperer e atribuir acesso a usuários e grupos na sua organização.

O SSO para o CodeWhisperer é habilitado pelo Centro de Identidade do IAM. Para obter mais informações, consulte o Guia do usuário do CodeWhisperer.

Com o recurso de personalização do CodeWhisperer, você pode personalizar o CodeWhisperer para gerar recomendações mais relevantes, tornando-o ciente de suas bibliotecas internas, APIs, práticas recomendadas e padrões arquitetônicos. Para obter mais informações, consulte Personalizar o CodeWhisperer para obter recomendações ainda melhores.

Atualmente, você pode personalizar as recomendações do CodeWhisperer em bases de código escritas em Java, JavaScript, TypeScript e Python. Arquivos escritos em outras linguagens com suporte pelo CodeWhisperer (C#, Go, Rust, PHP, Ruby, Kotlin, C, C++, scripts Shell, SQL e Scala) não serão usados ao criar a personalização ou ao fornecer recomendações personalizadas no IDE com base nos seus repositórios de código internos.

Você pode conectar com segurança seus repositórios de código ao CodeWhisperer usando o Console de Gerenciamento da AWS. Os administradores do CodeWhisperer podem gerenciar facilmente o acesso a uma personalização privada no console, para que somente desenvolvedores específicos tenham acesso.

Cada personalização é isolada de outros clientes e nenhuma das personalizações criadas com esse novo recurso será usada para treinar o modelo básico subjacente ao CodeWhisperer. Ao criar uma personalização, o CodeWhisperer ajuda a manter a segurança do código fornecendo a opção de criptografar seus dados de personalização usando a chave gerenciada pelo cliente no AWS Key Management Service (AWS KMS). Os dados de personalização serão excluídos quando o trabalho de personalização for concluído.

Durante a versão de demonstração, você pode usar o recurso de personalização do CodeWhisperer para criar até oito personalizações com base nas suas bases de código internas. É possível manter até duas personalizações de código ativas ao mesmo tempo.

O CodeWhisperer é uma ferramenta de produtividade baseada em IA generativa para o IDE e a linha de comando. Você pode instalar a extensão AWS Toolkit em seu IDE e fazer login no módulo CodeWhisperer para acessar atributos como sugestões de código em linha, personalizações, verificações de segurança e Amazon Q no IDE. O Amazon Q é um assistente baseado em IA generativa projetado para o trabalho. Quando usado no IDE, o Amazon Q pode responder perguntas sobre a criação de software na AWS e em outros lugares. Além disso, ele entende o código em seu IDE e pode ajudar você em tarefas como explicar seu código, escrever testes ou atualizar versões da linguagem da aplicação.

O Amazon Q está disponível no IDE por meio do Amazon CodeWhisperer e atualmente oferece suporte ao Visual Studio (VS) Code e à família de IDEs da JetBrains. Para começar a usar o Amazon Q no IDE, consulte Getting started with Amazon Q—Your expert assistant for AWS ou leia a documentação.

Instale o AWS Toolkit for Visual Studio (versão de demonstração), JetBrains ou VS Code por meio do respectivo mercado de extensões/plugins. Em seguida, autentique-se com o ID do builder AWS ou o Centro de Identidade do AWS IAM. Após a autenticação, o Amazon Q pode ser encontrado na barra de atividades no VS Code ou na janela da ferramenta ancorada no canto superior direito da JetBrains. Para obter mais ajuda para começar a usar o Amazon Q, consulte Getting started with Amazon Q—Your expert assistant for AWS.

O Amazon Q vai além da geração e conclusão de código em um ambiente de desenvolvedor. Ele ajuda os desenvolvedores a interagir por meio de conversas em linguagem natural, oferece suporte a vários casos de uso para ajudar os desenvolvedores a aprender a usar bibliotecas e APIs, pode gerar código para resolver solicitações, explica a lógica complexa do código e discute possíveis soluções para erros no código. Ele pode melhorar significativamente a eficiência e a produtividade dos desenvolvedores, servindo como um complemento em seu ciclo de vida diário de desenvolvimento e liberando-os para pensar nos problemas certos a serem resolvidos em seus sistemas de software.

O Amazon Q pode responder perguntas sobre como começar e criar, implantar ou operar aplicações e workloads na AWS e em outros lugares. O Amazon Q também pode ajudar a explicar uma base de código desconhecida, corrigir erros ou gerar código e testes. Com o recurso de desenvolvimento de atributos do Amazon Q, você pode passar de um prompt de linguagem natural para um atributo da aplicação uma fração do tempo, com instruções passo a passo interativas diretamente do seu IDE. O Amazon Q Code Transformation pode ajudar você a atualizar suas aplicações Java para a versão mais recente da linguagem (atualização do Java 8 ou 11 para o Java 17 durante a versão de demonstração) identificando e atualizando dependências e estruturas obrigatórias do pacote, atualizando o código obsoleto incorporando as práticas recomendadas de segurança e gerando testes para validar a execução da aplicação atualizada.

O Amazon Q usa as seguintes informações contextuais ao responder perguntas: 1. Contexto conversacional atual, como perguntas feitas e respostas/código gerados no painel de conversação. 2. O contexto do IDE, incluindo a linha de código, o trecho ou as funções selecionadas no arquivo e no repositório em que os desenvolvedores estão trabalhando atualmente.

O Amazon Q não armazena nem usa nenhum conteúdo de usuários do CodeWhisperer Professional para melhorar o serviço. Ao usar o Amazon Q como usuário do Amazon CodeWhisperer Professional, a AWS pode coletar e usar métricas de telemetria e uso do lado do cliente, bem como seus comentários para fins de melhoria do serviço. O Amazon Q usa isso para tornar as respostas futuras melhores e mais personalizadas de acordo com as instruções e intenções dos desenvolvedores à medida que a conversa avança. Você pode desativar essa coleta de dados ajustando suas configurações no IDE. Para obter informações sobre como o CodeWhisperer Individual coleta e usa seus dados, consulte as Perguntas frequentes sobre o CodeWhisperer Individual.

Na versão prévia, o recurso de personalização do CodeWhisperer não será suportado pelo Amazon Q. O Amazon Q não fornecerá recomendações de código personalizadas com base em suas bases de código internas, mesmo se você estiver usando personalizações por meio do CodeWhisperer. Atualmente, o recurso de personalização só é suportado para casos de uso de geração de código para a experiência in-IDE com o CodeWhisperer.

O CodeWhisperer para linha de comando ajuda os desenvolvedores a serem mais produtivos na linha de comando com conclusões contextuais da CLI, documentação em linha e tradução de linguagem natural para bash de IA. O CodeWhisperer para linha de comando se integra à linha de comando existente de um desenvolvedor para que os desenvolvedores não precisem alterar as ferramentas que usam para começar a se beneficiar dela.

Enquanto um usuário digita sua linha de comando, o CodeWhisperer mostra conclusões e documentação em linha para mais de 250 ferramentas de CLI.

Por exemplo, um desenvolvedor pode digitar `git `e ver uma lista de todos os subcomandos, opções e argumentos do git, ordenados pelo seu uso recente. Um desenvolvedor também pode digitar `npm install` e ver uma lista de todos os pacotes de nós disponíveis para instalação. Finalmente, um desenvolvedor pode digitar `aws` e ver uma lista de todos os subcomandos aws disponíveis. 

O CodeWhisperer para linha de comando pode receber solicitações de texto em linguagem natural (como "reverse my most recent git commit") e convertê-las em código bash executável instantaneamente

Para começar, basta executar `q`, inserir um prompt e executar o bash!

Atualmente, o CodeWhisperer para linha de comando suporta integrações com as seguintes ferramentas:

1. Sistemas operacionais: macOS
2. Shells: bash, zsh, fish
3. Emuladores de terminal: iTerm2, terminal macOS, Hyper, Tabby
4. IDEs: terminal dentro do VS Code
5) CLIs: mais de 250 das CLIs mais populares, como git, aws, docker, npm, yarn (consulte https://github.com/withfig/autocomplete)

Para suporte com IDEs da Jetbrains (exceto Fleet), Alacritty, Kitty e Wezterm no macOS, execute `cw integrations install input-method`

O CodeWhisperer pode armazenar dados sobre seu uso e conteúdo para fins de melhoria do serviço. Seu conteúdo inclui as partes do histórico da linha de comando que o CodeWhisperer usa para gerar recomendações e traduções de IA, bem como o conteúdo das próprias recomendações. O CodeWhisperer não coleta seu conteúdo para fins de melhoria de serviços no nível profissional. Seu uso do serviço é quantificado com telemetria do lado do cliente. Por exemplo, a AWS pode rastrear se você aceita ou rejeita uma recomendação. Sua telemetria do lado do cliente não contém código real e não contém informações de identificação pessoal (PII), como seu endereço IP. Você pode desativar a coleta de dados de uso e conteúdo ajustando suas configurações no CodeWhisperer para painel de linha de comando.

Sim.
1. Execute `cw` para abrir a página de configurações.
2. Selecione a guia Conclusões da CLI.
3. Ative o botão no canto superior direito da página para Desativar.

O CodeWhisperer Professional usa seu conteúdo, como trechos de código, comentários e conteúdo de arquivos abertos no IDE. Esse conteúdo é processado pelo serviço exclusivamente para fornecer e manter o serviço. O conteúdo processado pelo CodeWhisperer Professional não é armazenado ou usado para melhorar o serviço.

Além disso, a AWS pode coletar e usar métricas de uso e telemetria no lado do cliente para fins de melhoria do serviço. Você pode desativar essa coleta de dados ajustando suas configurações no IDE.

Para obter mais informações, consulte o Guia do usuário do CodeWhisperer.

O conteúdo processado pelo CodeWhisperer Professional, como trechos de código, comentários e conteúdo de arquivos abertos no IDE, não é armazenado nem usado para melhorar o serviço.

A AWS pode coletar e usar métricas de uso e telemetria no lado do cliente para fins de melhoria do serviço. Você pode desativar essa coleta de dados ajustando suas configurações no IDE.

Para obter mais informações, consulte o Guia do usuário do CodeWhisperer.

Não. O conteúdo processado pelo CodeWhisperer Professional, como trechos de código, comentários e conteúdo de arquivos abertos no IDE, não é armazenado nem usado para treinar o modelo e, portanto, nunca será reproduzido em uma sugestão de código para outro usuário.

O CodeWhisperer Individual usa seu conteúdo, como trechos de código, comentários, localização do cursor e conteúdo de arquivos abertos no IDE, como entradas para fornecer sugestões de código. Você pode optar por não permitir que a AWS armazene e use seu conteúdo para melhorar o serviço, ajustando a configuração “Compartilhar conteúdo do CodeWhisperer com a AWS” no AWS Toolkit dentro do IDE.

Além disso, a AWS pode coletar e usar métricas de uso e telemetria no lado do cliente para fins de melhoria do serviço. Você pode cancelar essa coleta de dados ajustando a configuração de telemetria no AWS Toolkit no IDE.

Para obter mais informações, consulte o Guia do usuário do CodeWhisperer.

O CodeWhisperer Individual pode armazenar e usar seu conteúdo, como trechos de código, comentários e conteúdos de arquivos abertos no IDE, processados pelo serviço para fornecer e manter o serviço e, a menos que você opte por não participar, conforme mencionado abaixo, para melhorar e desenvolver a qualidade do CodeWhisperer. Isso inclui aprender as melhores maneiras de melhorar a produtividade do desenvolvedor por meio da geração de código, detectar o possível uso indevido do serviço, avaliar a eficácia dos atributos do CodeWhisperer, aprimorar os LLMs subjacentes que permitem geração de código, ajustar os algoritmos de classificação e muito mais. Você pode ajustar suas configurações no IDE para não permitir que a AWS armazene e use seu conteúdo para melhorar o serviço.

Além disso, a AWS pode coletar e usar métricas de uso e telemetria no lado do cliente para fins de melhoria do serviço. Você pode desativar essa coleta de dados ajustando suas configurações no IDE.

Para obter mais informações, consulte o Guia do usuário do CodeWhisperer.

Para o CodeWhisperer Individual, você pode desativar a coleta de dados ajustando suas configurações no IDE.

Para obter mais informações, consulte o Guia do usuário do CodeWhisperer.

Temos salvaguardas projetadas para impedir a reprodução de código privado exclusivo coletado de usuários individuais do CodeWhisperer.

Visite o Centro de privacidade dos dados.