Crear un problema en CodeCatalyst

Los equipos de desarrollo crean problemas para facilitar el seguimiento y la gestión de su trabajo. Puede crear problemas dentro de un proyecto en función de sus necesidades. Por ejemplo, puedes crear una incidencia para hacer un seguimiento de la actualización de una variable de tu código. Puedes asignar problemas a otros usuarios del proyecto, usar etiquetas para ayudarte a realizar un seguimiento de tu trabajo y mucho más.

Sigue estas instrucciones para crear una edición en CodeCatalyst.

Para crear una incidencia

Abre la CodeCatalyst consola en https://codecatalyst.aws/.
Navegue hasta el proyecto en el que desee crear una edición.
En la página de inicio del proyecto, selecciona Crear edición. Como alternativa, en el panel de navegación, selecciona Problemas.
Selecciona Crear problema.

nota
También puedes añadir las incidencias en línea cuando utilices una vista de cuadrícula.
Introduce un título para el número.
(Opcional) Introduce una descripción. Puedes usar Markdown para añadir formato.
(Opcional) Elige un estado, una prioridad y una estimación para el problema.

nota
Si la configuración de estimación del proyecto está configurada en Ocultar estimaciones, no habrá ningún campo de estimación.
(Opcional) Agrega tareas al problema. Las tareas se pueden usar para dividir el trabajo de un tema en objetivos más pequeños. Para añadir una tarea, selecciona + Añadir tareas. A continuación, introduce el nombre de la tarea en el campo de texto y pulsa enter. Después de añadir las tareas, puedes marcarlas como completadas seleccionando la casilla de verificación o reordenándolas seleccionando y arrastrando la tarea desde el lado izquierdo de la casilla de verificación.
(Opcional) Añade una etiqueta existente o crea una nueva y agrégala seleccionando + Añadir etiqueta.
1. Para añadir una etiqueta existente, selecciónela de la lista. Puede introducir un término de búsqueda en el campo para buscar en el proyecto todas las etiquetas que contengan ese término.
2. Para crear una etiqueta nueva y añadirla, introduce el nombre de la etiqueta que deseas crear en el campo de búsqueda y pulsa enter.
(Opcional) Agregue un cesionario seleccionando + Agregar un cesionario. Puedes añadirte rápidamente como cesionario seleccionando + Añadirme.

sugerencia
Puedes asignar un problema a Amazon Q para que Amazon Q intente resolverlo. Para obtener más información, consulte Tutorial: Uso de funciones de IA CodeCatalyst generativa para acelerar el trabajo de desarrollo. Esta función solo está disponible en la región EE.UU. Oeste (Oregón).
Esta funcionalidad requiere que las funciones de IA generativa estén habilitadas en el espacio. Para obtener más información, consulte Administrar las funciones de IA generativa.
(Opcional) Añada un campo personalizado existente o cree uno nuevo. Los problemas pueden tener varios campos personalizados.
1. Para añadir un campo personalizado existente, elija el campo personalizado de la lista. Puede introducir un término de búsqueda en el campo para buscar en todos los campos personalizados que contengan ese término en el proyecto.
2. Para crear un campo personalizado nuevo y añadirlo, introduzca el nombre del campo personalizado que desee crear en el campo de búsqueda y pulse Entrar. A continuación, elija el tipo de campo personalizado que desee crear y establezca un valor.
Selecciona Crear incidencia. Aparece una notificación en la esquina inferior derecha: si el problema se creó correctamente, aparecerá un mensaje de confirmación que indica que el problema se creó correctamente. Si el problema no se ha creado correctamente, aparece un mensaje de error con el motivo del error. A continuación, puede seleccionar Reintentar para editar y volver a intentar crear el problema, o bien seleccionar Descartar para descartar el problema. Ambas opciones descartarán la notificación.

nota
No puedes vincular una solicitud de cambios a una edición al crearla. Sin embargo, puedes editarla después de crearla para añadir enlaces a las solicitudes de cambios.

Prácticas recomendadas a la hora de crear problemas asignados a Amazon Q y trabajar con ellos

