Desarrollo de funciones e iteración con Amazon Q Developer en GitHub - Amazon Q Developer

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.

Desarrollo de funciones e iteración con Amazon Q Developer en GitHub

nota

Amazon Q Developer for GitHub se encuentra en versión preliminar y está sujeto a cambios.

Puedes usar Amazon Q Developer GitHub para agilizar el desarrollo mediante la implementación automática de nuevas funciones y correcciones de errores, llevando las tareas desde la idea hasta una solicitud de extracción completa. Cuando añades la etiqueta de desarrollo de funciones a un problema o utilizas el comando de /q dev barra diagonal, 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 incorporación de cambios. En la solicitud de cambios, puedes enviar tus comentarios y Amazon Q Developer repite el código sugerido.

Puede hacer que Amazon Q Developer desarrolle funciones 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 Aumentar los límites de uso y los detalles de configuración en la consola Amazon Q Developer.

importante

La aplicación Amazon Q Developer intenta crear automáticamente las etiquetas del agente de desarrollo de Amazon Q y del agente de transformación de Amazon Q en GitHub los repositorios a los que usted autoriza el acceso. Si las etiquetas no se crean automáticamente o si se eliminan de forma no intencionada, puedes crearlas manualmente. GitHub Las etiquetas deben tener el nombre de agente de desarrollo de Amazon Q y agente de transformación de Amazon Q para que se reconozcan y procesen como etiquetas de desarrollador de Amazon Q. Para obtener más información, consulte Creación de una etiqueta en la GitHub documentación.

Para utilizar Amazon Q Developer para el desarrollo de funciones

  1. Si es necesario, inicie sesión en su GitHubcuenta con sus GitHub credenciales.

  2. Navegue hasta su GitHub organización y, a continuación, navegue hasta el repositorio en el que desee implementar nuevas funciones con Amazon Q Developer.

  3. Seleccione Problemas y, a continuación, cree un nuevo problema o elija uno existente. Para obtener más información, consulta Crear una incidencia en la GitHub documentación.

    1. Para un número nuevo, en el campo de entrada de texto Añadir un título, introduzca un título que proporcione contexto al desarrollador de Amazon Q para el desarrollo de la función (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 al desarrollador de Amazon Q para el desarrollo de la función. Para obtener más información, consulte Edición de un problema en la GitHubdocumentación.

  4. Al crear un problema o configurar uno existente, puede aplicar la etiqueta Amazon Q Developer de desarrollo de funciones o utilizar el comando /q dev slash. Realice una de las siguientes acciones:

    • Para aplicar la etiqueta a la edición, realice una de las siguientes acciones:

      • Selecciona el menú desplegable Asignar a Amazon Q que se proporciona como extensión del navegador y, a continuación, elige la etiqueta de agente de desarrollo de Amazon Q.

      • En el menú de la derecha, selecciona Etiquetas y, a continuación, elige la etiqueta del agente de desarrollo de Amazon Q.

    • Para usar el comando de /q dev barra diagonal en un comentario:

      1. En el número, ve a Añadir un comentario y, en el campo de entrada de texto del comentario, introduce/q dev.

      2. Elija Comment (Comentario).

  5. Si se trata de una nueva edición, selecciona Crear edición para terminar de crearla con los detalles necesarios para que el desarrollador de Amazon Q desarrolle funciones. Si configura un problema existente, asegúrese de guardar los cambios. Para obtener más información, consulte Edición de un problema en la GitHubdocumentación.

    Cuando Amazon Q Developer termina de generar cambios en el código para el desarrollo de la función, comenta el problema y abre una solicitud de cambios.

  6. Navega hasta el comentario dejado por el desarrollador de Amazon Q (ejemplo: "I finished generating the proposed code changes and opened a pull request: Resolve Create an image recognition app«) y, a continuación, selecciona el enlace de la solicitud de cambios.

    También puedes ir a la pestaña de solicitudes de extracción y, a continuación, elegir la solicitud de extracción creada por Amazon Q Developer.

  7. Selecciona la pestaña Archivos modificados para ver los cambios en el código.

  8. Si estás satisfecho con los cambios de código sugeridos, puedes fusionar la solicitud de extracción. Para obtener más información, consulta Fusionar una solicitud de extracción.

También puedes revisar la solicitud de cambios para el desarrollo de la función e iterar los cambios de código sugeridos enviando tus comentarios al desarrollador de Amazon Q.

Para iterar el código de desarrollo de funciones de Amazon Q Developer

  1. Selecciona la solicitud de cambios creada por Amazon Q Developer y, a continuación, selecciona la pestaña Archivos modificados para ver los cambios en el código.

  2. Para la línea de código sobre la que quieres dejar comentarios y hacer que el desarrollador de Amazon Q repita, selecciona + para añadir un comentario con comentarios y, a continuación, selecciona Iniciar una reseña.

    Tras enviar la reseña, el desarrollador de Amazon Q empezará a revisar el código en función de tus comentarios. Cuando el desarrollador de Amazon Q termine de revisar tus comentarios, confirmará los cambios en la solicitud de cambios y te actualizará con un comentario.

  3. Selecciona Finalizar la reseña, pulsa el botón de opción Solicitar cambios y, a continuación, selecciona Enviar reseña para que se revise tu opinión.

  4. Si estás satisfecho con los cambios de código actualizados, puedes combinar la solicitud de cambios o repetir el código con nuevos comentarios. Para obtener más información, consulta Fusionar una solicitud de extracción.

Amazon Q Developer se integra con los flujos de trabajo de GitHub Actions para crear un sistema de bucle de retroalimentación inteligente. Cuando se crea una solicitud de extracción, los flujos de trabajo configurados, como las pruebas unitarias, se ejecutan automáticamente. Si se produce un error en el flujo de trabajo, Amazon Q Developer analiza el resultado y, en función de los resultados y la información sobre errores, repite los cambios en el código. A medida que se introducen cambios en el código y se ejecutan los flujos de trabajo, Amazon Q Developer interpreta los resultados y utiliza esta información para refinar su enfoque. Esto crea un ciclo de aprendizaje continuo en el que cada iteración se basa en intentos anteriores y Amazon Q Developer puede desarrollar sus soluciones.

La eficacia de un ciclo de retroalimentación depende de contar con pruebas y flujos de trabajo bien definidos que proporcionen comentarios significativos para que los desarrolladores de Amazon Q los interpreten y actúen en consecuencia. Puede configurar los flujos de trabajo mediante archivos YAML de GitHub Actions en su repositorio, lo que permite procesos de prueba y validación personalizados a los que Amazon Q Developer puede responder. Para obtener más información, consulte Descripción de GitHub las acciones en la GitHubdocumentación.