Tutorial: Uso de las características de IA generativa de CodeCatalyst para acelerar el trabajo de desarrollo - Amazon CodeCatalyst
Requisitos previosUso de Amazon Q para elegir un esquema al crear un proyecto o al añadir funcionesAdición de un resumen generado automáticamente al crear una solicitud de extracciónCreación de un resumen de los comentarios sobre los cambios de código en una solicitud de extracciónCreación de un problema y asignación de este en Amazon QCreación de un problema y recomendaciones de tareas para este por parte de Amazon QEliminar recursos

Tutorial: Uso de las características de IA generativa de CodeCatalyst para acelerar el trabajo de desarrollo

Si tiene un proyecto y un repositorio de código fuente en un espacio de Amazon CodeCatalyst en el que están habilitadas las características de IA generativa, puede utilizarlas para acelerar el desarrollo de software. Los desarrolladores suelen tener más tareas pendientes que tiempo para realizarlas. A menudo, no se toman el tiempo de explicar los cambios de código a sus compañeros de equipo cuando crean solicitudes de extracción para la revisión de esos cambios, y esperan que los demás usuarios consideren que los cambios se explican por sí mismos. Los creadores y revisores de las solicitudes de extracción tampoco tienen tiempo para buscar y leer detenidamente todos los comentarios de una solicitud, especialmente si tiene varias revisiones. CodeCatalyst se integra con el agente de Amazon Q Developer para el desarrollo de software a fin de proporcionar características de IA generativa que ayuden a los miembros del equipo a realizar sus tareas con mayor rapidez y que les den más tiempo para concentrarse en las partes más importantes de su trabajo.

Amazon Q Developer es un asistente conversacional con tecnología de IA generativa que resulta útil a la hora de comprender, crear, ampliar y utilizar aplicaciones de AWS. A fin de acelerar la creación en AWS, el modelo que hay tras Amazon Q se ha optimizado con contenidos de AWS de alta calidad para generar respuestas más completas, con un mayor volumen de referencias y con las que sea posible tomar más medidas. Para obtener más información, consulte What is Amazon Q Developer? en la Guía del usuario de Amazon Q Developer.

nota

Con tecnología de Amazon Bedrock: AWS implementa la detección automática de abusos. Como las características Escribir descripción automáticamente, Crear un resumen del contenido, Recomendar tareas, Utilizar Amazon Q para crear o agregar características a un proyecto y Asignar problemas a Amazon Q del agente de Amazon Q Developer para el desarrollo de software están basadas en Amazon Bedrock, los usuarios pueden aprovechar al máximo los controles implementados en Amazon Bedrock para garantizar la protección, la seguridad y el uso responsable de la inteligencia artificial (IA).

En este tutorial, aprenderá a usar las características de IA generativa de CodeCatalyst para ayudarle a crear proyectos con esquemas, así como a añadir esquemas a proyectos existentes. Además, aprenderá a resumir los cambios entre las ramificaciones al crear solicitudes de extracción, así como a resumir los comentarios que se dejan en una solicitud de extracción. También aprenderá a crear problemas con sus ideas de cambios o mejoras en el código y a asignárselos a Amazon Q. Como parte del trabajo con los problemas asignados a Amazon Q, verá cómo dejar que Amazon Q sugiera tareas y cómo asignar y trabajar en cualquier tarea que genere como parte del trabajo en un problema.

Requisitos previos

Para trabajar con las características de CodeCatalyst de este tutorial, primero debe haber completado los siguientes recursos y tener acceso a ellos:

  • Debe tener una identidad de ID de creador de AWS o de inicio de sesión único (SSO) para iniciar sesión en CodeCatalyst.

  • Debe encontrarse en un espacio que tenga habilitadas las características de IA generativa. Para obtener más información, consulte Managing generative AI features.

  • Debe tener el rol de colaborador o administrador del proyecto en un proyecto de ese espacio.

  • A menos que esté creando un proyecto con IA generativa, el proyecto existente debe tener, al menos, un repositorio de código fuente configurado para él. Los repositorios vinculados no son compatibles.

  • Al asignar problemas para que la IA generativa cree una solución inicial, el proyecto no puede estar configurado con la extensión Software de Jira. La extensión no es compatible para esta característica.

Para obtener más información, consulte Creación de un espacio, Seguimiento y organización de los trabajos con problemas en CodeCatalyst, Adición de funcionalidad a proyectos mediante extensiones en CodeCatalyst y Concesión de acceso en los roles de usuario.

Este tutorial se basa en un proyecto creado con el esquema Aplicación web moderna de tres niveles con Python. Si utiliza un proyecto creado con un esquema diferente, puede seguir los pasos, pero es posible que algunos detalles varíen, como el código de ejemplo y el lenguaje.

Uso de Amazon Q para elegir un esquema al crear un proyecto o al añadir funciones

