Desenvolvendo software com o Amazon Q Developer Agent for software development

Eles Amazon Q Developer Agent for software development podem 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 o recurso que deseja desenvolver e o Amazon Q usa o contexto do seu projeto atual para gerar um plano de implementação e o código que o acompanha para implementar o recurso. 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 na raiz do seu espaço de trabalho como contexto para desenvolver um plano e gerar código.

Para começar, abra um projeto novo ou existente e entre /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 plano de implementação e um novo código para seu recurso.

Tópicos

• Desenvolva recursos com /dev
• Práticas recomendadas
• Tarefas de exemplo
• Cotas
• Solução de problemas com o Amazon Q Developer Agent for software development

Desenvolva recursos com /dev

Para desenvolver um recurso em seu IDE, conclua as etapas a seguir.

1. No seu IDE, abra um projeto ou espaço de trabalho novo ou existente no qual você deseja desenvolver recursos.

2. Escolha a extensão Amazon Q e, em seguida, escolha Abrir painel de bate-papo. Entre /dev no painel de bate-papo do Amazon Q que se abre. Você também pode digitar a descrição do recurso logo depois/dev.

3. Uma nova guia será aberta. Insira uma descrição do recurso que você deseja desenvolver 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 em seu projeto para criar um plano de implementação.

   Veja a seguir um exemplo de uma alteração de código que você pode solicitar que a Amazon Q implemente:

   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.

4. O Amazon Q responde com um plano de implementação, incluindo as atualizações de código que ele faria para concluir a tarefa que você descreveu.

5. Analise o plano de implementação que o Amazon Q gera. Se você quiser alterar alguma coisa no plano, insira modificações ou mais detalhes para esclarecer o que você deseja obter.

6. Quando estiver satisfeito com o plano de implementação, escolha Gerar código. O Amazon Q gera um novo código e propõe atualizações para seus arquivos com base no plano de implementação. Isso pode levar alguns minutos.

7. Depois que o Amazon Q gerar o código para seu recurso, ele fornece uma lista de arquivos com as alterações propostas. Escolha um arquivo para ver uma diferença de arquivo com as alterações.

8. Para aceitar as alterações e atualizar seu arquivo, escolha Aceitar. Para rejeitar as alterações no arquivo, escolha Rejeitar.

   Se você não estiver satisfeito com as mudanças propostas, forneça feedback no painel de bate-papo sobre o que pode ser melhorado. O Amazon Q gera um novo código com base no seu feedback. Quando o código gerado atender aos seus requisitos, escolha Aceitar para atualizar o código em seu espaço de trabalho.

9. Para desenvolver outro recurso com o Amazon Q na mesma guia de bate-papo, escolha Discutir um novo plano e repita essas etapas. Sua conversa anterior e seu plano de implementação não são usados como contexto para o novo plano.

Práticas recomendadas

Para tirar o máximo proveito doAmazon Q Developer Agent for software development, siga estas melhores práticas:

• Forneça uma descrição detalhada do novo recurso 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 crie um plano de implementação abrangente e mudanças de código que possam ser implementadas. Para ver exemplos, consulte Tarefas de exemplo.

• Seu recurso 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 recurso. Se a diferença do arquivo incluir alterações em muitos arquivos, tente reduzir o escopo da descrição do recurso.

Tarefas de exemplo

A seguir estão exemplos de tarefas de desenvolvimento de recursos que você pode solicitar Amazon Q Developer Agent for software development que executem, com a descrição correspondente que você pode fornecer.

• Atualizar estilos CSS para layout responsivo: 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.

• Corrigir o upload da imagem do perfil do usuário: 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.

• 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

A Amazon Q Developer Agent for software development mantém as seguintes cotas:

• Planos de implementação por tarefa — O número de planos de implementação que Amazon Q Developer Agent for software development você pode criar para uma determinada tarefa de desenvolvimento, incluindo o plano inicial.

• Gerações de código por tarefa — O número de vezes que eles Amazon Q Developer Agent for software development podem gerar código para uma determinada tarefa de desenvolvimento, incluindo a geração inicial do código.

• Tamanho do projeto de código — O tamanho máximo do arquivo ou pasta de código que eles Amazon Q Developer Agent for software development podem usar como contexto para gerar um novo código.

Cotas do Amazon Q Developer Agent for software development
Recurso	Quota
Planos de implementação por tarefa	10
Gerações de código por tarefa	3
Tamanho do projeto de código	200 MB não compactado 50 MB compactados