Amazon Q Developer para GitHub (Demonstração) - Amazon Q Developer
Instalar a aplicação do Amazon Q Developer e autorizar o acessoAgentes do Amazon Q DeveloperRegistrar a instalação da aplicaçãoUsar extensões de navegador no GitHubUsar comandos de barra em problemas do GitHub e solicitações pull

Amazon Q Developer para GitHub (Demonstração)

nota

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

O Amazon Q Developer para GitHub ou GitHub Enterprise Cloud permite que você aproveite os recursos do Amazon Q Developer para seus fluxos de trabalho de desenvolvimento de software. Com agentes de desenvolvimento especializados, você pode implementar novas ideias, revisar o código em busca de problemas de qualidade, resolver vulnerabilidades com testes de unidade e modernizar aplicações Java legadas. Depois que o agente conclui uma tarefa, você pode fornecer feedback e o agente itera na solução anterior. Para obter mais informações, consulte Agentes do Amazon Q Developer.

Você pode acessar a integração do Amazon Q Developer por meio do GitHub e autorizá-la a fornecer acesso aos repositórios da sua organização. Para começar a usar o Amazon Q Developer para GitHub, consulte Início rápido: instalar, usar recursos no GitHub e aumentar limites de uso.

Importante

Para instalar a aplicação do Amazon Q Developer e autorizar o acesso aos repositórios do GitHub, você deve atender aos requisitos da organização do GitHub. Para obter mais informações, consulte Requirements to install a GitHub App e Roles in organization na documentação do GitHub.

nota

A integração do Amazon Q Developer com o GitHub processa dados nos Estados Unidos. Para obter mais informações, consulte Cross-region processing in Amazon Q Developer.

nota

No momento, o Amazon Q Developer for GitHub (versão prévia) não usa seu conteúdo para melhorar o serviço. Se habilitarmos essa opção no futuro, forneceremos um aviso adequado e uma forma de você optar por não participar desse uso.

Tópicos

Instalar a aplicação do Amazon Q Developer e autorizar o acesso

Como administrador da organização do GitHub, você pode instalar e configurar a aplicação do Amazon Q Developer pelo GitHub gratuitamente, sem a necessidade de configurar uma conta da AWS para começar. Durante o processo de instalação, você escolhe se deseja conceder acesso a todos os repositórios ou a repositórios selecionados na sua organização do GitHub. Após a instalação e a autorização, você terá acesso ao uso gratuito dos recursos do Amazon Q Developer no GitHub. Você pode aumentar o uso gratuito registrando a instalação da aplicação no console do Amazon Q Developer. Para obter mais informações, consulte Início rápido: instalar, usar recursos no GitHub e aumentar limites de uso.

Importante

Para instalar a aplicação do Amazon Q Developer e autorizar o acesso aos repositórios do GitHub, você deve atender aos requisitos da organização do GitHub. Para obter mais informações, consulte Requirements to install a GitHub App e Roles in organization na documentação do GitHub.

nota

Se a sua organização corporativa do GitHub tiver habilitado a lista de IPs permitidos, você deverá aceitar os endereços IP permitidos na aplicação do GitHub. Você também pode optar por adicionar automaticamente os endereços IP à sua lista de permissões. Para obter mais informações, consulte Allowing access by GitHub Apps e Enabling allowed IP addresses na documentação do GitHub.

Os seguintes endereços IP são usados para acessar seus recursos do GitHub:

34.228.181.128
44.219.176.187
54.226.244.221

Agentes do Amazon Q Developer