Al crear problemas, a veces algunos de ellos persisten. Las causas de esto pueden ser complejas y variables. A veces se debe a que no está claro quién debe trabajar en ello. Otras veces, el tema requiere investigación o experiencia con una parte determinada del código base y los mejores candidatos para el trabajo están ocupados con otros temas. A menudo hay otro trabajo urgente que hay que atender primero. Cualquiera de estas causas o todas ellas pueden provocar problemas que no se resuelvan. CodeCatalyst incluye la integración con un asistente de IA generativa llamado Amazon Q que puede analizar un problema en función de su título y su descripción. Si asignas el problema a Amazon Q, intentará crear un borrador de solución para que lo evalúes. Esto puede ayudarte a ti y a tu equipo a centrar y optimizar el trabajo en los problemas que requieren tu atención, mientras que Amazon Q trabaja en una solución para los problemas que no tienes recursos para abordar de forma inmediata.

nota

Desarrollado por Amazon Bedrock: AWS implementa la detección automática de abusos. Como la función Asignar problemas a Amazon Q con Amazon Q Developer Agent para el desarrollo de software está integrada 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).

Amazon Q funciona mejor en temas simples y problemas directos. Para obtener los mejores resultados, utilice un lenguaje sencillo para explicar claramente lo que quiere que se haga. Las siguientes son algunas prácticas recomendadas que te ayudarán a crear problemas optimizados para que Amazon Q.

importante

Las funciones de IA generativa solo están disponibles en la región EE.UU. Oeste (Oregón).

Manténgalo sencillo. Amazon Q funciona mejor con cambios y correcciones de código simples que se pueden explicar en el título y la descripción del problema. No asigne a los problemas títulos vagos o descripciones demasiado floreadas o contradictorias.
Sé específico. Cuanta más información puedas proporcionar sobre los cambios exactos necesarios para resolver el problema, más probabilidades habrá de que Amazon Q pueda crear una solución que resuelva el problema. Si es posible, incluya detalles específicos, como el nombre de las API que desee cambiar, los métodos que desee actualizar, las pruebas que necesiten cambios y cualquier otro detalle que se le ocurra.
Asegúrate de incluir todos los detalles en el título y la descripción del problema antes de asignarlo a Amazon Q. No puedes cambiar el título o la descripción de un número después de asignarlo a Amazon Q, así que asegúrate de tener toda la información requerida en un número antes de asignarlo a Amazon Q.
Asigne únicamente los problemas que requieran cambios de código a un único repositorio fuente. Amazon Q solo puede funcionar con el código de un único repositorio fuente en CodeCatalyst. No se admiten los repositorios enlazados. Asegúrese de que el problema solo requiera cambios en un repositorio de origen único antes de asignarlo a Amazon Q.
Usa la opción predeterminada sugerida por Amazon Q para aprobar cada paso. De forma predeterminada, Amazon Q requerirá tu aprobación para cada paso que dé. Esto te permite interactuar con Amazon Q en los comentarios no solo sobre el tema, sino también sobre cualquier solicitud de cambios que cree. Esto proporciona una experiencia más interactiva con Amazon Q que le ayuda a ajustar su enfoque y refinar el código que crea para resolver el problema.

nota
Amazon Q no responde a los comentarios individuales de las ediciones o solicitudes de cambios, pero los revisará cuando se le pida que reconsidere su enfoque o cree una revisión.
Revise siempre detenidamente el enfoque sugerido por Amazon Q. Una vez que apruebe su enfoque, Amazon Q empezará a trabajar en la generación de código basado en ese enfoque. Asegúrese de que el enfoque le parezca correcto e incluya todos los detalles que espera antes de decirle a Amazon Q que continúe.
Asegúrate de permitir que Amazon Q solo funcione en flujos de trabajo si no tienes flujos de trabajo existentes que puedan implementarlos antes de revisarlos. Es posible que tu proyecto tenga flujos de trabajo configurados para iniciar ejecuciones en eventos de solicitudes de incorporación de cambios. Si es así, cualquier solicitud de extracción que Amazon Q cree y que incluya la creación o actualización del flujo de trabajo YAML podría iniciar una ejecución de los flujos de trabajo incluidos en la solicitud de extracción. Como práctica recomendada, no permitas que Amazon Q trabaje en archivos de flujo de trabajo a menos que estés seguro de que no hay flujos de trabajo en tu proyecto que los ejecuten automáticamente antes de revisar y aprobar la solicitud de extracción que crea.