Desenvolvendo recursos com o 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á.

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:

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.

Desenvolva atributos com /dev

Para trabalhar em uma tarefa de código com o Amazon Q 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 atributos.

  2. Escolha o ícone Amazon Q para abrir o painel do Amazon Q chat.

  3. 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.

  4. Uma nova guia será aberta. Caso ainda não tenha feito isso, insira uma descrição da tarefa ou do problema.

  5. 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'.

  6. 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.

  7. 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.

  8. 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.

  9. 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.

Cotas
Recurso Quota
Gerações de código por tarefa 10
Tamanho de projeto de código

200 MB sem compressão

50 MB compactados