El desarrollador del proyecto también puede colaborar con Amazon Q, un asistente de IA generativa, al crear nuevos proyectos o al añadir componentes a proyectos existentes. Puede proporcionar a Amazon Q los requisitos del proyecto interactuando con él en una interfaz similar a un chat. En función de sus requisitos, Amazon Q le sugiere un esquema y también describe los requisitos que no se pueden cumplir. Si el espacio tiene esquemas personalizados, Amazon Q los aprende y también los incluye en las recomendaciones. Después, puede continuar con la sugerencia de Amazon Q si está satisfecho: el asistente creará los recursos necesarios, como un repositorio de código fuente con el código que necesite. Amazon Q también crea problemas con los requisitos que no se pueden cumplir mediante un esquema. Para obtener más información sobre los esquemas de CodeCatalyst disponibles, consulte Creación de un proyecto integral con esquemas de CodeCatalyst. Para obtener más información sobre el uso de Amazon Q con esquemas, consulte Prácticas recomendadas al utilizar Amazon Q para crear proyectos o añadir funciones con esquemas.

Creación de un proyecto con Amazon Q

  1. Abra la consola de CodeCatalyst en https://codecatalyst.aws/.

  2. En la consola de CodeCatalyst, vaya al espacio donde desee crear un esquema.

  3. En el panel de control del espacio, seleccione Crear con Amazon Q.

  4. En el campo de entrada de texto de las peticiones en Amazon Q, proporcione instrucciones escribiendo una breve descripción del proyecto que desea crear. Por ejemplo, “I want to create a project in Python that has a presentation layer responsible for how the data is presented, an application layer that contains the core logic and functionality of the application, and a data layer that manages the storage and retrieval of the data.”

    (Opcional) En Probar ejemplos, puede usar una petición escrita previamente seleccionando un esquema. Por ejemplo, si elige la aplicación React, aparecerá la siguiente petición: “I want to create a project in Python that has a presentation layer responsible for how the data is presented, an application layer that contains the core logic and functionality of the application, and a data layer that manages the storage and retrieval of the data. I also want to add authentication and authorization mechanisms for security and allowable actions.”

  5. Seleccione Enviar para enviar las instrucciones a Amazon Q. El asistente de IA generativa proporciona una sugerencia y describe los requisitos que el esquema no puede cumplir. Por ejemplo, Amazon Q podría sugerirle lo siguiente en función de sus criterios:

    I recommend using the Modern three-tier web application blueprint based on 
                    your requirements. Blueprints are dynamic and can always be updated and edited later.

Modern three-tier web application
By Amazon Web Services

This blueprint creates a Mythical Mysfits 3-tier web application with a modular presentation, application, and data layers. 
The application leverages containers, infrastructure as code (IaC), continuous integration and continuous delivery (CI/CD), 
and serverless code functions.

Version: 0.1.163

View details

The following requirements could not be met so I will create issues for you.
• Add authentication and authorization mechanisms for security and allowable actions.

  6. (Opcional) Para ver la información más detallada del esquema sugerido, seleccione Ver detalles.

  7. Realice una de las siguientes acciones siguientes:

    1. Seleccione Sí, usar este esquema si está satisfecho con la sugerencia.

    2. Seleccione Editar petición si desea modificar la petición.

    3. Seleccione Comenzar de nuevo si desea borrar completamente el mensaje.

  8. Realice una de las siguientes acciones siguientes:

    1. Seleccione Configurar si desea configurar el esquema sugerido. También puede configurar el esquema más tarde.

    2. Seleccione Omitir si no desea modificar la configuración del esquema en este momento.

  9. Si ha decidido configurar el esquema, elija Continuar después de modificar los recursos del proyecto.

  10. Cuando se le solicite, introduzca el nombre que desea asignar al proyecto y los nombres de los recursos asociados. El nombre debe ser único dentro de su espacio.

  11. Seleccione Crear proyecto para crear un proyecto con el esquema. Amazon Q crea recursos a partir del esquema. Por ejemplo, si crea un proyecto con el esquema de aplicación de una sola página, se creará un repositorio de código fuente para el código correspondiente y flujos de trabajo para el CI/CD.

  12. (Opcional) De forma predeterminada, Amazon Q también crea problemas para los requisitos que el esquema no cumple. Puede elegir los elementos para los que no quiera crear problemas. Cuando decida dejar que Amazon Q cree problemas, también podrá asignarle un problema a Amazon Q. Analizará el problema en el contexto de los repositorios de código fuente correspondientes, y proporcionará un resumen de los archivos y el código fuente relevantes. Para obtener más información, consulte Búsqueda y visualización de problemas, Creación de un problema y asignación de este en Amazon Q y Prácticas recomendadas al crear problemas asignados a Amazon Q y al trabajar en ellos.

Tras crear un proyecto con Amazon Q, también puede utilizar Amazon Q para añadir nuevos componentes, ya que sugiere esquemas de CodeCatalyst con base en sus requisitos.

