Uso de GitHub Copilot con Azure Boards

Azure DevOps Services

Azure Boards se integra con GitHub Copilot para simplificar el flujo de trabajo de desarrollo. Puede usar elementos de trabajo directamente con Copilot, que crea automáticamente ramas, implementa cambios de código y genera solicitudes de incorporación de cambios de borrador mientras mantiene actualizado el elemento de trabajo con el progreso.

Esta integración le permite:

• Iniciar la codificación automatizada desde elementos de trabajo
• Seguimiento del progreso de GitHub Copilot directamente en Azure DevOps
• Vincular automáticamente las solicitudes de incorporación de cambios generadas y las ramas a los elementos de trabajo
• Monitorea cuándo las solicitudes de extracción de borrador están listas para revisión

Prerrequisitos

Tipos de elementos de trabajo soportados

La integración de GitHub Copilot admite cualquier tipo de elemento de trabajo en los requisitos y la categoría de tareas, entre los que se incluyen:

• Tipos de elementos de trabajo estándar: Caso de usuario, Producto pendiente de trabajo, Requisito, Tarea, Error, Problema
• Tipos de elementos de trabajo personalizados que creó en la plantilla de proceso

Esta amplia compatibilidad significa que puede usar GitHub Copilot con elementos de trabajo de cualquier plantilla de proceso (Agile, Scrum, CMMI o personalizado) en el proyecto de Azure DevOps.

Inicio de GitHub Copilot a partir de elementos de trabajo

1. Abra un elemento de trabajo que quiera usar con GitHub Copilot.

2. En el formulario de elemento de trabajo, seleccione el icono de GitHub.

   Si hay varias opciones disponibles, el botón se convierte en un menú desplegable con diferentes opciones.

   

3. Seleccione Crear una solicitud de incorporación de cambios con GitHub Copilot.

   

4. Seleccione el repositorio de GitHub objetivo y la rama donde Copilot debe crear el pull request.

   Nota:

   Solo los repositorios de GitHub conectados a través de la autenticación de aplicaciones de GitHub aparecen en la lista de repositorios. Azure Repos no se admiten.

5. (Opcional) Agregue instrucciones especiales para guiar el enfoque de implementación de Copilot. Por ejemplo, podría agregar " Create README with setup instructions" (Crear LÉAME con instrucciones de configuración).

6. Seleccione Crear para comenzar el proceso de codificación automatizada.

   

¿Qué ocurre cuando inicia Copilot?

Al iniciar Copilot desde un elemento de trabajo, se producen los siguientes procesos automatizados:

• Uso compartido de datos: Azure DevOps comparte el título del elemento de trabajo, campos de texto grandes (como criterios de descripción y aceptación), comentarios y un vínculo al elemento de trabajo con GitHub Copilot.
• Validación de licencias: Azure DevOps comprueba la licencia de GitHub Copilot.
  • Si se produce un error en la validación, aparece una opción Obtener una licencia para comprar GitHub Copilot.
• Preparación del repositorio: Copilot crea una nueva rama para el trabajo.
• Creación de solicitudes de extracción: Se genera automáticamente un borrador de solicitud de extracción y se vincula al elemento de trabajo.
• Actualizaciones de elementos de trabajo:
  • Se añade un comentario a la discusión sobre el elemento de trabajo.
  • El indicador de estado aparece encima de la sección Desarrollo.
  • Los vínculos de bifurcaciones y de solicitudes de extracción se agregan automáticamente.
• Seguimiento de progreso: las actualizaciones de estado en tiempo real muestran el progreso de Copilot.

Supervisión del progreso de GitHub Copilot

Indicadores de estado

Azure DevOps muestra el estado de Copilot directamente en el elemento de trabajo con tres estados posibles:

• En curso: Copilot está trabajando activamente en los cambios de código.
• Listo para revisión: el borrador de la solicitud de incorporación de cambios está completo y listo para su revisión.
• Error: se produjeron problemas durante el proceso de codificación (mantenga el puntero para obtener más información).

Indicadores de tarjetas de circuito

Al ver los elementos de trabajo en el tablero, puede identificar el estado de GitHub Copilot directamente en la tarjeta del elemento de trabajo. Aparece un icono de GitHub Copilot en la tarjeta e indica que Copilot está trabajando o ha completado el trabajo para ese elemento.

Este indicador visual le ayuda a identificar rápidamente qué elementos de trabajo tienen operaciones activas de Copilot sin abrir cada elemento de trabajo individual.

Actualizaciones de la sección desarrollo

La sección Desarrollo del elemento de trabajo muestra automáticamente:

