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á.
# 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](https://github.com/marketplace/amazon-q-developer) 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 e resolver vulnerabilidades com testes de unidade. 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](#github-agents).
Você pode acessar a integração do Amazon Q Developer por meio do [https://github.com/marketplace/amazon-q-developer](https://github.com/marketplace/amazon-q-developer) 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](github-quickstart.md).
**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](https://docs.github.com/en/enterprise-cloud@latest/apps/using-github-apps/installing-a-github-app-from-a-third-party#requirements-to-install-a-github-app) e [Roles in organization](https://docs.github.com/en/organizations/managing-peoples-access-to-your-organization-with-roles/roles-in-an-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](https://docs.aws.amazon.com/amazonq/latest/qdeveloper-ug/cross-region-processing.html).
**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.
**Topics**
+ [Instalar a aplicação do Amazon Q Developer e autorizar o acesso](#github-concepts-set-up)
+ [Agentes do Amazon Q Developer](#github-agents)
+ [Registrar a instalação da aplicação](#github-concepts-register-app-install)
+ [Usar extensões de navegador no GitHub](#github-concepts-extensions)
+ [Usar comandos de barra em problemas do GitHub e solicitações pull](#github-slash-commands)
+ [Início rápido: instalar, usar recursos no GitHub e aumentar limites de uso](github-quickstart.md)
+ [Desenvolver funcionalidades e iterar com o Amazon Q Developer no GitHub](github-feature-development.md)
+ [Revisar código com o Amazon Q Developer no GitHub](github-code-reviews.md)
+ [Aumentar os limites de uso e configurar detalhes no console do Amazon Q Developer](github-register-app-install.md)
+ [Configurar detalhes da instalação registrada](github-configuration.md)
+ [Solucionar problemas do Amazon Q Developer para GitHub](github-troubleshooting.md)
## Instalar a aplicação do Amazon Q Developer e autorizar o acesso
Como administrador GitHub da organização, você pode instalar e configurar o aplicativo Amazon Q Developer [https://github.com/apps/amazon-q-developer](https://github.com/apps/amazon-q-developer)gratuitamente, sem a necessidade de configurar uma AWS conta 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](https://us-east-1.console.aws.amazon.com/amazonq/developer/home#/github). Para obter mais informações, consulte [Início rápido: instalar, usar recursos no GitHub e aumentar limites de uso](github-quickstart.md).
**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](https://docs.github.com/en/enterprise-cloud@latest/apps/using-github-apps/installing-a-github-app-from-a-third-party#requirements-to-install-a-github-app) e [Roles in organization](https://docs.github.com/en/organizations/managing-peoples-access-to-your-organization-with-roles/roles-in-an-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](https://docs.github.com/en/enterprise-cloud@latest/organizations/keeping-your-organization-secure/managing-security-settings-for-your-organization/managing-allowed-ip-addresses-for-your-organization#allowing-access-by-github-apps) e [Enabling allowed IP addresses](https://docs.github.com/en/enterprise-cloud@latest/organizations/keeping-your-organization-secure/managing-security-settings-for-your-organization/managing-allowed-ip-addresses-for-your-organization#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 do desenvolvimento de software, desde a codificação, o teste e a implantação até a solução de problemas.
+ **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](github-feature-development.md).
+ **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](github-code-reviews.md).
**Importante**
O aplicativo Amazon Q Developer tenta criar automaticamente a etiqueta do **agente de desenvolvimento Amazon Q** nos GitHub repositórios aos quais você autoriza o acesso. Se o rótulo não for criado automaticamente ou se for excluído involuntariamente, você poderá criá-lo manualmente no. GitHub A etiqueta deve ser nomeada como **agente de desenvolvimento Amazon Q** para que seja reconhecida e processada como uma etiqueta Amazon Q Developer. Para obter mais informações, consulte [Creating a label](https://docs.github.com/en/issues/using-labels-and-milestones-to-track-work/managing-labels#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 o desenvolvimento de recursos, bem como um número limitado de linhas para análises 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](github-register-app-install.md).
**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 [Requisitos para instalar um GitHub aplicativo](https://docs.github.com/en/enterprise-cloud@latest/apps/using-github-apps/installing-a-github-app-from-a-third-party#requirements-to-install-a-github-app) [e OAuth aplicativos e organizações](https://docs.github.com/en/apps/oauth-apps/using-oauth-apps/authorizing-oauth-apps#oauth-apps-and-organizations) na *GitHubdocumentação*.
## Usar extensões de navegador no GitHub
Você pode usar a extensão Amazon Q Developer em um navegador compatível para adicionar rapidamente um rótulo para desenvolvimento de recursos em GitHub edições sem precisar pesquisar nos menus de rótulos.
A extensão do Amazon Q Developer está disponível para os seguintes navegadores:
+ [Google Chrome](https://chromewebstore.google.com/detail/amazon-q-github-issue-hel/oefafjbablenakmhacfllkmpaeabnnfi)
+ [Mozilla Firefox](https://addons.mozilla.org/en-US/firefox/addon/amazon-q-github-issue-helper)
+ [Microsoft Edge](https://microsoftedge.microsoft.com/addons/detail/amazon-q-github-issue-helper/poghackjbfhejeppjaegbnblangjbmmc)
## 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 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)](#amazon-q-for-github) no *Guia do desenvolvedor do Amazon Q Developer*.
# Início rápido: instalar, usar recursos no GitHub e aumentar limites de uso
**nota**
O Amazon Q Developer para GitHub está na versão prévia e está sujeito a alterações.
Este tutorial apresenta um passo a passo das seguintes tarefas:
1. Instale a aplicação do Amazon Q Developer no GitHub Marketplace e forneça acesso aos seus repositórios.
1. Comece a usar o Amazon Q Developer em um problema adicionando um rótulo para desenvolvimento de recursos ou criando uma nova pull request para análise de código. Como alternativa, você pode usar comandos de barra em problemas para iniciar o desenvolvimento de recursos. Você também pode iniciar revisões de código adicionais em solicitações pull com um comando de barra.
1. (Opcional) Registre a instalação do aplicativo Amazon Q Developer com sua AWS conta para aumentar seus limites de uso.
## Etapa 1: instalar o Amazon Q Developer no GitHub e autorizar o acesso
Você pode usar o Amazon Q Developer GitHub gratuitamente sem a necessidade de configurar uma AWS conta para começar. A primeira etapa para usar o Amazon Q Developer no GitHub é instalar a aplicação por meio do [https://github.com/marketplace/amazon-q-developer](https://github.com/marketplace/amazon-q-developer). Durante esse processo, você pode fornecer ao Amazon Q Developer acesso a todos os seus repositórios do GitHub ou repositórios selecionados.
**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](https://docs.github.com/en/enterprise-cloud@latest/apps/using-github-apps/installing-a-github-app-from-a-third-party#requirements-to-install-a-github-app) e [Roles in organization](https://docs.github.com/en/organizations/managing-peoples-access-to-your-organization-with-roles/roles-in-an-organization) na *documentação do GitHub*.
**Como instalar o Amazon Q Developer e autorizar o acesso**
1. Navegue até a página [Amazon Q Developer for GitHub app](https://github.com/marketplace/amazon-q-developer).
1. Se necessário, faça login na sua conta do [https://github.com/](https://github.com/) usando suas credenciais do GitHub.
1. Revise a visão geral e os recursos da aplicação do Amazon Q Developer e selecione **Instalar**.
1. Faça o seguinte para configurar o acesso aos seus repositórios do GitHub:
1. Para fornecer acesso a todos os repositórios atuais e futuros, selecione **Todos os repositórios**.
1. Para fornecer acesso a repositórios específicos, selecione **Somente selecionar repositórios**, escolha a lista suspensa **Selecionar repositórios** e, depois, selecione um repositório que você deseja permitir o acesso.
1. Selecione **Instalar** para concluir a instalação do Amazon Q Developer no GitHub e autorizá-lo a acessar seus repositórios.
Após instalar a aplicação no GitHub e autorizar o acesso, o sistema redirecionará você para a página de visão geral do Amazon Q Developer no GitHub. Você pode navegar até seu repositório do GitHub para começar a usar os recursos do Amazon Q Developer.
**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](https://docs.github.com/en/enterprise-cloud@latest/organizations/keeping-your-organization-secure/managing-security-settings-for-your-organization/managing-allowed-ip-addresses-for-your-organization#allowing-access-by-github-apps) e [Enabling allowed IP addresses](https://docs.github.com/en/enterprise-cloud@latest/organizations/keeping-your-organization-secure/managing-security-settings-for-your-organization/managing-allowed-ip-addresses-for-your-organization#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
```
## Etapa 2: usar recursos do Amazon Q Developer no GitHub
Depois de instalar o aplicativo Amazon Q Developer GitHub e autorizar o acesso aos seus repositórios, você pode começar a usar os agentes do Amazon Q Developer para obter suporte em todo o ciclo de vida do desenvolvimento de software, desde a codificação, o teste e a implantação até a solução de problemas de aplicativos. Para obter mais informações, consulte um dos seguintes:
**Importante**
O aplicativo Amazon Q Developer tenta criar automaticamente a etiqueta do **agente de desenvolvimento Amazon Q** nos GitHub repositórios aos quais você autoriza o acesso. Se o rótulo não for criado automaticamente ou se for excluído involuntariamente, você poderá criá-lo manualmente no. GitHub A etiqueta deve ser nomeada como **agente de desenvolvimento Amazon Q** para que seja reconhecida e processada como uma etiqueta Amazon Q Developer. Para obter mais informações, consulte [Creating a label](https://docs.github.com/en/issues/using-labels-and-milestones-to-track-work/managing-labels#creating-a-label) na *documentação do GitHub*.
+ [Desenvolver funcionalidades e iterar com o Amazon Q Developer no GitHub](github-feature-development.md)
+ [Revisar código com o Amazon Q Developer no GitHub](github-code-reviews.md)
## Etapa 3: aumentar os limites de uso gratuito e configurar os detalhes
Você pode usar os agentes do Amazon Q Developer no GitHub 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 revisão de código. Você pode aumentar seu uso gratuito a qualquer momento registrando a instalação do aplicativo Amazon Q Developer em sua AWS conta. O registro também permite configurar detalhes, como desabilitar revisões de código e adicionar tags para pesquisa e filtragem. Para obter mais informações, consulte [Aumentar os limites de uso e configurar detalhes no console do Amazon Q Developer](github-register-app-install.md).
**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 [Requisitos para instalar um GitHub aplicativo](https://docs.github.com/en/enterprise-cloud@latest/apps/using-github-apps/installing-a-github-app-from-a-third-party#requirements-to-install-a-github-app) [e OAuth aplicativos e organizações](https://docs.github.com/en/apps/oauth-apps/using-oauth-apps/authorizing-oauth-apps#oauth-apps-and-organizations) na *GitHubdocumentação*.
# 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](github-register-app-install.md).
**Importante**
O aplicativo Amazon Q Developer tenta criar automaticamente a etiqueta do **agente de desenvolvimento Amazon Q** nos GitHub repositórios aos quais você autoriza o acesso. Se o rótulo não for criado automaticamente ou se for excluído involuntariamente, você poderá criá-lo manualmente no. GitHub A etiqueta deve ser nomeada como **agente de desenvolvimento Amazon Q** para que seja reconhecida e processada como uma etiqueta Amazon Q Developer. Para obter mais informações, consulte [Creating a label](https://docs.github.com/en/issues/using-labels-and-milestones-to-track-work/managing-labels#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 [https://github.com/](https://github.com/) usando suas credenciais do GitHub.
1. 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.
1. Selecione **Problemas** e, em seguida, crie um novo problema ou selecione um problema existente. Para obter mais informações, consulte [Create an issue](https://docs.github.com/en/issues/tracking-your-work-with-issues/using-issues/creating-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](https://docs.github.com/en/issues/tracking-your-work-with-issues/using-issues/editing-an-issue) na *documentação do GitHub*.
1. 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`.
1. Escolha **Comment (Comentário)**.
1. 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](https://docs.github.com/en/issues/tracking-your-work-with-issues/using-issues/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.
1. Navegue até o comentário deixado pelo Amazon Q Developer (exemplo: “`I finished the proposed code changes, and the pull request is ready for review: [PR link]`”) 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.
1. Selecione a guia **Arquivos alterados** para ver as alterações no código.
1. 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](https://docs.github.com/en/pull-requests/collaborating-with-pull-requests/incorporating-changes-from-a-pull-request/merging-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.
1. Opcionalmente, para linhas de código específicas sobre as quais você deseja fornecer feedback, escolha **\$1** para adicionar um comentário com feedback.
Na conversa, você pode usar o `/q` comando seguido por suas instruções em linguagem natural (por exemplo, `/q implement my suggestions` ou`/q refactor this function for better performance`). O Amazon Q Developer responderá com um comentário descrevendo as alterações que fará com base no seu feedback (por exemplo, “Implementarei as seguintes alterações com base no feedback:...”). Quando a implementação for concluída, o Amazon Q Developer publicará outro comentário confirmando as alterações (por exemplo, “Eu implementei as alterações sugeridas”) junto com um link para o commit gerado, onde você poderá visualizar as alterações.
1. Analise as alterações feitas pelo Amazon Q Developer seguindo o link de confirmação fornecido na conversa. Você pode continuar fornecendo feedback adicional usando o `/q` comando para novas iterações, conforme necessário.
1. 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](https://docs.github.com/en/pull-requests/collaborating-with-pull-requests/incorporating-changes-from-a-pull-request/merging-a-pull-request).
# Revisar código 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.
O Amazon Q Developer permite revisões automatizadas de código dentro do GitHub. Quando você cria uma solicitação pull ou reabre uma solicitação pull fechada, 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 descobertas de alta severidade. Cada revisão inclui um resumo da revisão de código com descobertas agrupadas. 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. Você pode usar o comando `/q` nos comentários da solicitação pull para fazer perguntas e interagir com relação às 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.
**nota**
A configuração do recurso de revisões de código no console do Amazon Q Developer controla as revisões de código automatizadas que são executadas quando as pull requests são criadas ou reabertas. Iniciar análises de código usando o comando `/q review` slash nos comentários do pull request não é afetado por essa configuração.
Você também pode iniciar revisões de código em solicitações pull com o comando de barra `/q review`. O comando de barra pode ser adicionado a um novo comentário da solicitação pull, iniciando uma nova revisão de código da solicitação pull em seu estado atual, incluindo quaisquer comentários e novas confirmações. Para obter mais informações, consulte [Iniciar revisões de código em solicitações pull do GitHub](#github-code-reviews-in-pr).
Você pode fazer com que o Amazon Q Developer realize uma revisão de código para uma quantidade limitada de linhas 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](github-register-app-install.md).
**nota**
Se a capacidade de revisão de código foi desabilitada anteriormente, ela deve ser habilitada no [console do Amazon Q Developer](https://us-east-1.console.aws.amazon.com/amazonq/developer/home#/github) antes que você possa aplicar o rótulo no GitHub. Para obter mais informações, consulte [Editar recursos para o Amazon Q Developer no GitHub](github-configuration.md#github-edit-features).
## Pré-requisitos
Antes de iniciar revisões de código com o Amazon Q Developer, você precisará das permissões apropriadas para o repositório de destino do GitHub. As funções de repositório compatíveis são Gravação, Manutenção ou Administração. Usuários com as funções Leitura ou Triagem, bem como membros sem função, não poderão iniciar revisões de código com o Amazon Q Developer.
Usuários do GitHub com a função Triagem ainda poderão revisar solicitações pull em um repositório. Qualquer usuário, independentemente da função, poderá revisar solicitações pull em repositórios públicos.
Para obter mais informações, consulte [Repository roles for organizations](https://docs.github.com/en/organizations/managing-user-access-to-your-organizations-repositories/managing-repository-roles/repository-roles-for-an-organization#repository-roles-for-organizations) e [About pre-defined organization roles](https://docs.github.com/en/organizations/managing-peoples-access-to-your-organization-with-roles/roles-in-an-organization#about-pre-defined-organization-roles) na *documentação do GitHub*.
## Iniciar revisões de código para solicitações pull do GitHub
Quando você abre uma nova solicitação pull ou reabre uma anteriormente fechada, o Amazon Q Developer executa automaticamente uma revisão de código e fornece feedback sobre a qualidade do código, possíveis problemas e descobertas críticas.
**Como usar o Amazon Q Developer para revisões de código e aplicação de correções**
Antes de iniciar uma revisão, você pode personalizar uma revisão de qualidade de código definindo padrões de codificação personalizados em arquivos Markdown simples no diretório `project-root/.amazonq/rules`. O Amazon Q segue automaticamente suas diretrizes, garantindo uma qualidade de código consistente em todo o seu projeto. Para obter mais informações, consulte [Criar regras de projeto para o Amazon Q Developer em plataformas de terceiros](third-party-context-project-rules.md).
1. Se necessário, faça login na sua conta do [https://github.com/](https://github.com/) usando suas credenciais do GitHub.
1. Navegue até sua organização do GitHub e, em seguida, navegue até o repositório no qual deseja realizar uma revisão de código com o Amazon Q Developer.
1. Crie uma nova solicitação pull para as alterações feitas em seu código-fonte. Para obter mais informações, consulte [Creating a pull request](https://docs.github.com/en/pull-requests/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/creating-a-pull-request) na *documentação do GitHub*.
Quando você cria uma solicitação pull, o Amazon Q Developer inicia automaticamente uma revisão de código para encontrar possíveis problemas. Depois que o Amazon Q Developer conclui a revisão, ele fornece um resumo da revisão de código. Cada descoberta aparece como um comentário agrupado abaixo do resumo, com correções sugeridas que você pode aplicar à solicitação pull.
1. Peça ao agente que implemente alterações e crie commits diretamente na ramificação de origem da sua pull request. Você pode fazer isso postando um comentário começando com `/q` e seguido por sua solicitação em linguagem natural para que o agente faça alterações.
1. (Opcional) Faça perguntas sobre descobertas específicas. Na solicitação pull, navegue até **Adicionar um comentário** e, no campo de entrada de texto do comentário, digite `/q` seguido pela sua pergunta (por exemplo, “`/q explain the importance of this finding`”).
1. Revise as alterações de código propostas pelo Amazon Q Developer, clique em **Confirmar sugestão** e, em seguida, **Confirmar alterações** para atualizar a solicitação pull.
1. Se as correções de código sugeridas forem satisfatórias, você poderá mesclar a solicitação pull para aplicar as alterações de código sugeridas pelo Amazon Q Developer. Para obter mais informações, consulte [Merging a pull request](https://docs.github.com/en/pull-requests/collaborating-with-pull-requests/incorporating-changes-from-a-pull-request/merging-a-pull-request) na *documentação do GitHub*.
## Iniciar revisões de código em solicitações pull do GitHub
Após uma revisão automática de código realizada pelo Amazon Q Developer para uma solicitação pull do GitHub nova ou reaberta, você pode iniciar revisões de código adicionais para iterar seu código usando o comando de barra `/q review`. A revisão de código é realizada em toda a comparação da solicitação pull.
**nota**
Você só pode iniciar uma revisão de código em uma solicitação pull com um novo comentário. O comando de barra `/q review` não funcionará em uma thread de comentários existente. Iniciar uma revisão de código usando o comando `/q review` slash não é afetado pela configuração do recurso de revisões de código no console do Amazon Q Developer.
**Como iniciar revisões de código em uma solicitação pull**
1. Se necessário, faça login na sua conta do [https://github.com/](https://github.com/) usando suas credenciais do GitHub.
1. Navegue até sua organização do GitHub e, em seguida, navegue até a solicitação pull na qual você deseja realizar uma revisão de código com o Amazon Q Developer. Para obter mais informações, consulte [About pull requests](https://docs.github.com/en/pull-requests/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/about-pull-requests).
1. Na solicitação pull, navegue até **Adicionar um comentário** e, no campo de entrada de texto do comentário, insira `/q review`.
1. Selecione **Comentar** para iniciar a revisão de código.
Pode levar alguns minutos para que o Amazon Q Developer conclua a análise da solicitação pull. Depois que o Amazon Q Developer terminar a análise, ele fornecerá um resumo da revisão de código. Cada descoberta aparece como um comentário agrupado abaixo do resumo, com as alterações propostas que você pode escolher para aplicar e atualizar a solicitação pull.
1. (Opcional) Faça perguntas sobre descobertas específicas. Na solicitação pull, navegue até **Adicionar um comentário** e, no campo de entrada de texto do comentário, digite `/q` seguido pela sua pergunta (por exemplo, “`/q explain the importance of this finding`”).
1. Se as correções de código sugeridas forem satisfatórias, você poderá mesclar a solicitação pull para aplicar as alterações de código sugeridas pelo Amazon Q Developer. Para obter mais informações, consulte [Merging a pull request](https://docs.github.com/en/pull-requests/collaborating-with-pull-requests/incorporating-changes-from-a-pull-request/merging-a-pull-request) na *documentação do GitHub*.
# Aumentar os limites de uso e configurar detalhes no console do Amazon Q Developer
**nota**
O Amazon Q Developer para GitHub está na versão prévia e está sujeito a alterações.
Você pode usar os agentes do Amazon Q Developer GitHub gratuitamente, sem a necessidade de configurar uma AWS conta para começar. Você recebe invocações limitadas por mês para os recursos de desenvolvimento de recursos e revisão de código. Você pode aumentar seu uso gratuito a qualquer momento registrando a instalação do aplicativo Amazon Q Developer em sua AWS conta.
Por padrão, as **revisões de código** e os **recursos de desenvolvimento** de recursos são ativados GitHub quando você instala o aplicativo. Você pode desabilitar qualquer um desses recursos ao se registrar. O registro exige um perfil do Amazon Q Developer para gerenciar os recursos por meio do console. O perfil armazena suas configurações e a personalização da recomendação de código.
**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 [Requisitos para instalar um GitHub aplicativo](https://docs.github.com/en/enterprise-cloud@latest/apps/using-github-apps/installing-a-github-app-from-a-third-party#requirements-to-install-a-github-app) [e OAuth aplicativos e organizações](https://docs.github.com/en/apps/oauth-apps/using-oauth-apps/authorizing-oauth-apps#oauth-apps-and-organizations) na *GitHubdocumentação*.
**Como registrar sua instalação do Amazon Q Developer**
1. Navegue até o [console do Amazon Q Developer](https://us-east-1.console.aws.amazon.com/amazonq/developer/home).
1. Escolha **Enable Q Developer** na parte superior da página e siga as instruções para ativar o Kiro e o Amazon Q Developer.
Se você habilitou anteriormente o Kiro e o Amazon Q Developer, vá para a etapa 3.
1. No painel de navegação, escolha **Amazon Q Developer em GitHub**.
1. Selecione **Registrar instalação** e, em seguida, **Autorizar** para acessar o GitHub.
Se você já autorizou o Amazon Q Developer a acessar sua organização do GitHub, o sistema redirecionará você de volta para o console do Amazon Q Developer. Nesse caso, vá para a etapa 7.
1. Faça login na sua conta do GitHub usando suas credenciais do GitHub. Se você tiver várias contas, selecione a conta na qual deseja fornecer acesso ao Amazon Q Developer.
1. Selecione **Autorizar o Amazon Q Developer** para fornecer acesso à sua conta do GitHub. O sistema redirecionará você de volta para o console do Amazon Q Developer após a autorização.
1. Em **Detalhes do registro**, insira seus dados do GitHub, configure opcionalmente o recurso de revisão de código e adicione tags.
1. No campo de entrada de texto **Nome do registro**, insira um nome para a instalação da sua aplicação.
1. (Opcional) No campo de entrada de texto **Nome da organização - *opcional***, insira um nome para a organização associada à instalação da aplicação.
1. (Opcional) Em **Recursos**, configure o recurso **Revisões de código** clicando no botão de opção para habilitar ou desabilitar o recurso. A configuração **de desenvolvimento de recursos** não pode ser modificada e está ativada por padrão.
1. (Opcional) Em **Tags - opcional**, escolha **Adicionar nova tag** para adicionar uma tag que possa ajudar a pesquisar e filtrar seus AWS recursosGitHub.
1. Escolha **Registrar** para registrar a instalação do aplicativo GitHub com sua AWS conta.
Depois de registrar com sucesso a instalação do aplicativo, você pode ver os detalhes do registro. Você ainda pode ativar ou desativar o recurso de análise de código, bem como adicionar tags posteriormente. Você também pode excluir o registro. Para obter mais informações, consulte [Configurar detalhes da instalação registrada](github-configuration.md).
# Configurar detalhes da instalação registrada
**nota**
O Amazon Q Developer para GitHub está na versão prévia e está sujeito a alterações.
Após criar um perfil do Amazon Q Developer e registrar a instalação da aplicação no GitHub, você poderá fazer o seguinte no console do Amazon Q Developer:
+ Habilitar ou desabilitar o uso de revisões de código. A configuração de desenvolvimento de recursos não pode ser modificada atualmente.
+ Encontrar links para extensões de navegador que fornecem uma forma de adicionar rótulos de recursos do Amazon Q Developer nos problemas do GitHub.
+ Adicione tags para pesquisar e filtrar seus recursos ou monitorar AWS custos.
+ Excluir um registro de instalação da aplicação do GitHub.
## Editar recursos para o Amazon Q Developer no GitHub
Os recursos disponíveis para o Amazon Q Developer no GitHub são habilitados por padrão quando você instala a aplicação no GitHub e fornece autorização para acessar sua organização. Você pode optar por desabilitar um recurso se não quiser mais usá-lo no GitHub.
**Como habilitar ou desabilitar um recurso para o Amazon Q Developer no GitHub**
1. Navegue até o [console do Amazon Q Developer](https://us-east-1.console.aws.amazon.com/amazonq/developer/home#/github).
1. No painel de navegação, em **Amazon Q Developer no GitHub**, selecione **Instalações registradas**.
1. Na coluna **Nome**, selecione o nome de registro da instalação para a qual deseja habilitar ou desabilitar um recurso.
1. Em **Recursos**, selecione **Editar** para configurar a disponibilidade do recurso.
1. No modal, clique no botão de opção do recurso que deseja habilitar ou desabilitar e, em seguida, clique em **Salvar** para confirmar as alterações.
Após habilitar ou desabilitar um recurso no [console do Amazon Q Developer](https://us-east-1.console.aws.amazon.com/amazonq/developer/home#/github), as alterações serão exibidas no GitHub. A tentativa de atribuir um problema a um rótulo do Amazon Q Developer após desabilitar o recurso resultará em um erro. As revisões de código não ocorrerão mais em novas solicitações pull se o recurso estiver desabilitado.
## Instalar as extensões do navegador
Você pode instalar a extensão do Amazon Q Developer em um dos navegadores compatíveis. A extensão permite que você atribua rapidamente tarefas de desenvolvimento de recursos ao Amazon Q Developer em GitHub problemas sem precisar pesquisar nos menus de etiquetas.
A extensão do Amazon Q Developer está disponível para os seguintes navegadores:
+ [Google Chrome](https://chromewebstore.google.com/detail/amazon-q-github-issue-hel/oefafjbablenakmhacfllkmpaeabnnfi)
+ [Mozilla Firefox](https://addons.mozilla.org/en-US/firefox/addon/amazon-q-github-issue-helper)
+ [Microsoft Edge](https://microsoftedge.microsoft.com/addons/detail/amazon-q-github-issue-helper/poghackjbfhejeppjaegbnblangjbmmc)
Você também pode ver os navegadores compatíveis na página de detalhes da instalação do registro no [console do Amazon Q Developer](https://us-east-1.console.aws.amazon.com/amazonq/developer/home#/github).
## Excluir o registro de instalação da aplicação do GitHub do Amazon Q Developer
Você pode excluir o registro de uma ou mais instalações da aplicação do GitHub por meio do console do Amazon Q Developer. Após excluir permanentemente seu registro, todos os dados associados ao registro também serão excluídos. A ação não pode ser desfeita.
**Como excluir a instalação da aplicação do GitHub**
1. Navegue até o [console do Amazon Q Developer](https://us-east-1.console.aws.amazon.com/amazonq/developer/home#/github).
1. No painel de navegação, em **Amazon Q Developer no GitHub**, selecione **Instalações registradas**.
1. Execute um destes procedimentos:
+ Na coluna **Ações**, selecione **Excluir registro** para a instalação que deseja excluir.
+ Na coluna **Nome**, selecione o nome do registro para a instalação que deseja excluir e clique em **Excluir**.
Na coluna **Ações**, selecione **Excluir registro** para a instalação registrada que deseja excluir.
1. No modal, revise os detalhes para excluir o registro.
1. No campo de entrada de texto, insira **confirm** e, em seguida, selecione **Excluir** para confirmar as alterações.
Após excluir uma instalação de aplicação do GitHub, você poderá optar por registrar uma nova instalação.
# Solucionar problemas do Amazon Q Developer para GitHub
Consulte a seção a seguir para solucionar problemas comuns ao usar o Amazon Q Developer para GitHub.
## O Amazon Q Developer não gera solicitações pull em repositórios com regras de proteção de ramificação
**Problema**: o Amazon Q Developer não consegue criar uma solicitação pull no meu repositório do GitHub, que tem regras de proteção de ramificação.
**Solução**: as regras de proteção de ramificação impedem que o Amazon Q Developer crie uma ramificação para criar uma solicitação pull. Para usar o Amazon Q Developer para GitHub em repositórios com regras de proteção de ramificação, você precisa adicionar a aplicação do Amazon Q Developer à sua lista de permissões.
**Como adicionar a aplicação do Amazon Q Developer à lista de permissões**
1. Se necessário, faça login na sua conta do [https://github.com/](https://github.com/) usando suas credenciais do GitHub.
1. Navegue até sua organização do GitHub e, em seguida, acesse o repositório no qual deseja adicionar a aplicação do Amazon Q Developer para GitHub à lista de permissões.
1. Clique em **Configurações** e, em seguida, selecione **Ramificações** no painel de navegação.
1. Em **Regras de proteção de ramificação**, selecione **Editar** para modificar as regras de proteção de ramificação.
1. Selecione **Restringir envios que criam ramificações correspondentes** e pesquise a aplicação do Amazon Q Developer para GitHub.
1. Clique em **Salvar alterações** para permitir que o Amazon Q Developer crie solicitações pull para problemas com os rótulos do Amazon Q Developer.
Para saber mais sobre como modificar as regras de proteção de ramificação no GitHub, consulte [Creating a branch protection rule](https://docs.github.com/en/repositories/configuring-branches-and-merges-in-your-repository/managing-protected-branches/managing-a-branch-protection-rule#creating-a-branch-protection-rule).
## Rótulos do Amazon Q Developer ausentes em problemas do GitHub
**Problema**: não vejo o rótulo do **agente de desenvolvimento Amazon Q** nos GitHub problemas.
**Solução**: Se a etiqueta não for criada automaticamente quando você instalou o GitHub aplicativo Amazon Q Developer for, ou se tiver sido excluída acidentalmente, você poderá criá-la manualmente no. GitHub A etiqueta deve ser nomeada como **agente de desenvolvimento Amazon Q** para que seja reconhecida e processada como uma etiqueta Amazon Q Developer. Para obter mais informações, consulte [Creating a label](https://docs.github.com/en/issues/using-labels-and-milestones-to-track-work/managing-labels#creating-a-label) na *documentação do GitHub*.
## O Amazon Q Developer não está criando código para problemas do GitHub
**Problema**: criei um problema do GitHub e invoquei o Amazon Q Developer para realizar uma tarefa, mas recebi a seguinte série de mensagens sobre dificuldades técnicas:
1. ⏳ I'm working on generating code for this issue. I'll update this issue with a comment and open a pull request when I'm done.
1. ⚠️ I'm having technical difficulties. I couldn't solve the issue. I'm going to try again. This might take some time.
1. ⚠️ I'm having technical difficulties. I couldn't solve the issue. I'm going to try again. This might take some time.
1. 🔴 I'm having technical difficulties. I couldn't solve the issue.
Consider reassigning this issue to a user. This will help you stay within the quotas for generative AI feature usage.
**Solução**: Se o Amazon Q Developer não conseguir processar seu problema e gerar código para ele, crie um novo problema e aplique o rótulo de **agente de desenvolvimento Amazon Q** ao novo problema. Para saber mais sobre como criar um problema e aplicar um rótulo de agente Amazon Q Developer, consulte[Desenvolver funcionalidades e iterar com o Amazon Q Developer no GitHub](github-feature-development.md).