Adición de un esquema con Amazon Q

  1. Abra la consola de CodeCatalyst en https://codecatalyst.aws/.

  2. En la consola de CodeCatalyst, vaya al proyecto donde desee añadir un esquema.

  3. Seleccione Añadir con Amazon Q.

  4. En el campo de entrada de texto de las peticiones en Amazon Q, proporcione instrucciones escribiendo una breve descripción del proyecto que desea crear. Por ejemplo, “I want to create a project in Python that has a presentation layer responsible for how the data is presented, an application layer that contains the core logic and functionality of the application, and a data layer that manages the storage and retrieval of the data.”

    (Opcional) En Probar ejemplos, puede usar una petición escrita previamente seleccionando un esquema. Por ejemplo, si elige la aplicación React, aparecerá la siguiente petición: “I want to create a project in Python that has a presentation layer responsible for how the data is presented, an application layer that contains the core logic and functionality of the application, and a data layer that manages the storage and retrieval of the data. I also want to add authentication and authorization mechanisms for security and allowable actions.”

  5. Seleccione Enviar para enviar las instrucciones a Amazon Q. El asistente de IA generativa proporciona una sugerencia y describe los requisitos que el esquema no puede cumplir. Por ejemplo, Amazon Q podría sugerirle lo siguiente en función de sus criterios:

    I recommend using the Single-page application blueprint based on your requirements. Blueprints are dynamic and can always be updated and edited later.

Single-page application
By Amazon Web Services

This blueprint creates a SPA (single-page application) using React, Vue, or Angular frameworks and deploys to AWS Amplify Hosting.

Version: 0.2.15
View details

The following requirements could not be met so I will create issues for you.
• The application should have reusable UI components
• The application should support for client-side routing
• The application may require server-side rendering for improved performance and SEO

  6. (Opcional) Para ver la información más detallada del esquema sugerido, seleccione Ver detalles.

  7. Realice una de las siguientes acciones siguientes:

    1. Seleccione Sí, usar este esquema si está satisfecho con la sugerencia.

    2. Seleccione Editar petición si desea modificar la petición.

    3. Seleccione Comenzar de nuevo si desea borrar completamente el mensaje.

  8. Realice una de las siguientes acciones siguientes:

    1. Seleccione Configurar si desea configurar el esquema sugerido. También puede configurar el esquema más tarde.

    2. Seleccione Omitir si no desea modificar la configuración del esquema en este momento.

  9. Si ha decidido configurar el esquema, elija Continuar después de modificar los recursos del proyecto.

  10. Seleccione Añadir al proyecto para añadir recursos a un proyecto con el esquema. Amazon Q crea recursos a partir del esquema. Por ejemplo, si añade elementos a un proyecto con el esquema de aplicación de una sola página, se creará un repositorio de código fuente para el código correspondiente y flujos de trabajo para el CI/CD.

  11. (Opcional) De forma predeterminada, Amazon Q también crea problemas para los requisitos que el esquema no cumple. Puede elegir los elementos para los que no quiera crear problemas. Cuando decida dejar que Amazon Q cree problemas, también podrá asignarle un problema a Amazon Q. Analizará el problema en el contexto de los repositorios de código fuente correspondientes, y proporcionará un resumen de los archivos y el código fuente relevantes. Para obtener más información, consulte Creación de un problema y asignación de este en Amazon Q y Prácticas recomendadas al crear problemas asignados a Amazon Q y al trabajar en ellos.

Creación de un resumen de los cambios de código entre ramificaciones al crear una solicitud de extracción

Una solicitud de extracción es el método principal para que usted u otros miembros del proyecto puedan revisar y combinar los cambios en el código entre ramificaciones o hacer comentarios sobre estos. Puede utilizar las solicitudes de extracción para revisar de forma colaborativa los cambios en el código relacionados con pequeños cambios o correcciones, incorporación de características importantes o versiones nuevas del software publicado. En la descripción de la solicitud de extracción, resumir los cambios en el código y la razón para estos resulta útil para otras personas que deseen revisar el código, y ayuda a comprender el historial de los cambios que se van introduciendo. Sin embargo, los desarrolladores suelen aportar detalles ambiguos o confiar en que el código no necesita explicación, en lugar de describir los cambios con suficiente detalle como para que los revisores entiendan lo que están revisando o comprendan el motivo tras el cambio.

Puede usar la característica Escribir descripción automáticamente al crear solicitudes de extracción para que Amazon Q cree una descripción de los cambios contenidos en una solicitud de extracción. Al elegir esta opción, Amazon Q analiza las diferencias entre la ramificación de origen, que contiene los cambios de código, y la ramificación de destino en la que quiera combinar estos cambios. A continuación, crea un resumen de cuáles son esos cambios, así como su mejor interpretación de la intención y el efecto de dichos cambios.

nota

Esta característica no funciona con los submódulos de Git. No resumirá ningún cambio en un submódulo de Git que forme parte de la solicitud de extracción.