• Rama vinculada creada por Copilot.
• Solicitud de incorporación de cambios redactada con seguimiento en tiempo real.
• Vínculos directos para revisar el código generado en GitHub.

Revisión e integración de la solicitud de extracción

1. Seleccione el vínculo de solicitud de incorporación de cambios para revisar la implementación de Copilot en GitHub.

2. Si estás satisfecho con los cambios, convierte el borrador en un pull request normal. La discusión del elemento de trabajo recibe actualizaciones automáticas sobre los cambios de estado del pull request.

3. Use la interfaz de GitHub para revisar, comentar y aprobar el código generado.

4. Complete el proceso de combinación en GitHub cuando esté listo.

   • La confirmación de fusión se vincula automáticamente con tu elemento de trabajo.
   • Los enlaces de ramas se eliminan si se elimina la rama.
   • Los indicadores de estado de Copilot se ocultan después de una combinación correcta.

5. Después de fusionar la solicitud de extracción:

   1. Para reflejar la finalización, actualice el estado del elemento de trabajo.
   2. Compruebe que la confirmación de combinación aparece en la sección Desarrollo.
   3. Cierre el elemento de trabajo si la implementación se ocupa completamente de los requisitos.

Para obtener más información, consulte nuestro módulo de entrenamiento Introducción a GitHub Copilot.

Solución de problemas

• Comprobar los detalles del error: mantenga el puntero sobre el icono de error para obtener información específica sobre lo que salió mal.

• Volver a ejecutar Copilot: seleccione Volver a ejecutar Copilot para intentar el proceso de nuevo con las mismas instrucciones o modificadas.

  

• Intervención manual: Si es necesario, realice cambios manuales en la rama generada y el pull request.

Problemas de licencia

• Problema: se produce un error en la validación de licencias.
• Solución: asegúrese de que tiene una suscripción activa de GitHub Copilot y seleccione Obtener una licencia si es necesario.

Acceso al repositorio

• Problema: no se pueden ver los repositorios esperados.
• Solución:
  • Compruebe la conexión de la aplicación de GitHub entre Azure DevOps y GitHub.
  • Asegúrese de que tiene acceso a repositorios de GitHub (no a Azure Repos).
  • Compruebe los permisos del repositorio y la autenticación de aplicaciones de GitHub.
  • Confirme que el repositorio está conectado a través de la integración correcta de la aplicación de GitHub.

Errores de Copilot

• Problema: el agente de codificación encuentra errores.
• Solución: revise los detalles del error, compruebe las instrucciones para mayor claridad e intente volver a ejecutar Copilot.

El estado no se actualiza

• Problema: el estado de progreso permanece bloqueado.
• Solución: compruebe GitHub para ver el progreso real, ya que las actualizaciones de estado dependen de los informes de GitHub.

procedimientos recomendados

• Aclarar descripciones de elementos de trabajo: proporcione criterios de aceptación detallados y contexto para mejorar los resultados de Copilot.
• Mantener los cambios sencillos y concisos: cuanto más complejo y detallado sea la descripción del elemento de trabajo, más difícil es que Copilot comprenda. Céntrese en requisitos claros y específicos.
• Instrucciones específicas: agregue instrucciones de implementación al iniciar Copilot.
• Supervisión regular: compruebe el progreso periódicamente, especialmente para los elementos de trabajo complejos.
• Revisión rápida: revise y proporcione comentarios sobre el borrador de solicitudes de incorporación de cambios rápidamente para mantener el impulso.
• Higiene adecuada de los elementos de trabajo: actualice los estados del elemento de trabajo correctamente durante todo el proceso.

Limitaciones

Tenga en cuenta las siguientes limitaciones al usar GitHub Copilot con Azure Boards:

• Dependencias: no se admite el control de dependencias entre elementos de trabajo. Cada elemento de trabajo debe ser independiente.
• Operaciones simultáneas: no se admite la administración de varias operaciones de Copilot simultáneas en distintos elementos de trabajo. Complete una operación de Copilot antes de iniciar otra.
• Uso compartido de datos: solo el título del elemento de trabajo, los campos de texto grandes, los comentarios y el vínculo del elemento de trabajo se comparten con GitHub Copilot.
• Complejidad: las descripciones de elementos de trabajo demasiado complejas o detalladas pueden reducir la eficacia de Copilot.

Contenido relacionado

• Vinculación de elementos de trabajo a artefactos de desarrollo
• Configuración de la integración de GitHub
• Trabajar con solicitudes de incorporación de cambios en Azure Repos
• Seguimiento del trabajo con vínculos y datos adjuntos