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á.
Desenvolvendo recursos com o Amazon Q Developer
O Amazon Q Developer pode ajudá-lo a desenvolver recursos de código ou fazer alterações de código em projetos em seu ambiente de desenvolvimento integrado (IDE). Você explica a tarefa que deseja realizar, e o Amazon Q usa o contexto do seu projeto ou espaço de trabalho atual para gerar código para implementar as alterações. O Amazon Q pode ajudar você a criar AWS projetos ou seus próprios aplicativos.
Você pode iniciar um projeto totalmente novo ou trabalhar em um projeto aberto no IDE. Quando você desenvolve em um projeto existente, o Amazon Q usa todos os arquivos relevantes da raiz do seu espaço de trabalho como contexto para gerar código. O Amazon Q filtra arquivos ou pastas definidos em um .gitignore
arquivo e usa somente tipos de arquivo compatíveis para gerar código. Para obter uma lista dos tipos de arquivo suportados, consulte os GitHub links a seguir para seu IDE:
-
Tipos de arquivo compatíveis com JetBrains IDEs – https://github.com/aws/aws-toolkit-jetbrains/blob/main/plugins/core/jetbrains-community/src/software/aws/toolkits/jetbrains/services/telemetry/TelemetryUtils.kt
-
Tipos de arquivo compatíveis com Visual Studio Code – https://github.com/aws/aws-toolkit-vscode/blob/master/packages/core/src/shared/filetypes.ts
Para começar, abra um arquivo do projeto e insira /dev
no painel de bate-papo do Amazon Q. Uma nova guia de bate-papo é aberta, onde você interage com o Amazon Q para gerar um novo código para seu recurso.
Tópicos
Desenvolva atributos com /dev
Para trabalhar em uma tarefa de código com o Amazon Q em seu IDE, conclua as etapas a seguir.
-
No seu IDE, abra um projeto ou espaço de trabalho novo ou existente no qual você deseja desenvolver atributos.
-
Escolha o ícone Amazon Q para abrir o painel do Amazon Q chat.
-
Insira
/dev
no painel do Amazon Q chat seguido de uma descrição da tarefa que você deseja realizar ou do problema que deseja resolver. Você pode fornecer uma breve visão geral de uma tarefa ou adicionar detalhes. O Amazon Q usa sua descrição e o código do seu projeto para gerar código.Veja a seguir um exemplo de uma alteração de código que você pode solicitar que a Amazon Q implemente:
/dev Create a new REST API endpoint /api/authenticate to handle user authentication. This endpoint should accept POST requests with user credentials and return a JWT token upon successful authentication. Additionally, update the user management system to integrate with the new authentication endpoint and enforce authentication for relevant API endpoints.
Você também pode entrar
/dev
somente para ver exemplos de tarefas. -
Uma nova guia será aberta. Caso ainda não tenha feito isso, insira uma descrição da tarefa ou do problema.
-
O Amazon Q começa a gerar código para a tarefa que você descreveu. Durante a geração do código, o Amazon Q fornece um resumo das etapas que está tomando e dos arquivos que está usando ou atualizando para sugerir um novo código. Isso pode levar alguns minutos.
Se você quiser que o Amazon Q pare de gerar código, escolha Parar. A geração de código incompleto contará para a cota de geração de código para essa tarefa. Depois de interromper uma geração, você tem a opção de inserir outra descrição da tarefa para continuar trabalhando em sua tarefa.
Opcionalmente, o Amazon Q pode testar suas sugestões de código em um ambiente de desenvolvimento separado antes de apresentá-las a você na janela de bate-papo. Para obter mais informações, consulte Testando sugestões de '/dev'.
-
Depois que o Amazon Q gera o código para sua tarefa, ele fornece uma lista de arquivos com sugestões de alterações. Escolha um arquivo para ver uma diferença de arquivo com as alterações.
-
Para atualizar seus arquivos com todas as alterações de código sugeridas, escolha Aceitar todas as alterações. Você também pode aceitar e rejeitar alterações em arquivos individuais. Para aceitar uma alteração de arquivo individual, passe o cursor sobre o nome de um arquivo e escolha a marca de seleção verde. Para rejeitar uma alteração, escolha o X vermelho. Você também pode escolher Aceitar as alterações restantes para aplicar as alterações que você ainda não aceitou.
Depois de aceitar uma alteração de código, você não poderá desfazê-la. Se você rejeitar uma alteração de código, poderá revertê-la passando o mouse sobre o nome do arquivo e escolhendo a seta. Em seguida, você tem a opção de aceitar ou rejeitar a alteração do código novamente.
-
Se você não estiver satisfeito com as mudanças propostas, forneça feedback sobre o que pode ser melhorado. Escolha Fornecer feedback e regenerar e, em seguida, descreva as alterações que você gostaria que o Amazon Q fizesse.
O Amazon Q gera um novo código com base no seu feedback. Quando o código gerado atender aos seus requisitos, escolha Aceitar todas as alterações ou aceitar arquivos individuais para atualizar o código em seu projeto ou espaço de trabalho.
-
Depois de atualizar seu código, o Amazon Q solicita que você comece a trabalhar em uma nova tarefa.
Para começar a trabalhar em outra tarefa em seu projeto ou espaço de trabalho, escolha Sim, eu tenho outra tarefa. Sua conversa e seu código gerado não são usados como contexto para a nova tarefa.
Para encerrar a sessão de desenvolvimento de recursos, escolha Não, obrigado. Para continuar conversando ou iniciar outro fluxo de trabalho com o Amazon Q, abra uma nova guia de bate-papo.
Práticas recomendadas
Para aproveitar ao máximo o desenvolvimento de recursos com o Amazon Q, siga estas melhores práticas:
-
Forneça uma descrição detalhada do novo atributo ou das alterações de código que você deseja fazer, incluindo as especificidades do que o código deve alcançar. Isso permite que a Amazon Q proponha mudanças de código abrangentes e implementáveis. Para obter exemplos, consulte Exemplos de tarefas.
-
Seu atributo não deve exigir atualizações para mais de 5 arquivos por vez. Pedir que a Amazon Q faça mudanças maiores pode afetar a qualidade e a capacidade de gerenciamento da implementação do seu atributo. Se a diferença do arquivo incluir alterações em muitos arquivos, tente reduzir o escopo da descrição do atributo.
Exemplos de tarefas
A seguir estão exemplos de tarefas de desenvolvimento de recursos que você pode solicitar que a Amazon Q execute, com a descrição correspondente que você pode fornecer.
-
Atualize estilos CSS para layout responsivo: melhore a capacidade de resposta do layout do aplicativo atualizando os estilos CSS. Concentre-se em ajustar o layout para diferentes tamanhos de tela, garantindo uma exibição ideal em vários dispositivos.
-
Corrigir o upload da imagem do perfil do usuário: resolva o problema que impede que os usuários enviem imagens de perfil. Investigue o processo de upload de arquivos, garanta a validação adequada do tipo de arquivo e resolva quaisquer erros do servidor que impeçam o envio bem-sucedido.
-
Refatore o código para facilitar a leitura do código: melhore a legibilidade de um módulo de código específico refatorando-o. Divida funções complexas em unidades menores e mais gerenciáveis e aplique nomes significativos de variáveis e funções para maior clareza.
-
Implementar validação de entrada para formulário de contato: adicione validação de entrada do lado do cliente e do lado do servidor ao formulário de contato para evitar o envio de dados vazios ou inválidos. Exiba mensagens de erro apropriadas aos usuários em caso de falhas de validação.
-
Resolver links quebrados no menu de navegação: investigue e corrija links quebrados no menu de navegação do aplicativo. Atualize as rotas URLs ou para garantir que todos os links de navegação levem às páginas corretas.
-
Otimize o carregamento de imagens para carregamentos de página mais rápidos: otimize o carregamento de imagens nas principais páginas do aplicativo para reduzir o tempo de carregamento da página. Implemente técnicas de carregamento lento ou carregamento assíncrono para priorizar a exibição de conteúdo visível.
-
Adicionar registro de erros para endpoints críticos da API: aprimore o tratamento de erros implementando o registro para endpoints críticos da API. Registre detalhes de erro relevantes, como parâmetros de solicitação e rastreamentos de pilha, para facilitar a depuração e a solução de problemas.
-
Atualize a documentação dos endpoints da API: revise e atualize a documentação dos endpoints de API existentes para refletir as mudanças ou adições recentes. Garanta a precisão e a integridade das informações para desenvolvedores que consomem a API.
-
Refatore as consultas do banco de dados para obter eficiência: analise e otimize as consultas do banco de dados para melhorar a eficiência e reduzir o consumo de recursos. Identifique e elimine consultas redundantes, otimize a indexação e considere estratégias de armazenamento em cache quando aplicável.
Cotas
O desenvolvimento de recursos com o Amazon Q mantém as seguintes cotas:
-
Gerações de código por tarefa — O número de vezes que você pode fornecer feedback para regenerar o código de uma determinada tarefa de desenvolvimento, incluindo a geração inicial do código. Essa cota é redefinida toda vez que você inicia uma nova tarefa.
-
Tamanho do projeto de código — O tamanho máximo do arquivo ou pasta de código que o Amazon Q pode usar como contexto para gerar novo código.
Recurso | Quota |
---|---|
Gerações de código por tarefa | 10 |
Tamanho de projeto de código | 200 MB sem compressão 50 MB compactados |