Desenvolver funcionalidades e iterar com o Amazon Q Developer no GitHub - 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á.

Desenvolver funcionalidades e iterar com o Amazon Q Developer no GitHub

nota

O Amazon Q Developer para GitHub está na versão prévia e está sujeito a alterações.

Você pode usar o Amazon Q Developer no GitHub para otimizar o desenvolvimento implementando automaticamente novos recursos e correções de bugs, transformando as tarefas da ideia em uma solicitação pull concluída. Quando você adiciona o rótulo de desenvolvimento de recursos a um problema ou usa o comando de barra /q dev, o Amazon Q Developer usa o problema, incluindo seu título e descrição, bem como o código do repositório como contexto para gerar novas correções de código e criar uma solicitação pull. Na solicitação pull, você pode fornecer feedback e o Amazon Q Developer itera sobre o código sugerido.

Você pode fazer com que o Amazon Q Developer realize o desenvolvimento de recursos um número limitado de vezes por mês. Você pode aumentar seu uso gratuito a qualquer momento registrando a instalação do aplicativo Amazon Q Developer em sua AWS conta. Para obter mais informações, consulte Aumentar os limites de uso e configurar detalhes no console do Amazon Q Developer.

Importante

A aplicação do Amazon Q Developer tenta criar automaticamente os rótulos do agente de desenvolvimento do Amazon Q e do agente de transformação do Amazon Q nos repositórios do GitHub aos quais você autoriza o acesso. Se os rótulos não forem criados automaticamente ou se forem excluídos acidentalmente, você poderá criá-los manualmente no GitHub. Os rótulos devem ser nomeados como agente de desenvolvimento do Amazon Q e agente de transformação do Amazon Q para serem reconhecidos e processados como rótulos do Amazon Q Developer. Para obter mais informações, consulte Creating a label na documentação do GitHub.

Como usar o Amazon Q Developer para desenvolvimento de recursos

  1. Se necessário, faça login na sua conta do GitHub usando suas credenciais do GitHub.

  2. Navegue até sua organização do GitHub e, em seguida, navegue até o repositório em que deseja implementar novos recursos com o Amazon Q Developer.

  3. Selecione Problemas e, em seguida, crie um novo problema ou selecione um problema existente. Para obter mais informações, consulte Create an issue na documentação do GitHub.

    1. Para um novo problema, no campo de entrada de texto Adicionar um título, insira um título que forneça contexto ao Amazon Q Developer para o desenvolvimento de recursos (exemplo: “Criar uma aplicação de reconhecimento de imagem”). A descrição do problema também deve ser incluída, pois também fornece contexto.

      Para um problema existente, você pode editar o título e a descrição do problema para fornecer contexto ao Amazon Q Developer para o desenvolvimento de recursos. Para obter mais informações, consulte Editing an issue na documentação do GitHub.

  4. Ao criar um problema ou configurar um problema existente, você poderá aplicar o rótulo do Amazon Q Developer de desenvolvimento de recursos ou usar o comando de barra /q dev. Execute um destes procedimentos:

    • Para aplicar o rótulo ao problema, siga um destes procedimentos:

      • Selecione o menu suspenso Atribuir ao Amazon Q fornecido como uma extensão do navegador e, em seguida, selecione o rótulo Agente de desenvolvimento do Amazon Q.

      • No menu do lado direito, selecione Rótulos e, em seguida, selecione o rótulo Agente de desenvolvimento do Amazon Q.

    • Como usar o comando de barra /q dev em um comentário:

      1. No problema, navegue até Adicionar um comentário e, no campo de entrada de texto do comentário, insira /q dev.

      2. Escolha Comment (Comentário).

  5. Para um novo problema, selecione Criar problema para concluir a criação do problema com os detalhes necessários para que o Amazon Q Developer desenvolva recursos. Se você configurar um problema existente, salve as alterações. Para obter mais informações, consulte Editing an issue na documentação do GitHub.

    Quando o Amazon Q Developer terminar de gerar alterações no código para o desenvolvimento de recursos, ele comentará sobre o problema e abrirá uma solicitação pull.

  6. Navegue até o comentário deixado pelo Amazon Q Developer (exemplo: “I finished generating the proposed code changes and opened a pull request: Resolve Create an image recognition app”) e selecione o link da solicitação pull.

    Você também pode navegar até a guia Solicitações pull e, em seguida, selecionar a solicitação pull criada pelo Amazon Q Developer.

  7. Selecione a guia Arquivos alterados para ver as alterações no código.

  8. Se as alterações de código sugeridas forem satisfatórias, você poderá mesclar a solicitação pull. Para obter mais informações, consulte Merge a pull request.

Você também pode revisar a solicitação pull para o desenvolvimento de recursos e iterar nas alterações de código sugeridas fornecendo feedback ao Amazon Q Developer.

Como iterar no código de desenvolvimento de recursos do Amazon Q Developer

  1. Selecione a solicitação pull criada pelo Amazon Q Developer e, em seguida, selecione a guia Arquivos alterados para visualizar as alterações no código.

  2. Para a linha de código para a qual você deseja deixar feedback e fazer com que o Amazon Q Developer itere, clique em + para adicionar um comentário com feedback e, em seguida, selecione Iniciar uma revisão.

    Após o envio da revisão, o Amazon Q Developer começará a revisar o código com base no seu feedback. Quando o Amazon Q Developer termina de revisar seu feedback, ele confirma as alterações na solicitação pull e atualiza você com um comentário.

  3. Selecione Concluir revisão, clique no botão de opção Solicitar alterações e, em seguida, selecione Enviar revisão para que seus comentários sejam revisados.

  4. Se as alterações no código forem satisfatórias, você poderá mesclar a solicitação pull ou iterar no código novamente com novos comentários. Para obter mais informações, consulte Merge a pull request.

O Amazon Q Developer se integra aos fluxos de trabalho do GitHub Actions para criar um sistema inteligente de ciclo de feedback. Quando uma solicitação pull é criada, fluxos de trabalho configurados, como testes de unidade, são executados automaticamente. Se o fluxo de trabalho falhar, o Amazon Q Developer analisará a saída e, com base nos resultados e nas informações de falha, iterará nas alterações do código. À medida que as alterações de código são enviadas e os fluxos de trabalho são executados, o Amazon Q Developer interpreta os resultados e usa essas informações para refinar sua abordagem. Isso cria um ciclo de aprendizado contínuo em que cada iteração se baseia em tentativas anteriores e o Amazon Q Developer consegue desenvolver suas soluções.

A eficácia de um ciclo de feedback depende de testes e fluxos de trabalho bem definidos que forneçam feedback significativo ao Amazon Q Developer para interpretação e execução. Você pode configurar fluxos de trabalho usando arquivos YAML do GitHub Actions em seu repositório, permitindo processos personalizados de teste e validação aos quais o Amazon Q Developer pode responder. Para obter mais informações, consulte Understanding GitHub Actions na documentação do GitHub.