Esta característica no está disponible para las solicitudes de extracción en los repositorios vinculados.

Puede probar esta característica con cualquier solicitud de extracción que cree pero, en este tutorial, la probaremos realizando algunos cambios sencillos en el código contenido en un proyecto creado en un esquema Aplicación web moderna de tres niveles con Python.

sugerencia

Si utiliza un proyecto creado con un esquema distinto o con su propio código, puede seguir este tutorial, pero los ejemplos no coincidirán con el código de su proyecto. En lugar del ejemplo que se sugiere a continuación, haga cambios sencillos en una ramificación del código de su proyecto; luego, cree una solicitud de extracción para probar la característica tal y como se muestra en los siguientes pasos.

Primero, creará una ramificación en el repositorio de código fuente. Luego, hará un cambio rápido en el código en un archivo de esa ramificación mediante el editor de texto de la consola. A continuación, creará una solicitud de extracción y utilizará la característica Escribir descripción automáticamente para resumir los cambios que haya hecho.

Creación de una ramificación (consola)

  1. Desde la consola de CodeCatalyst, vaya al proyecto donde resida el repositorio de código fuente.

  2. Seleccione el nombre del repositorio de la lista de repositorios de código fuente para el proyecto. Como alternativa, en el panel de navegación, elija Código y, a continuación, elija Repositorios de origen.

  3. Elija el repositorio donde desee crear una ramificación.

  4. En la página de información general del repositorio, elija Más y Crear ramificación.

  5. Introduzca un nombre para la ramificación.

  6. Elija una ramificación desde la que creara la ramificación y, a continuación, seleccione Crear.

Cuando tenga la ramificación, edite un archivo en esa ramificación con un cambio sencillo. En este ejemplo, editará el archivo test_endpoint.py para cambiar el número de reintentos para las pruebas (de 3 a 5).

sugerencia

También puede optar por crear o usar un entorno de desarrollo para hacer este cambio en el código. Para obtener más información, consulte Creación de un entorno de desarrollo.

Edición del archivo test_endpoint.py en la consola

  1. En la página de información general del repositorio de código fuente mysfits, seleccione el menú desplegable de la ramificación y elija la ramificación que ha creado en el procedimiento anterior.

  2. En Archivos, vaya al archivo que desee editar. Por ejemplo, para editar el archivo test_endpoint.py, expanda tests, expanda integ y elija test_endpoint.py.

  3. Elija Editar.

  4. En la línea 7, cambie el número de veces que se reintentarán todas las pruebas:

    def test_list_all(retry=3):

    a:

    def test_list_all(retry=5):

  5. Seleccione Confirmar para confirmar los cambios en la ramificación.

Ahora que ya tiene una ramificación con cambios, puede crear una solicitud de extracción.

Creación de una solicitud de cambios con un resumen de los cambios

  1. En la página de información general del repositorio, elija Más y Crear la solicitud de extracción.

  2. En Ramificación de destino, elija la ramificación en la que quiera combinar el código después de revisarlo.

    sugerencia

    Elija la ramificación desde la que creó la ramificación en el procedimiento anterior, a fin de ver una demostración muy sencilla de esta característica. Por ejemplo, si ha creado la ramificación a partir de la ramificación predeterminada del repositorio, elija esa ramificación como la de destino para la solicitud de extracción.

  3. En Ramificación de origen, seleccione la ramificación que contenga los cambios que acaba de confirmar en el archivo test_endpoint.py.

  4. En Título de la solicitud de extracción, introduzca un título que ayude a otros usuarios a entender qué es lo que hay que revisar y por qué.

  5. En Descripción de la solicitud de extracción, seleccione Escribir descripción automáticamente para dejar que Amazon Q cree una descripción de los cambios contenidos en la solicitud de extracción.

  6. Aparecerá un resumen de los cambios. Revise el texto sugerido y seleccione Aceptar y añadir a la descripción.

  7. Si lo desea, modifique el resumen para que refleje mejor los cambios que ha hecho en el código. También puede añadir revisores o vincular los problemas a esta solicitud de extracción. Cuando haya terminado de hacer los cambios adicionales que desee, seleccione Crear.

Creación de un resumen de los comentarios sobre los cambios de código en una solicitud de extracción

Cuando los usuarios revisan una solicitud de extracción, suelen dejar comentarios sobre los cambios en dicha solicitud. Si hay muchos comentarios de muchos revisores, puede resultar difícil elegir temas comunes en los comentarios o saber si los ha repasado todos. Puede usar la característica Crear resumen de comentarios para que Amazon Q analice todos los comentarios sobre los cambios de código en una solicitud de extracción y cree un resumen.

nota

Los resúmenes de comentarios son temporales. Si actualiza una solicitud de extracción, el resumen desaparecerá. Los resúmenes de contenido no incluyen comentarios sobre la solicitud de extracción en general, sino solo los comentarios sobre las diferencias de código en las revisiones de la solicitud.