Os agentes do Amazon Q Developer fornecem suporte em todo o ciclo de vida de desenvolvimento de software, desde a codificação, o teste e a implantação até a solução de problemas e a modernização de aplicações.

  • Agente de desenvolvimento do Amazon Q: após criar um problema e adicionar o rótulo de desenvolvimento de recursos, o Amazon Q Developer implementa automaticamente seus novos recursos e correções de bugs. O Amazon Q Developer cria uma solicitação pull com as alterações e um resumo das alterações. Em vez de aplicar um rótulo, você também pode iniciar o desenvolvimento de recursos com o comando de barra /q dev em um comentário sobre o problema. Para obter mais informações, consulte Desenvolver funcionalidades e iterar com o Amazon Q Developer no GitHub.

  • Agente de revisão de código do Amazon Q: quando uma nova solicitação pull é criada ou uma solicitação pull fechada é reaberta, o Amazon Q Developer realiza automaticamente uma revisão de código e fornece feedback sobre a qualidade do código, possíveis problemas e questões de segurança. O Amazon Q Developer também gera correções para os problemas identificados, que você pode revisar e selecionar se deseja incluir na solicitação pull. A revisão de código inclui um resumo da revisão de código com descobertas agrupadas. Você pode interagir com o Amazon Q Developer usando o comando /q nos comentários da solicitação pull para fazer perguntas sobre as descobertas da revisão de código.

    As revisões automáticas de código não são acionadas por confirmações subsequentes feitas em uma solicitação pull existente. Você pode iniciar revisões de código adicionais em solicitações pull com o comando de barra /q review. Para obter mais informações, consulte Revisar código com o Amazon Q Developer no GitHub.

  • Agente de transformação do Amazon Q: após criar um problema e adicionar o rótulo de transformação de código, o Amazon Q Developer transforma seu código da versão 8 ou 11 do Java para a versão 17. O Amazon Q Developer cria uma solicitação pull com as alterações e um resumo das alterações. Em vez de aplicar um rótulo, você também pode iniciar a transformação do código com o comando de barra /q transform em um comentário sobre o problema. Para obter mais informações, consulte Transformar código com o Amazon Q Developer no GitHub.

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.

Registrar a instalação da aplicação

A integração do Amazon Q Developer para o GitHub está disponível gratuitamente, sem a necessidade de configurar uma conta da AWS para começar. Você recebe invocações limitadas por mês para desenvolvimento de recursos e transformação de código, bem como um número limitado de linhas para revisões de código por mês. Você pode aumentar o uso gratuito registrando a instalação da aplicação do Amazon Q Developer com sua conta da AWS. Para obter mais informações, consulte Aumentar os limites de uso e configurar detalhes no console do Amazon Q Developer.

Importante

Para registrar a instalação da aplicação no console do Amazon Q Developer, você deverá atender aos requisitos da organização do GitHub. Para obter mais informações, consulte Requirements to install a GitHub App e OAuth apps and organizations na documentação do GitHub.

Usar extensões de navegador no GitHub

Você pode usar a extensão do Amazon Q Developer em um navegador compatível para adicionar rapidamente um rótulo para desenvolvimento de recursos ou transformação de código em problemas do GitHub sem precisar pesquisar nos menus de rótulos.

A extensão do Amazon Q Developer está disponível para os seguintes navegadores:

Usar comandos de barra em problemas do GitHub e solicitações pull

Você pode usar comandos de barra em comentários em problemas do GitHub ou solicitações pull para invocar o Amazon Q Developer para realizar tarefas de desenvolvimento ou fornecer suporte.

  • /q dev: invoca o Amazon Q Developer em um problema do GitHub para implementar automaticamente novos recursos e correções de bugs. O Amazon Q Developer cria uma solicitação pull com as alterações e um resumo das alterações.

  • /q review: invoca o Amazon Q Developer para realizar automaticamente revisões de código quando as solicitações pull são criadas ou reabertas. As revisões de código fornecem feedback sobre a qualidade do código, possíveis problemas e questões de segurança, além de sugestões de correções e resumos de revisões de código com descobertas agrupadas. Use /q em comentários de solicitações pull para interagir com as descobertas. As revisões automáticas não são acionadas por confirmações subsequentes em solicitações pull existentes.

  • /q transform: invoca o Amazon Q Developer para transformar automaticamente o código Java 8 ou 11 em Java 17 quando um problema é criado com o rótulo de transformação de código. O Amazon Q Developer cria uma solicitação pull com as alterações e um resumo das modificações.

  • /q help: fornece informações sobre o Amazon Q Developer para GitHub, incluindo comandos de barra, recursos, detalhes de personalização, bem como um link para a documentação do Amazon Q Developer para GitHub (Demonstração) no Guia do desenvolvedor do Amazon Q Developer.