Desenvolver recursos com o Amazon Q Developer
nota
Você pode pedir ajuda com o desenvolvimento de recursos diretamente no chat. Se você usar /dev, sua solicitação será redirecionada para o chat.
O Amazon Q Developer pode ajudar você a desenvolver recursos de código ou fazer alterações de código em projetos no 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. Você pode desenvolver recursos com o Amazon Q para ajudar na criação de projetos da AWS ou das suas próprias aplicações.
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 compatíveis, consulte os seguintes links do GitHub para seu IDE:
-
Tipos de arquivo compatíveis com IDEs do JetBrains: https://github.com/aws/aws-toolkit-jetbrains/blob/main/plugins/core/jetbrains-community/src/software/aws/toolkits/jetbrains/services/telemetry/TelemetryUtils.kt
-
Tipos de arquivos compatíveis para 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 chat é aberta, na qual você interage com o Amazon Q para gerar um novo código para seu recurso.
Tópicos
Desenvolva atributos com /dev
nota
Você pode pedir ajuda com o desenvolvimento de recursos diretamente no chat. Se você usar /dev, sua solicitação será redirecionada para o chat.
Para trabalhar em uma tarefa de código com o Amazon Q no seu IDE, conclua as seguintes etapas:
-
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
/devno 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
/devsomente 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ê terá a opção de inserir outra descrição de tarefa para continuar trabalhando em sua tarefa.
Opcionalmente, o Amazon Q pode testar as sugestões de código em um ambiente de desenvolvimento separado antes de apresentá-las a você na janela do chat. Para obter mais informações, consulte Testar sugestões do '/dev'.
-
Depois que o Amazon Q gera o código para sua tarefa, ele fornece uma lista de arquivos com as alterações sugeridas. 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 clique na marca de seleção verde. Para rejeitar uma alteração, clique no X vermelho. Você também pode clicar em Aceitar as alterações restantes para aplicar as alterações que você ainda não aceitou.
Após aceitar uma alteração de código, você não poderá desfazer essa ação. Se você rejeitar uma alteração de código, poderá revertê-la passando o cursor sobre o nome do arquivo e clicando na 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 Aceitas todas as alterações 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, agradeço. 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 práticas recomendadas:
-
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 o 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 os URLs ou as rotas 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 gerar código novamente para 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 um 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 |