Esta característica no funciona con los comentarios sobre los cambios de código en los submódulos de Git.

Esta característica no está disponible para las solicitudes de extracción en los repositorios vinculados.

Creación de un resumen de comentarios en una solicitud de extracción

  1. Vaya a la solicitud de extracción que creó en el procedimiento anterior.

    sugerencia

    Si lo prefiere, puede usar cualquier solicitud de extracción abierta en el proyecto. En el panel de navegación, seleccione Código y Solicitudes de extracción y elija cualquier solicitud de extracción abierta.

  2. Si la solicitud de extracción aún no tiene comentarios, añada alguno (en Cambios).

  3. En Descripción general, seleccione Crear resumen de comentarios. Cuando haya terminado, se ampliará la sección Resumen de comentarios.

  4. Revise el resumen de los comentarios dejados sobre los cambios en el código en las revisiones de la solicitud de extracción y compárelo con los comentarios de la solicitud de extracción.

Creación de un problema y asignación de este en Amazon Q

Los equipos de desarrollo crean problemas para hacer un seguimiento de su trabajo y administrarlo, pero a veces el problema persiste porque no está claro quién debe trabajar en él, o bien porque el problema requiere investigar una parte concreta del código base o porque hay que ocuparse primero de algún trabajo urgente. CodeCatalyst incluye la integración con el agente de Amazon Q Developer para el desarrollo de software. Puede asignar problemas a un asistente de IA generativa llamado Amazon Q, que puede analizar un problema basándose en el título y la descripción. Si le asigna el problema a Amazon Q, este intentará crear un borrador de solución para que lo repase. Con esta ayuda, su equipo y usted pueden centrar su trabajo en los problemas que requieran su atención, mientras Amazon Q trabaja en una solución para aquellos problemas que usted no puede abordar inmediatamente por falta de recursos.

sugerencia

Amazon Q funciona mejor en cuestiones o problemas sencillos y directos. Para obtener los mejores resultados, utilice un lenguaje sencillo para explicar claramente lo que quiere que se haga.

Cuando le asigne un problema a Amazon Q, CodeCatalyst marcará el problema como bloqueado hasta que confirme cómo quiere que Amazon Q lo solucione. Debe responder a tres preguntas antes de que pueda continuar:

  • Debe decidir si quiere confirmar cada paso o si prefiere que el sistema vaya procediendo sin decirle nada. Si decide confirmar cada paso, puede responder a Amazon Q con comentarios sobre el método que crea, para poder repetirlo si es necesario. Si elige esta opción, Amazon Q también puede revisar los comentarios que los usuarios dejen en cualquier solicitud de extracción. Si decide no confirmar cada paso, Amazon Q podría completar el trabajo más rápido, pero no revisará ningún comentario que le aporte sobre el problema o sobre la solicitud de extracción que cree.

  • Debe decidir si permitirá que actualice los archivos del flujo de trabajo como parte de su proceso. Es posible que el proyecto tenga flujos de trabajo configurados para iniciar ejecuciones ante eventos de solicitudes de extracción. Si es así, cualquier solicitud de extracción que Amazon Q cree, y que incluya la creación o actualización del YAML del flujo de trabajo, podría iniciar una ejecución de los flujos de trabajo incluidos en la solicitud de extracción. Como práctica recomendada, no permita que Amazon Q trabaje en archivos de flujo de trabajo a menos que esté seguro de que no hay flujos de trabajo en el proyecto que vayan a ejecutar automáticamente estos flujos antes de revisar y aprobar la solicitud de extracción que se cree.

  • Debe decidir si quiere permitir que sugiera la creación de tareas para dividir el trabajo del problema en incrementos más pequeños que puedan asignarse individualmente a los usuarios (lo que incluye a Amazon Q). Si permite que Amazon Q sugiera y cree tareas, esto puede acelerar el desarrollo de problemas complejos, ya que podría haber varias personas trabajando en partes discretas del problema. Esto también puede ayudar a comprender la totalidad del trabajo, ya que, en circunstancias normales, el trabajo necesario para completar cada tarea es más simple que el problema al que pertenece.

  • Debe decidir en qué repositorio de código fuente quiere que trabaje. Aunque el proyecto tenga varios repositorios de código fuente, Amazon Q solo puede trabajar en el código de un repositorio. Los repositorios vinculados no son compatibles.

