Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.
# Amazon Q Developer para GitHub (versión preliminar)
**nota**
Amazon Q Developer para GitHub está en versión de vista previa y sujeto a cambios.
[Amazon Q Developer para GitHub o GitHub Enterprise Cloud](https://github.com/marketplace/amazon-q-developer) le permite aprovechar las capacidades de Amazon Q Developer para sus flujos de trabajo de desarrollo de software. Con agentes de desarrollo especializados, puede implementar nuevas ideas, revisar el código para detectar problemas de calidad y abordar las vulnerabilidades con pruebas unitarias. Una vez que el agente complete una tarea, podrá enviar comentarios y el agente itera basándose en la solución anterior. Para obtener más información, consulte [Agentes de Amazon Q Developer](#github-agents).
Puede acceder a la integración de Amazon Q Developer a través de [https://github.com/marketplace/amazon-q-developer](https://github.com/marketplace/amazon-q-developer) y autorizarla para que dé acceso a los repositorios de su organización. Para empezar a utilizar Amazon Q Developer para GitHub, consulte [Inicio rápido: instalación, uso de características en GitHub y aumento de los límites de uso](github-quickstart.md).
**importante**
Para instalar la aplicación de Amazon Q Developer y autorizar el acceso a repositorios de GitHub, debe cumplir los requisitos de la organización de GitHub. Para obtener más información, 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) y [Roles in organization](https://docs.github.com/en/organizations/managing-peoples-access-to-your-organization-with-roles/roles-in-an-organization) en la *Documentación de GitHub*.
**nota**
La integración de Amazon Q Developer con GitHub procesa datos en Estados Unidos. Para obtener más información, consulte [Cross-region processing in Amazon Q Developer](https://docs.aws.amazon.com/amazonq/latest/qdeveloper-ug/cross-region-processing.html).
**nota**
Actualmente, Amazon Q Developer para GitHub (vista previa) no utiliza el contenido para mejorar el servicio. Si se habilita en el futuro, le proporcionaremos un aviso adecuado, así como una forma de dejar de usar esta opción.
**Topics**
+ [
## Instalación de la aplicación Amazon Q Developer y autorización del acceso
](#github-concepts-set-up)
+ [
## Agentes de Amazon Q Developer
](#github-agents)
+ [
## Registro de la instalación de aplicaciones
](#github-concepts-register-app-install)
+ [
## Uso de extensiones de navegador en GitHub
](#github-concepts-extensions)
+ [
## Uso de comandos de barra inclinada en problemas de GitHub y solicitudes de extracción
](#github-slash-commands)
+ [
# Inicio rápido: instalación, uso de características en GitHub y aumento de los límites de uso
](github-quickstart.md)
+ [
# Desarrollo de características e iteración con Amazon Q Developer en GitHub
](github-feature-development.md)
+ [
# Revisión de código con Amazon Q Developer en GitHub
](github-code-reviews.md)
+ [
# Aumento de los límites de uso y los detalles de configuración en la consola de Amazon Q Developer
](github-register-app-install.md)
+ [
# Configuración de los detalles de la instalación registrada
](github-configuration.md)
+ [
# Solución de problemas de Amazon Q Developer para GitHub
](github-troubleshooting.md)
## Instalación de la aplicación Amazon Q Developer y autorización del acceso
Como administrador de GitHub la organización, puedes instalar y configurar la aplicación Amazon Q Developer de [https://github.com/apps/amazon-q-developer](https://github.com/apps/amazon-q-developer)forma gratuita sin necesidad de configurar una AWS cuenta para empezar. Durante el proceso de instalación, puede optar por proporcionar acceso a todos los repositorios de su organización de GitHub o a algunos de ellos. Tras la instalación y la autorización, tendrá acceso al uso gratuito de las características de Amazon Q Developer en GitHub. Puede aumentar el uso gratuito registrando la instalación de la aplicación en la [consola de Amazon Q Developer](https://us-east-1.console.aws.amazon.com/amazonq/developer/home#/github). Para obtener más información, consulte [Inicio rápido: instalación, uso de características en GitHub y aumento de los límites de uso](github-quickstart.md).
**importante**
Para instalar la aplicación de Amazon Q Developer y autorizar el acceso a repositorios de GitHub, debe cumplir los requisitos de la organización de GitHub. Para obtener más información, 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) y [Roles in organization](https://docs.github.com/en/organizations/managing-peoples-access-to-your-organization-with-roles/roles-in-an-organization) en la *Documentación de GitHub*.
**nota**
Si su organización empresarial de GitHub ha habilitado las listas de IP permitidas, debe aceptar las direcciones IP permitidas en la aplicación de GitHub. También puede optar por añadir automáticamente las direcciones IP a su lista de direcciones permitidas. Para obtener más información, 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) y [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) en la *Documentación de GitHub*.
Las siguientes direcciones IP se utilizan para acceder a sus recursos de GitHub:
```
34.228.181.128
44.219.176.187
54.226.244.221
```
## Agentes de Amazon Q Developer
Los agentes desarrolladores de Amazon Q proporcionan asistencia durante todo el ciclo de vida del desarrollo del software, desde la codificación, las pruebas y la implementación hasta la solución de problemas.
+ **Agente de Amazon Q Developer**: tras crear un problema y añadir la etiqueta de desarrollo de características, Amazon Q Developer implementa automáticamente las nuevas características y las correcciones de errores. Amazon Q Developer crea una solicitud de extracción con los cambios y un resumen de los cambios. En lugar de aplicar una etiqueta, también puede iniciar el desarrollo de características con el comando de barra inclinada `/q dev` en un comentario del problema. Para obtener más información, consulte [Desarrollo de características e iteración con Amazon Q Developer en GitHub](github-feature-development.md).
+ **Agente de revisión de código de Amazon Q**: cuando se crea una nueva solicitud de extracción o se vuelve a abrir una solicitud de extracción cerrada, Amazon Q Developer realiza automáticamente una revisión del código y proporciona comentarios sobre la calidad del código, los posibles problemas y los problemas de seguridad. Amazon Q Developer también genera correcciones para los problemas identificados, que puede revisar y confirmar con la solicitud de extracción. La revisión del código incluye un resumen de la revisión del código con los resultados subprocesados. Puedes interactuar con Amazon Q Developer mediante el comando `/q` en los comentarios de las solicitudes de extracción para hacer preguntas sobre los resultados de la revisión del código.
Las revisiones automáticas del código no se activan con las confirmaciones posteriores realizadas dentro de una solicitud de extracción existente. Puede iniciar revisiones de código adicionales dentro de las solicitudes de extracción con el comando de barra inclinada `/q review`. Para obtener más información, consulte [Revisión de código con Amazon Q Developer en GitHub](github-code-reviews.md).
**importante**
La aplicación Amazon Q Developer intenta crear automáticamente la etiqueta de **agente de desarrollo de Amazon Q** en GitHub los repositorios a los que usted autoriza el acceso. Si la etiqueta no se crea automáticamente o si se elimina de forma no intencionada, puedes crearla manualmente en. GitHub La etiqueta debe tener el nombre de **agente de desarrollo de Amazon Q** para que se reconozca y procese como etiqueta de desarrollador de Amazon Q. Para obtener más información, consulte [Creating a label](https://docs.github.com/en/issues/using-labels-and-milestones-to-track-work/managing-labels#creating-a-label) en la *Documentación de GitHub*.
## Registro de la instalación de aplicaciones
La integración de Amazon Q Developer para GitHub está disponible de forma gratuita sin necesidad de configurar una cuenta de AWS para empezar. Dispones de un número limitado de llamadas al mes para el desarrollo de funciones, así como un número limitado de líneas para las revisiones de código al mes. Puede aumentar el uso gratuito registrando la instalación de las aplicaciones de Amazon Q Developer con su cuenta de AWS . Para obtener más información, consulte [Aumento de los límites de uso y los detalles de configuración en la consola de Amazon Q Developer](github-register-app-install.md).
**importante**
Para registrar la instalación de aplicaciones en la consola de Amazon Q Developer, debe cumplir los requisitos de la organización de GitHub. Para obtener más información, consulta [los requisitos para instalar una GitHub aplicación](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) y [OAuth las aplicaciones y organizaciones](https://docs.github.com/en/apps/oauth-apps/using-oauth-apps/authorizing-oauth-apps#oauth-apps-and-organizations) en la *GitHubdocumentación*.
## Uso de extensiones de navegador en GitHub
Puedes usar la extensión Amazon Q Developer en un navegador compatible para añadir rápidamente una etiqueta para el desarrollo de funciones en caso de GitHub problemas sin tener que buscar en los menús de etiquetas.
La extensión de Amazon Q Developer está disponible para los siguientes 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)
## Uso de comandos de barra inclinada en problemas de GitHub y solicitudes de extracción
Puede usar comandos de barra inclinada en los comentarios dentro de los problemas de GitHub o en las solicitudes de extracción para invocar a Amazon Q Developer para que realice tareas de desarrollo o brinde soporte.
+ `/q dev`: invoca a Amazon Q Developer en un problema de GitHub para implementar automáticamente nuevas características y correcciones de errores. Amazon Q Developer crea una solicitud de extracción con los cambios y un resumen de los cambios.
+ `/q review`: invoca a Amazon Q Developer para que revise automáticamente el código cuando se crean o se vuelven a abrir solicitudes de extracción. Las revisiones del código proporcionan comentarios sobre la calidad del código, los posibles problemas y los problemas de seguridad, junto con sugerencias de correcciones y resúmenes de las revisiones del código con resultados subprocesados. Utilice `/q` en los comentarios de las solicitudes de extracción para interactuar con los resultados. Las revisiones automáticas no se activan con las confirmaciones posteriores de solicitudes de extracción existentes.
+ `/q help`: proporciona información sobre Amazon Q Developer para GitHub, incluidos comandos de barra inclinada, características y detalles de personalización, así como un enlace a la documentación de [Amazon Q Developer para GitHub (versión preliminar)](#amazon-q-for-github) en la *Guía del desarrollador de Amazon Q Developer*.
# Inicio rápido: instalación, uso de características en GitHub y aumento de los límites de uso
**nota**
Amazon Q Developer para GitHub está en versión de vista previa y sujeto a cambios.
En este tutorial, encontrará información general sobre las siguientes tareas:
1. Instale la aplicación Amazon Q Developer desde GitHub Marketplace y proporcione acceso a sus repositorios.
1. Para empezar a trabajar con Amazon Q Developer en un número, añada una etiqueta para el desarrollo de funciones o cree una nueva solicitud de cambios para revisar el código. Como alternativa, puedes usar comandos de barra diagonal en los números para iniciar el desarrollo de funciones. También puede iniciar revisiones de código adicionales dentro de las solicitudes de extracción con un comando de barra inclinada.
1. (Opcional) Registra la instalación de la aplicación Amazon Q Developer en tu AWS cuenta para aumentar tus límites de uso.
## Paso 1: instalación de Amazon Q Developer en GitHub y autorización de acceso
Puedes usar Amazon Q Developer de GitHub forma gratuita sin necesidad de configurar una AWS cuenta para empezar. El primer paso para utilizar Amazon Q Developer en GitHub es instalar la aplicación desde [https://github.com/marketplace/amazon-q-developer](https://github.com/marketplace/amazon-q-developer). Durante este proceso, puede proporcionar a Amazon Q Developer acceso a todos sus repositorios de GitHub o a los repositorios seleccionados.
**importante**
Para instalar la aplicación de Amazon Q Developer y autorizar el acceso a repositorios de GitHub, debe cumplir los requisitos de la organización de GitHub. Para obtener más información, 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) y [Roles in organization](https://docs.github.com/en/organizations/managing-peoples-access-to-your-organization-with-roles/roles-in-an-organization) en la *Documentación de GitHub*.
**Cómo instalar Amazon Q Developer y autorizar el acceso**
1. Navegue a la página [Amazon Q Developer for GitHub app](https://github.com/marketplace/amazon-q-developer).
1. Si es necesario, inicie sesión en su cuenta de [https://github.com/](https://github.com/) usando sus credenciales de GitHub.
1. Revise la descripción general y las características de la aplicación Amazon Q Developer y, a continuación, elija **Instalar**.
1. Realice una de las siguientes acciones para configurar el acceso a sus repositorios de GitHub:
1. Para proporcionar acceso a todos los repositorios actuales y futuros, seleccione **Todos los repositorios**.
1. Para proporcionar acceso a repositorios específicos, seleccione **Solo repositorios seleccionados**, elija el menú desplegable **Seleccionar repositorios** y, a continuación, seleccione un repositorio al que desee permitir el acceso.
1. Elija **Instalar** para completar la instalación de Amazon Q Developer en GitHub y autorizarlo para acceder a sus repositorios.
Tras instalar la aplicación en GitHub y autorizar el acceso, se le redirigirá a la página de información general de Amazon Q Developer en GitHub. Puede navegar hasta su repositorio de GitHub para empezar a utilizar las características de Amazon Q Developer.
**nota**
Si su organización empresarial de GitHub ha habilitado las listas de IP permitidas, debe aceptar las direcciones IP permitidas en la aplicación de GitHub. También puede optar por añadir automáticamente las direcciones IP a su lista de direcciones permitidas. Para obtener más información, 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) y [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) en la *Documentación de GitHub*.
Las siguientes direcciones IP se utilizan para acceder a sus recursos de GitHub:
```
34.228.181.128
44.219.176.187
54.226.244.221
```
## Paso 2: uso de las características de Amazon Q Developer en GitHub
Tras instalar la aplicación Amazon Q Developer GitHub y autorizar el acceso a sus repositorios, puede empezar a utilizar los agentes de Amazon Q Developer como soporte durante todo el ciclo de vida del desarrollo de software, desde la codificación, las pruebas y el despliegue hasta la solución de problemas de las aplicaciones. Para obtener más información, consulte una de las siguientes:
**importante**
La aplicación Amazon Q Developer intenta crear automáticamente la etiqueta de **agente de desarrollo de Amazon Q** en GitHub los repositorios a los que usted autoriza el acceso. Si la etiqueta no se crea automáticamente o si se elimina de forma no intencionada, puedes crearla manualmente en. GitHub La etiqueta debe tener el nombre de **agente de desarrollo de Amazon Q** para que se reconozca y procese como etiqueta de desarrollador de Amazon Q. Para obtener más información, consulte [Creating a label](https://docs.github.com/en/issues/using-labels-and-milestones-to-track-work/managing-labels#creating-a-label) en la *Documentación de GitHub*.
+ [Desarrollo de características e iteración con Amazon Q Developer en GitHub](github-feature-development.md)
+ [Revisión de código con Amazon Q Developer en GitHub](github-code-reviews.md)
## Paso 3: aumento de los límites del uso gratuito y configuración de los detalles
Puede usar los agentes de Amazon Q Developer en GitHub de forma gratuita sin necesidad de configurar una cuenta de AWS para empezar. Dispones de un número limitado de solicitudes al mes para el desarrollo de funciones y la revisión del código. Puedes aumentar el uso gratuito en cualquier momento registrando la instalación de la aplicación Amazon Q Developer en tu AWS cuenta. El registro también te proporciona la capacidad de configurar detalles como deshabilitar las revisiones de código y agregar etiquetas para buscar y filtrar. Para obtener más información, consulte [Aumento de los límites de uso y los detalles de configuración en la consola de Amazon Q Developer](github-register-app-install.md).
**importante**
Para registrar la instalación de aplicaciones en la consola de Amazon Q Developer, debe cumplir los requisitos de la organización de GitHub. Para obtener más información, consulte [los requisitos para instalar una GitHub aplicación](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) y [OAuth las aplicaciones y organizaciones](https://docs.github.com/en/apps/oauth-apps/using-oauth-apps/authorizing-oauth-apps#oauth-apps-and-organizations) en la *GitHubdocumentación*.
# Desarrollo de características e iteración con Amazon Q Developer en GitHub
**nota**
Amazon Q Developer para GitHub está en versión de vista previa y sujeto a cambios.
Puede usar Amazon Q Developer en GitHub para agilizar el desarrollo mediante la implementación automática de nuevas características y correcciones de errores, llevando las tareas desde la idea hasta una solicitud de extracción completa. Al añadir la etiqueta de desarrollo de características a un problema o al usar el comando de barra inclinada `/q dev`, Amazon Q Developer utiliza el problema, incluidos su título y descripción, así como el código del repositorio como contexto para generar nuevas correcciones de código y crear una solicitud de extracción. En la solicitud de extracción, puede proporcionar comentarios y Amazon Q Developer itera sobre el código sugerido.
Puede hacer que Amazon Q Developer realice el desarrollo de características un número limitado de veces al mes. Puedes aumentar el uso gratuito en cualquier momento registrando la instalación de la aplicación Amazon Q Developer en tu AWS cuenta. Para obtener más información, consulte [Aumento de los límites de uso y los detalles de configuración en la consola de Amazon Q Developer](github-register-app-install.md).
**importante**
La aplicación Amazon Q Developer intenta crear automáticamente la etiqueta de **agente de desarrollo de Amazon Q** en GitHub los repositorios a los que usted autoriza el acceso. Si la etiqueta no se crea automáticamente o si se elimina de forma no intencionada, puedes crearla manualmente en. GitHub La etiqueta debe tener el nombre de **agente de desarrollo de Amazon Q** para que se reconozca y procese como etiqueta de desarrollador de Amazon Q. Para obtener más información, consulte [Creating a label](https://docs.github.com/en/issues/using-labels-and-milestones-to-track-work/managing-labels#creating-a-label) en la *Documentación de GitHub*.
**Cómo utilizar Amazon Q Developer para el desarrollo de características**
1. Si es necesario, inicie sesión en su cuenta de [https://github.com/](https://github.com/) usando sus credenciales de GitHub.
1. Navegue hasta la organización de GitHub y, a continuación, navegue hasta el repositorio en el que desee implementar nuevas características con Amazon Q Developer.
1. Elija **Problemas** y, a continuación, cree un nuevo problema o elija uno existente. Para obtener más información, consulte [Create an issue](https://docs.github.com/en/issues/tracking-your-work-with-issues/using-issues/creating-an-issue) en la *Documentación de GitHub*.
1. Para un número problema, en el campo de entrada de texto **Añadir un título**, introduzca un título que proporcione contexto a Amazon Q Developer para el desarrollo de la característica (por ejemplo: “Crear una aplicación de reconocimiento de imágenes”). También se debe incluir la descripción del problema, ya que también proporciona contexto.
En el caso de un problema existente, puede editar el título y la descripción del problema para proporcionar contexto a Amazon Q Developer para el desarrollo de la característica. Para obtener más información, consulte [Editing an issue](https://docs.github.com/en/issues/tracking-your-work-with-issues/using-issues/editing-an-issue) en la *Documentación de GitHub*.
1. Al crear un problema o configurar uno existente, puede aplicar la etiqueta de Amazon Q Developer de desarrollo de características o utilizar el comando de barra inclinada `/q dev`. Realice una de las siguientes acciones:
+ Para aplicar la etiqueta al problema, siga uno de estos pasos:
+ Seleccione el menú desplegable **Asignar a Amazon Q** que se proporciona como extensión del navegador y, a continuación, elija la etiqueta de **Agente de Amazon Q Developer**.
+ En el menú de la derecha, elija **Etiquetas** y, a continuación, elija la etiqueta del **Agente de Amazon Q Developer**.
+ Cómo usar el comando de barra inclinada `/q dev` en un comentario:
1. En el problema, navegue hasta **Añadir un comentario** y, en el campo de entrada de texto del comentario, introduzca `/q dev`.
1. Elija **Comment (Comentario)**.
1. Si se trata de un problema nuevo, elija **Crear problema** para terminar de crearlo con los detalles necesarios para que Amazon Q Developer desarrolle características. Si configura un problema existente, asegúrese de guardar los cambios. Para obtener más información, consulte [Editing an issue](https://docs.github.com/en/issues/tracking-your-work-with-issues/using-issues/editing-an-issue) en la *Documentación de GitHub*.
Cuando Amazon Q Developer termina de generar cambios en el código para el desarrollo de la característica, comenta el problema y abre una solicitud de extracción.
1. Navegue hasta el comentario que ha dejado Amazon Q Developer (ejemplo: “`I finished the proposed code changes, and the pull request is ready for review: [PR link]`”) y, a continuación, elija el enlace de la solicitud de extracción.
También puede navegar hasta la pestaña **Solicitudes de extracción** y, a continuación, elegir la solicitud de extracción creada por Amazon Q Developer.
1. Elija la pestaña **Archivos cambiados** para ver los cambios en el código.
1. Si está satisfecho con los cambios de código sugeridos, puede combinar la solicitud de extracción. Para obtener más información, consulte [Combinación de una solicitud de extracción](https://docs.github.com/en/pull-requests/collaborating-with-pull-requests/incorporating-changes-from-a-pull-request/merging-a-pull-request).
También puede revisar la solicitud de extracción para el desarrollo de la característica e iterar los cambios de código sugeridos enviando comentarios a Amazon Q Developer.
**Cómo iterar en el código de desarrollo de características de Amazon Q Developer**
1. Elija la solicitud de extracción creada por Amazon Q Developer y, a continuación, elija la pestaña **Archivos cambiados** para ver los cambios en el código.
1. Si lo desea, para líneas de código específicas sobre las que desee enviar comentarios, seleccione **\$1** para añadir un comentario con comentarios.
En la conversación, puedes usar el `/q` comando seguido de tus instrucciones en lenguaje natural (por ejemplo, `/q implement my suggestions` o`/q refactor this function for better performance`). El desarrollador de Amazon Q responderá con un comentario en el que describa los cambios que realizará en función de sus comentarios (por ejemplo, «Implementaré los siguientes cambios en función de los comentarios:...»). Cuando se complete la implementación, el desarrollador de Amazon Q publicará otro comentario confirmando los cambios (por ejemplo, «He implementado los cambios sugeridos») junto con un enlace a la confirmación generada, donde podrá ver los cambios.
1. Revisa los cambios realizados por el desarrollador de Amazon Q siguiendo el enlace de confirmación que aparece en la conversación. Puede seguir proporcionando comentarios adicionales utilizando el `/q` comando para realizar más iteraciones, según sea necesario.
1. Si está satisfecho con los cambios de código actualizados, puede combinar la solicitud de extracción o volver a iterar sobre el código con nuevos comentarios. Para obtener más información, consulte [Combinación de una solicitud de extracción](https://docs.github.com/en/pull-requests/collaborating-with-pull-requests/incorporating-changes-from-a-pull-request/merging-a-pull-request).
# Revisión de código con Amazon Q Developer en GitHub
**nota**
Amazon Q Developer para GitHub está en versión de vista previa y sujeto a cambios.
Amazon Q Developer permite realizar revisiones de código automatizadas desde GitHub. Cuando se crea una nueva solicitud de extracción o se vuelve a abrir una solicitud de extracción cerrada, Amazon Q Developer realiza automáticamente una revisión del código y proporciona comentarios sobre la calidad del código, los posibles problemas y los resultados de seguridad. Cada revisión incluye un resumen de la revisión del código con los resultados subprocesados. Amazon Q Developer también genera correcciones para los problemas identificados, que puede revisar y confirmar con la solicitud de extracción. Puede usar el comando `/q` en los comentarios de las solicitudes de extracción para hacer preguntas e interactuar en relación con los resultados de la revisión del código. Las revisiones automáticas del código no se activan con las confirmaciones posteriores realizadas dentro de una solicitud de extracción existente.
**nota**
La configuración de la función de revisiones de código de la consola de Amazon Q Developer controla las revisiones de código automatizadas que se ejecutan cuando se crean o se vuelven a abrir solicitudes de cambios. Esta configuración no afecta al inicio de las revisiones de código mediante el comando de `/q review` barra diagonal en los comentarios de las solicitudes de extracción.
También puede iniciar las revisiones de código dentro de las solicitudes de extracción con el comando de barra inclinada `/q review`. El comando de barra inclinada se puede añadir a un nuevo comentario de solicitud de extracción, lo que inicia una nueva revisión de código de la solicitud de extracción en su estado actual, incluidos comentarios y nuevas confirmaciones. Para obtener más información, consulte [Iniciación de revisiones de código dentro de las solicitudes de extracción de GitHub](#github-code-reviews-in-pr).
Puede hacer que Amazon Q Developer realice una revisión de código para una cantidad limitada de líneas al mes. Puedes aumentar el uso gratuito en cualquier momento registrando la instalación de la aplicación Amazon Q Developer en tu AWS cuenta. Para obtener más información, consulte [Aumento de los límites de uso y los detalles de configuración en la consola de Amazon Q Developer](github-register-app-install.md).
**nota**
Si la función de revisión de código estaba deshabilitada anteriormente, debe estar habilitada en la [consola de Amazon Q Developer](https://us-east-1.console.aws.amazon.com/amazonq/developer/home#/github) antes de poder aplicar la etiqueta en GitHub. Para obtener más información, consulte [Edición de características de Amazon Q Developer en GitHub](github-configuration.md#github-edit-features).
## Requisitos previos
Antes de poder iniciar las revisiones de código con Amazon Q Developer, necesitas los permisos adecuados para el repositorio de GitHub de destino. Los roles de repositorio compatibles son escritura, mantenimiento o administración. Los usuarios con funciones de lectura o de clasificación, así como los miembros sin un rol, no pueden iniciar revisiones de código con Amazon Q Developer.
Los usuarios de GitHub con la función de clasificación pueden seguir revisando las solicitudes de extracción en un repositorio. Cualquier usuario, independientemente de su rol, puede revisar las solicitudes de extracción en los repositorios públicos.
Para obtener más información, 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) y [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) en la *Documentación de GitHub*.
## Iniciación de revisiones de código para las solicitudes de extracción de GitHub
Cuando abre una nueva solicitud de extracción o vuelve a abrir una que ya estaba cerrada, Amazon Q Developer realiza automáticamente una revisión del código y envía comentarios sobre la calidad del código, los posibles problemas y los resultados más importantes.
**Cómo usar Amazon Q Developer para revisiones de código y aplicación de correcciones**
Antes de iniciar una revisión, puede personalizar una revisión de la calidad del código definiendo estándares de codificación personalizados en archivos Markdown sencillos del directorio `project-root/.amazonq/rules`. Amazon Q sigue automáticamente sus directrices, lo que garantiza una calidad de código uniforme en todo el proyecto. Para obtener más información, consulte [Creación de reglas de proyecto para Amazon Q Developer en plataformas de terceros](third-party-context-project-rules.md).
1. Si es necesario, inicie sesión en su cuenta de [https://github.com/](https://github.com/) usando sus credenciales de GitHub.
1. Navegue hasta la organización de GitHub y, a continuación, navegue hasta el repositorio en el que desee realizar una revisión de código con Amazon Q Developer.
1. Cree una nueva solicitud de extracción para los cambios realizados en el código fuente. Para obtener más información, 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) en la *Documentación de GitHub*.
Al crear una nueva solicitud de extracción, Amazon Q Developer inicia automáticamente una revisión del código para detectar posibles problemas. Una vez que Amazon Q Developer completa la revisión, proporciona un resumen de la revisión del código. Cada resultado aparece como un comentario enlazado debajo del resumen, junto con sugerencias de correcciones que puede confirmar en la solicitud de extracción.
1. Pídele al agente que implemente los cambios y cree confirmaciones directamente en la rama de origen de tu pull request. Puedes hacerlo publicando un comentario que comience `/q` y siga con tu solicitud en lenguaje natural para que el agente realice los cambios.
1. (Opcional) Realice preguntas sobre resultados específicos. En la solicitud de extracción, navegue hasta **Añadir un comentario** y, en el campo de introducción de texto del comentario, introduzca `/q` seguido de la pregunta (por ejemplo, “`/q explain the importance of this finding`”).
1. Revise los cambios de código propuestos por Amazon Q Developer, elija **Confirmar sugerencia** y, a continuación, elija **Confirmar los cambios** para actualizar la solicitud de extracción.
1. Si está satisfecho con las correcciones de código sugeridas, puede combinar la solicitud de extracción para aplicar los cambios de código sugeridos por Amazon Q Developer. Para obtener más información, 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) en la *Documentación de GitHub*.
## Iniciación de revisiones de código dentro de las solicitudes de extracción de GitHub
Tras una revisión automática del código realizada por Amazon Q Developer para una solicitud de extracción de GitHub nueva o reabierta, puede iniciar revisiones de código adicionales para iterar sobre el código mediante el comando de barra inclinada `/q review`. La revisión del código se realiza en toda la vista de diferencias de la solicitud de extracción.
**nota**
Solo puede iniciar una revisión de código dentro de una solicitud de extracción con un comentario nuevo. El comando de barra inclinada `/q review` no funcionará en una cadena de comentarios existente. El inicio de una revisión de código mediante el comando de `/q review` barra diagonal no se ve afectado por la configuración de la función de revisiones de código de la consola de Amazon Q Developer.
**Cómo utilizar revisiones de código iniciadas en una solicitud de extracción**
1. Si es necesario, inicie sesión en su cuenta de [https://github.com/](https://github.com/) usando sus credenciales de GitHub.
1. Navegue hasta su organización de GitHub y, a continuación, navegue hasta la solicitud de extracción en la que desee realizar una revisión del código con Amazon Q Developer. Para obtener más información, 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. En la solicitud de extracción, navegue hasta **Añadir un comentario** y, en el campo de entrada de texto del comentario, indique `/q review`.
1. Elija **Comentar** para iniciar la revisión del código.
Amazon Q Developer puede tardar unos minutos en completar el análisis del código de la solicitud de extracción. Después de que Amazon Q Developer termine de analizar, proporciona un resumen de la revisión del código. Cada resultado aparece como un comentario enlazado debajo del resumen, junto con los cambios propuestos que puede elegir para confirmar y actualizar la solicitud de extracción.
1. (Opcional) Realice preguntas sobre resultados específicos. En la solicitud de extracción, navegue hasta **Añadir un comentario** y, en el campo de introducción de texto del comentario, introduzca `/q` seguido de la pregunta (por ejemplo, “`/q explain the importance of this finding`”).
1. Si está satisfecho con las correcciones de código sugeridas, puede combinar la solicitud de extracción para aplicar los cambios de código sugeridos por Amazon Q Developer. Para obtener más información, 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) en la *Documentación de GitHub*.
# Aumento de los límites de uso y los detalles de configuración en la consola de Amazon Q Developer
**nota**
Amazon Q Developer para GitHub está en versión de vista previa y sujeto a cambios.
Puedes usar los agentes GitHub para desarrolladores de Amazon Q de forma gratuita sin necesidad de configurar una AWS cuenta para empezar. Dispones de un número limitado de llamadas al mes para las funciones de desarrollo de funciones y revisión de código. Puedes aumentar el uso gratuito en cualquier momento registrando la instalación de la aplicación Amazon Q Developer en tu AWS cuenta.
De forma predeterminada, las **funciones de **revisión de código** y desarrollo** de funciones están habilitadas GitHub al instalar la aplicación. Puede deshabilitar cualquiera de estas características al registrarse. El registro requiere un perfil de Amazon Q Developer para administrar las características desde la consola. El perfil almacena los ajustes y la personalización de las recomendaciones de código.
**importante**
Para registrar la instalación de aplicaciones en la consola de Amazon Q Developer, debe cumplir los requisitos de la organización de GitHub. Para obtener más información, consulte [los requisitos para instalar una GitHub aplicación](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) y [OAuth las aplicaciones y organizaciones](https://docs.github.com/en/apps/oauth-apps/using-oauth-apps/authorizing-oauth-apps#oauth-apps-and-organizations) en la *GitHubdocumentación*.
**Cómo registrar su instalación de Amazon Q Developer**
1. Navegue hasta la [consola de Amazon Q Developer](https://us-east-1.console.aws.amazon.com/amazonq/developer/home).
1. Selecciona **Enable Q Developer** en la parte superior de la página y sigue las instrucciones para activar Kiro y Amazon Q Developer.
Si anteriormente habilitaste Kiro y Amazon Q Developer, pasa al paso 3.
1. En el panel de navegación, selecciona **Amazon Q Developer en GitHub**.
1. Elija **Registrar la instalación** y, a continuación, elija **Autorizar** para que se le dirija a GitHub.
Si anteriormente autorizó a Amazon Q Developer para acceder a su organización GitHub, se le redirigirá de nuevo a la consola de Amazon Q Developer. En este caso, vaya al paso 7.
1. Inicie sesión en su cuenta de GitHub usando sus credenciales de GitHub. Si tiene varias cuentas, elija la cuenta a la que quiera proporcionar acceso a Amazon Q Developer.
1. Elija **Autorizar a Amazon Q Developer** para proporcionar acceso a su cuenta de GitHub. Se le redirigirá de nuevo a la consola de Amazon Q Developer tras la autorización.
1. En **Detalles de registro**, introduzca sus datos de GitHub y, opcionalmente, configure la característica de revisión de códigos y añada etiquetas.
1. En el campo de entrada de texto **Nombre de registro**, introduzca un nombre para la instalación de la aplicación.
1. (Opcional) En el campo de entrada de texto **Nombre de la organización - *opcional***, introduzca un nombre para la organización asociada a la instalación de la aplicación.
1. (Opcional) En **Características**, configure la característica de **Revisiones de código** pulsando el botón para activar o desactivar la característica. La configuración de **desarrollo de funciones** no se puede modificar y está habilitada de forma predeterminada.
1. (Opcional) En **Etiquetas: opcional**, selecciona **Añadir nueva etiqueta** para añadir una etiqueta que te ayude a buscar y filtrar tus AWS recursosGitHub.
1. Selecciona **Registrarse** para registrar la instalación de la aplicación en GitHub tu AWS cuenta.
Tras registrar correctamente la instalación de la aplicación, podrás ver los detalles del registro. Aún puedes activar o desactivar la función de revisión de código, así como añadir etiquetas más adelante. También puedes eliminar el registro. Para obtener más información, consulte [Configuración de los detalles de la instalación registrada](github-configuration.md).
# Configuración de los detalles de la instalación registrada
**nota**
Amazon Q Developer para GitHub está en versión de vista previa y sujeto a cambios.
Tras crear un perfil de Amazon Q Developer y registrar la instalación de la aplicación en GitHub, puede hacer lo siguiente desde la consola de Amazon Q Developer:
+ Habilite o deshabilite el uso de revisiones de código. La configuración de desarrollo de funciones no se puede modificar actualmente.
+ Encuentre enlaces a extensiones de navegador que proporcionan una forma de añadir etiquetas de características de Amazon Q Developer en los problemas de GitHub.
+ Agregue etiquetas para buscar y filtrar sus recursos o realizar un seguimiento de AWS los costos.
+ Elimine el registro de instalación de una aplicación de GitHub.
## Edición de características de Amazon Q Developer en GitHub
Las características disponibles para Amazon Q Developer en GitHub están habilitadas de forma predeterminada al instalar la aplicación en GitHub y al autorizar el acceso a tu organización. Puede optar por deshabilitar una característica si ya no quiere utilizarla en GitHub.
**Cómo habilitar o deshabilitar una característica para Amazon Q Developer en GitHub**
1. Navegue hasta la [consola de Amazon Q Developer](https://us-east-1.console.aws.amazon.com/amazonq/developer/home#/github).
1. En el panel de navegación, en **Amazon Q Developer en GitHub**, elija **Instalaciones registradas**.
1. En la columna **Nombre**, seleccione el nombre de registro de la instalación en la que desea activar o desactivar una característica.
1. En **Características**, elija **Editar** para configurar la disponibilidad de la característica.
1. En el modal, elija el conmutador de la característica que desea habilitar o deshabilitar y, a continuación, elija **Guardar** para confirmar los cambios.
Después de habilitar o deshabilitar una característica en la [consola de Amazon Q Developer](https://us-east-1.console.aws.amazon.com/amazonq/developer/home#/github), los cambios se reflejan en GitHub. Si se intenta asignar un problema a una etiqueta de Amazon Q Developer después de deshabilitar la característica, se generará un error. Las revisiones de código ya no se realizarán en las nuevas solicitudes de extracción si la característica está deshabilitada.
## Instalación de extensiones de navegador
Puede instalar la extensión de Amazon Q Developer en uno de los navegadores compatibles. La extensión le permite asignar rápidamente tareas de desarrollo de funciones a Amazon Q Developer en caso de GitHub problemas sin tener que buscar en los menús de etiquetas.
La extensión de Amazon Q Developer está disponible para los siguientes 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)
También puede ver los navegadores compatibles en la página de detalles de instalación de registro de la [consola de Amazon Q Developer](https://us-east-1.console.aws.amazon.com/amazonq/developer/home#/github).
## Eliminación del registro de instalación de la aplicación de GitHub de Amazon Q Developer
Puede eliminar el registro de una o varias de las instalaciones de la aplicación de GitHub a través de la consola de Amazon Q Developer. Tras eliminar permanentemente el registro, también se eliminarán todos los datos asociados al mismo. La acción no se puede deshacer.
**Cómo eliminar la instalación de la aplicación de GitHub**
1. Navegue hasta la [consola de Amazon Q Developer](https://us-east-1.console.aws.amazon.com/amazonq/developer/home#/github).
1. En el panel de navegación, en **Amazon Q Developer en GitHub**, elija **Instalaciones registradas**.
1. Realice una de las siguientes acciones:
+ En la columna **Acciones**, elija **Eliminar registro** para la instalación que desee eliminar.
+ En la columna **Nombre**, seleccione el nombre de registro de la instalación que desee eliminar y, a continuación, elija **Eliminar**.
En la columna **Acciones**, seleccione **Eliminar registro** de la instalación registrada que desee eliminar.
1. En el modal, revise los detalles para eliminar el registro.
1. En el campo de entrada de texto, indique **confirm** y, a continuación, elija **Eliminar** para confirmar los cambios.
Una vez que elimines una instalación de aplicación de GitHub, puedes optar por registrar una nueva instalación.
# Solución de problemas de Amazon Q Developer para GitHub
Consulte la siguiente sección para solucionar problemas habituales al utilizar Amazon Q Developer para GitHub.
## Amazon Q Developer no genera solicitudes de extracción en repositorios con reglas de protección de ramificaciones
**Problema**: Amazon Q Developer no puede crear una solicitud de extracción en mi repositorio de GitHub, que tiene reglas de protección de ramificaciones.
**Solución**: las reglas de protección de ramificaciones impiden que Amazon Q Developer cree una ramificación para crear una solicitud de extracción. Para usar Amazon Q Developer para GitHub en repositorios con reglas de protección de ramificaciones, debe añadir la aplicación Amazon Q Developer a su lista de permitidos.
**Cómo añadir la aplicación Amazon Q Developer a su lista de permitidos**
1. Si es necesario, inicie sesión en su cuenta de [https://github.com/](https://github.com/) usando sus credenciales de GitHub.
1. Navegue hasta la organización de GitHub y, a continuación, navegue hasta el repositorio al que quiere permitir incluir la aplicación de Amazon Q Developer para GitHub.
1. Elija **Configuración** y, a continuación, elija **Ramificaciones** en el panel de navegación.
1. En **Reglas de protección de ramificaciones**, elija **Editar** para modificar las reglas de protección de ramificaciones.
1. Elija **Restringir los envíos que creen ramificaciones coincidentes** y busque la aplicación de Amazon Q Developer para GitHub.
1. Elija **Guardar cambios** para permitir que Amazon Q Developer cree solicitudes de extracciones para problemas con las etiquetas de Amazon Q Developer.
Para obtener más información sobre cómo modificar las reglas de protección de ramificaciones en 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).
## Faltan etiquetas de Amazon Q Developer en problemas de GitHub
**Problema**: No veo la etiqueta de **agente de desarrollo de Amazon Q** en GitHub los números.
**Solución**: si la etiqueta no se crea automáticamente cuando instalaste la GitHub aplicación Amazon Q Developer for o si se eliminó de forma involuntaria, puedes crearla manualmente enGitHub. La etiqueta debe tener el nombre de **agente de desarrollo de Amazon Q** para que se reconozca y procese como etiqueta de desarrollador de Amazon Q. Para obtener más información, consulte [Creating a label](https://docs.github.com/en/issues/using-labels-and-milestones-to-track-work/managing-labels#creating-a-label) en la *Documentación de GitHub*.
## Amazon Q Developer no crea código para problemas de GitHub
**Problema**: he creado un problema de GitHub y he invocado a Amazon Q Developer para realizar una tarea, pero he recibido la siguiente serie de mensajes relacionados con problemas técnicos:
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. Esto puede tardar.
1. ⚠️ I'm having technical difficulties. I couldn't solve the issue. I'm going to try again. Esto puede tardar.
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.
**Solución**: si el desarrollador de Amazon Q no puede procesar el problema ni generar código para él, cree uno nuevo y aplique la etiqueta de **agente de desarrollo de Amazon Q** al nuevo problema. Para obtener más información sobre la creación de una incidencia y la aplicación de una etiqueta de agente desarrollador de Amazon Q, consulte[Desarrollo de características e iteración con Amazon Q Developer en GitHub](github-feature-development.md).