Cuando haya confirmado las distintas opciones, Amazon Q pasará el problema al estado En curso e intentará determinar de qué trata la solicitud en función del título del problema, la descripción y el código en el repositorio especificado. Creará un comentario anclado en el que proporcionará información actualizada sobre el estado del trabajo. Tras revisar los datos, Amazon Q formulará un posible método como solución. Amazon Q registra sus acciones actualizando el comentario anclado y dejando comentarios sobre el progreso del problema en cada etapa. A diferencia de lo que ocurre con los comentarios y las respuestas anclados, no lleva un registro estrictamente cronológico del trabajo. En lugar de eso, coloca la información más relevante sobre el trabajo en el nivel superior del comentario anclado. Intentará crear código basándose en su método y en el análisis del código que ya está en el repositorio. Si genera correctamente una posible solución, creará una ramificación y confirmará el código en esa ramificación. Luego, creará una solicitud de extracción que combinará esa ramificación con la ramificación predeterminada. Cuando Amazon Q termina su trabajo, pasa el problema al estado En revisión para que su equipo y usted sepan que hay código listo para la evaluación.

nota

Esta característica solo está disponible mediante Problemas en la región Oeste de EE. UU. (Oregón). No está disponible si ha configurado el proyecto para usar Jira con la extensión Software de Jira. Además, si ha personalizado el diseño del panel, es posible que el problema no cambie de estado. Para obtener los mejores resultados, use esta característica solo con proyectos que tengan un diseño de panel estándar.

Esta característica no funciona con los submódulos de Git. No puede hacer cambios en ningún submódulo de Git incluido en el repositorio.

Cuando haya asignado un problema a Amazon Q, no podrá cambiar el título o la descripción del problema ni asignárselo a nadie más. Si desasigna a Amazon Q del problema, este finalizará el paso actual y, a continuación, dejará de trabajar. Tras esta desasignación, no podrá reanudar su trabajo ni recibir de nuevo una asignación al problema.

Si un problema está asignado a Amazon Q, se puede mover automáticamente a la columna En revisión si un usuario decide permitirle crear tareas. Sin embargo, es posible que el problema En revisión siga teniendo tareas en un estado diferente, como el estado En curso.

En esta parte del tutorial, creará tres problemas basados en las posibles características del código incluido en los proyectos creados con el esquema Aplicación web moderna de tres niveles: uno para añadir o crear una nueva criatura de mysfit, otro para añadir una característica de ordenación y otro para actualizar un flujo de trabajo de modo que incluya una ramificación llamada test.

nota

Si está trabajando en un proyecto con un código diferente, cree problemas con los títulos y las descripciones que se relacionen con esa base de código.

Creación de un problema y generación de una solución para su análisis

  1. En el panel de navegación, seleccione Problemas y compruebe que se encuentra en la vista Panel.

  2. Seleccione Crear el problema.

  3. Póngale al problema un título que explique de forma sencilla lo que quiere hacer. Por ejemplo, para este problema, pondremos el título Create another mysfit named Quokkapus. En Descripción, proporcione los siguientes datos:

    Expand the table of mysfits to 13, and give the new mysfit the following characteristics:

Name: Quokkapus

Species: Quokka-Octopus hybrid

Good/Evil: Good

Lawful/Chaotic: Chaotic

Age: 216

Description: Australia is full of amazing marsupials, but there's nothing there quite like the Quokkapus. 
She's always got a friendly smile on her face, especially when she's using her eight limbs to wrap you up 
in a great big hug. She exists on a diet of code bugs and caffeine. If you've got some gnarly code that needsa
assistance, adopt Quokkapus and put her to work - she'll love it! Just make sure you leave enough room for 
her to grow, and keep that coffee coming.

  4. (Opcional) Adjunte al problema una imagen para utilizarla como miniatura y foto de perfil del mysfit. Al hacer esto, se actualizará la descripción para incluir detalles sobre qué imágenes quiere usar y por qué. Por ejemplo, puede añadir lo siguiente a la descripción: “El mysfit requiere que los archivos de imagen se muestren en el sitio web. Añada estas imágenes adjuntas al problema en el repositorio de código fuente como parte del trabajo y muéstrelas en el sitio web”.

    nota

    Durante las interacciones de este tutorial, las imágenes adjuntas podrían no mostrarse en el sitio web. Puede añadir las imágenes al sitio web y, a continuación, dejar comentarios para que Amazon Q actualice el código de modo que apunte a las imágenes que desea usar tras haber creado una solicitud de extracción.

    Revise la descripción y asegúrese de que contiene todos los detalles necesarios antes de continuar con el siguiente paso.

  5. En Cesionarios, seleccione Asignar a Amazon Q.

  6. En Repositorio de origen, elija el nombre del repositorio de código fuente que contiene el código del proyecto.

  7. Si es necesario, ponga en activo el selector Detener Amazon Q después de cada paso para que espere a que se haya revisado el trabajo.

    nota

    Si elige que Amazon Q pare después de cada paso, podrá comentar el problema o cualquier tarea creada, y tendrá la opción de hacer que Amazon Q cambie el método un máximo de tres veces en función de los comentarios. Si elige que Amazon Q no pare después de cada paso para poder revisar el trabajo, es posible que el trabajo avance más rápido, ya que Amazon Q no tiene que esperar a los comentarios, pero no podrá usar comentarios para cambiar el método que Amazon Q utilice. Si elige esa opción, Amazon Q tampoco responderá a los comentarios que se dejen en una solicitud de extracción.

  8. Desactive el selector Permitir que Amazon Q modifique los archivos del flujo de trabajo.

  9. Active el selector Permitir que Amazon Q sugiera la creación de tareas.

  10. Seleccione Crear el problema. La vista cambiará al panel Problemas.

  11. Seleccione Crear el problema para crear otro problema; esta vez, con el título Change the get_all_mysfits() API to return mysfits sorted by the Age attribute. Asigne este problema a Amazon Q y cree el problema.

  12. Seleccione Crear el problema para crear otro problema; esta vez, con el título Update the OnPullRequest workflow to include a branch named test in its triggers. Si lo desea, ponga un enlace al flujo de trabajo en la descripción. Asigne este problema a Amazon Q, pero esta vez asegúrese de que el selector Permitir que Amazon Q modifique los archivos del flujo de trabajo esté activado. Cree el problema para volver al panel Problemas.

    sugerencia

    Puede buscar archivos, como los archivos de flujo de trabajo, introduciendo el símbolo de arroba (@) y el nombre del archivo.

Cuando haya creado y asignado los problemas, estos pasarán al estado En curso. Amazon Q añadirá comentarios, en un comentario anclado, para hacer un seguimiento del progreso del problema. Si puede definir un método para una solución, actualizará la descripción del problema con una sección Antecedentes, que contiene el análisis del código base, y una sección Método, que detalla el método propuesto para crear una solución. Si Amazon Q logra encontrar una solución al problema descrito en el problema, creará una ramificación y los cambios de código en esa ramificación para implementar la solución propuesta. Si el código propuesto contiene similitudes con el código fuente abierto que Amazon Q conoce, proporcionará un archivo que incluya enlaces a ese código para que pueda revisarlo. Cuando el código esté listo, creará una solicitud de extracción para que pueda revisar los cambios de código sugeridos, añadirá en el problema un enlace a esa solicitud de extracción y pasará el problema al estado En revisión.

importante

Revise siempre todos los cambios en el código de una solicitud de extracción antes de combinarla. Los cambios de código combinados realizados por Amazon Q, como cualquier otro cambio de código, pueden afectar negativamente a la base de código y al código de infraestructura si el código combinado no se revisa adecuadamente y contiene errores en el momento de combinarse.

Revisión de un problema y de una solicitud de extracción vinculada que contienen cambios hechos por Amazon Q

  1. En Problemas, seleccione un problema asignado a Amazon Q y que se encuentre En curso. Revise los comentarios para supervisar el progreso de Amazon Q. Si hay información de antecedentes y método, revísela en la descripción del problema. Si ha decidido permitir que Amazon Q sugiera tareas, revise las tareas propuestas y tome las medidas necesarias. Por ejemplo, si Amazon Q ha sugerido tareas y le gustaría cambiar el orden o asignar tareas a usuarios específicos, seleccione Cambiar, añadir o reordenar las tareas y lleve a cabo las actualizaciones necesarias. Cuando termine de ver el problema, seleccione X para cerrar el panel del problema.

    sugerencia

    Para ver el progreso de las tareas, elija la tarea en la lista de tareas del problema. Las tareas no aparecen como elementos separados en el panel, y solo se puede acceder a ellas a través de un problema. Si se asigna una tarea a Amazon Q, debe abrirla para aprobar cualquier acción que desee realizar. También debe abrir una tarea para ver las solicitudes de extracción vinculadas, ya que no aparecerán como vínculos en el problema, sino solo en la tarea. Para volver a un problema desde una tarea, seleccione el enlace al problema.

  2. Ahora, elija un problema asignado a Amazon Q que esté En revisión. Revise los antecedentes y el método registrados en la descripción del problema. Revise los comentarios para comprender las acciones que se han llevado a cabo. Revise todas las tareas creadas para trabajos relacionados con este problema, lo que incluye el progreso, las acciones que deba realizar y los comentarios. En Solicitudes de extracción, selecciona el enlace a la solicitud de extracción, junto a la etiqueta Abierta, para revisar el código.

    sugerencia

    Las solicitudes de extracción generadas para las tareas solo aparecen como solicitudes de extracción vinculadas en la vista de tareas. No aparecen como solicitudes de extracción vinculadas en el problema.

  3. En la solicitud de extracción, revise los cambios en el código. Para obtener más información, consulte Revisión de una solicitud de extracción. Deje comentarios en la solicitud de extracción si desea que Amazon Q cambie algo en el código sugerido. A fin de que Amazon Q aporte el mejor resultado posible, sea específico al dejar comentarios.

    Por ejemplo, imagine que, al revisar la solicitud de extracción creada para Create another mysfit named Quokkapus, observa que hay un error de escritura en la descripción. Puede dejar un comentario para Amazon Q que diga “Cambia la descripción para corregir el error ‘necesitaun’ y añade un espacio entre ‘necesita’ y ‘un’”. Si lo prefiere, puede dejar un comentario en el que le pida a Amazon Q que actualice la descripción y que proporcione toda la descripción revisada para incorporarla.

    Si ha subido imágenes del nuevo mysfit al sitio web, puede dejar un comentario para que Amazon Q actualice el mysfit con indicadores a una imagen y una miniatura para el nuevo mysfit.

    nota

    Amazon Q no responderá a comentarios individuales. Amazon Q solo incorporará las ideas de los comentarios en las solicitudes de extracción si ha elegido la opción predeterminada (detenerse después de cada paso y esperar a la aprobación) en el momento de crear el problema.

  4. (Opcional) Al terminar de dejar comentarios para los cambios en el código, seleccione Crear revisión para que Amazon Q cree una revisión de la solicitud de extracción en la que se hayan incorporado los cambios solicitados en los comentarios. Amazon Q informará del progreso en la creación de la revisión en Descripción general, no en Cambios. Actualice el navegador para ver las últimas actualizaciones de Amazon Q al crear la revisión.

    nota

    Solo el usuario que creó el problema puede crear una revisión de la solicitud de extracción. Solo puede solicitar una revisión de una solicitud de extracción. Antes de seleccionar Crear revisión, asegúrese de haber incluido comentarios sobre toda la problemática y de estar satisfecho con el contenido de los comentarios.

  5. En este proyecto de ejemplo, se ejecuta un flujo de trabajo para cada solicitud de extracción. Compruebe que haya un flujo de trabajo ejecutado correctamente antes de combinar la solicitud de extracción. También puede optar por crear flujos de trabajo y entornos adicionales para probar el código antes de combinarlo. Para obtener más información, consulte Introducción a los flujos de trabajo.

  6. Cuando esté satisfecho con la última revisión de la solicitud de extracción, seleccione Combinar.

Creación de un problema y recomendaciones de tareas para este por parte de Amazon Q

A veces, un problema puede contener trabajo de gran volumen o complejidad. CodeCatalyst incluye la integración con el agente de Amazon Q Developer para el desarrollo de software. Puede pedirle a Amazon Q que analice un problema con base en el título y la descripción, y que recomiende un desglose lógico del trabajo en tareas separadas. Intentará crear una lista de tareas recomendadas que se podrán revisar y modificar; luego, podrá decidir si quiere crearlas. Esto resulta útil porque le permite asignar partes individuales a los usuarios, de modo que el trabajo sea más manejable y se pueda acelerar.

Creación y revisión de una lista de tareas recomendadas para un problema

  1. En el panel de navegación, seleccione Problemas y compruebe que se encuentra en la vista Panel.

  2. Seleccione Crear el problema.

  3. Póngale al problema un título que explique de forma sencilla lo que quiere hacer. Por ejemplo, para este problema, pondremos el título Change the get_all_mysfits() API to return mysfits sorted by the Good/Evil attribute. En Descripción, proporcione los siguientes datos:

    Update the API to allow sorting of mysfits by whether they are Good, Neutral, or Evil. Add a button on the website that allows users to quickly choose this sort and to exclude alignments that they don't want to see.

  4. Revise la descripción y asegúrese de que contiene todos los detalles necesarios antes de continuar con el siguiente paso.

  5. En Cesionarios, elija asignarse el problema a usted mismo.

  6. Seleccione Crear el problema. La vista cambiará al panel Problemas.

  7. Elija el problema que acaba de crear para abrirlo. Seleccione Recomendar tareas.

  8. Seleccione el nombre del repositorio que contiene el código del problema. Seleccione Empezar a recomendar tareas.

El cuadro de diálogo se cerrará y Amazon Q empezará a analizar la complejidad del problema. Si el problema es complejo, sugerirá dividir el trabajo en tareas secuenciales independientes. Cuando la lista esté preparada, seleccione Ver tareas recomendadas. Puede añadir tareas adicionales, modificar las tareas recomendadas y reordenarlas. Si está de acuerdo con las recomendaciones, seleccione Crear tareas para crearlas. A continuación, puede asignar esas tareas a los usuarios, o a Amazon Q, para que trabajen en ellas.

Eliminar recursos

Cuando haya completado este tutorial, valore la posibilidad de tomar las siguientes medidas para limpiar los recursos que creó durante este tutorial y que ya no necesita.

  • Anule la asignación de Amazon Q a cualquier problema en el que ya no esté trabajando. Si Amazon Q ha terminado de trabajar en un problema o no ha podido encontrar una solución, compruebe que haya anulado la asignación de Amazon Q a ese problema, a fin de no llegar a la cuota máxima de características de IA generativa. Para obtener más información, consulte Managing generative AI features y Pricing.

  • Mueva los problemas en los que se haya completado el trabajo a Listo.

  • Si el proyecto ya no es necesario, elimínelo.