Uso de GitHub Copilot con Azure Boards

servicios de Azure DevOps

Usa Azure Boards con GitHub Copilot para pasar más rápido del elemento de trabajo al borrador de la solicitud de incorporación de cambios. Inicie Copilot desde un elemento de trabajo para crear una rama, generar cambios de código y abrir una solicitud de incorporación de cambios en borrador mientras Azure DevOps realiza un seguimiento del progreso del elemento de trabajo.

Use esta integración para:

• Inicie la codificación automatizada desde elementos de trabajo.
• Realice un seguimiento del progreso GitHub Copilot directamente en Azure DevOps.
• Vincule ramas generadas y solicitudes de incorporación de cambios a elementos de trabajo.
• Controla cuándo los pull requests en borrador están listos para revisión.

Prerrequisitos

Para administradores de equipo

Use la siguiente lista de comprobación para configurar esta integración para los equipos:

• Configura la integración de GitHub App a nivel de organización. Para conocer los pasos de configuración, consulte Conexión de Azure Boards a GitHub.
• Asegúrese de que cada miembro del equipo tenga el acceso necesario en ambos sistemas:
  • Permisos de Azure DevOps para actualizar elementos de trabajo y vincular artefactos.
  • Acceso de GitHub a los repositorios y ramas de destino.

Tipos de elementos de trabajo soportados

La integración de GitHub Copilot admite tipos de elementos de trabajo en las categorías Requisitos y tareas, entre las que se incluyen:

• Tipos de elementos de trabajo estándar, como historia de usuario, elemento de la lista de trabajo del producto, requisito, tarea, error e incidencia.
• Tipos de elementos de trabajo personalizados que defina en la plantilla de proceso.

Los tipos personalizados se admiten cuando el proceso los asigna a las categorías Requisitos o Tareas.

Puede usar GitHub Copilot con elementos de trabajo de Agile, Scrum, CMMI y plantillas de proceso personalizadas en el proyecto de Azure DevOps.

Iniciar GitHub Copilot desde un elemento de trabajo

1. Abra el elemento de trabajo que desea implementar mediante GitHub Copilot.

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

   Si hay varias opciones disponibles, el icono aparece como un menú desplegable.

   

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

   

4. Seleccione el repositorio GitHub de destino y la rama para la solicitud de incorporación de cambios.

   Nota:

   La lista de repositorios solo muestra los repositorios de GitHub conectados a través de la autenticación de GitHub App. ** No se admiten los Azure Repos.

5. (Opcional) Agregue instrucciones especiales para guiar la implementación.

   Instrucciones de ejemplo:

   • Cree un archivo README con instrucciones de configuración.
   • Utilice patrones async/await para el código asincrónico nuevo.
   • Agregue pruebas unitarias para la nueva lógica.
   • Siga las convenciones de nomenclatura y estilo de código existentes del repositorio.

6. Selecciona Crear.

   

¿Qué ocurre cuando se inicia Copilot

Al iniciar Copilot desde un elemento de trabajo, Azure DevOps realiza las siguientes acciones:

• Comparta el contexto del elemento de trabajo con GitHub Copilot: título, campos de texto grandes (como criterios de descripción y aceptación), comentarios y un vínculo al elemento de trabajo.
• Cree una rama y una solicitud de extracción en borrador en el repositorio de GitHub seleccionado y, a continuación, vincúlelas al elemento de trabajo.
• Actualizar el estado del elemento de trabajo para poder realizar un seguimiento de los estados en curso, listos para revisión y de error.

Supervisión del progreso de GitHub Copilot

Indicadores de estado

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

• En curso: Copilot está generando cambios de código.
• Listo para revisión: la solicitud de incorporación de cambios de borrador está lista para su revisión.
• Error: error en el proceso de codificación. Pase el cursor sobre el estado para ver más información.

Indicadores de tarjetas de circuito

Los elementos de trabajo de tu tablero muestran directamente el estado de GitHub Copilot en la tarjeta del elemento de trabajo. Aparece un icono de GitHub Copilot en la tarjeta e indica que Copilot está trabajando en o ha completado el trabajo para ese elemento.

Este indicador le ayuda a identificar elementos de trabajo con operaciones de Copilot activas o completadas sin tener que abrir cada elemento.

Actualizaciones de la sección desarrollo

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

• Rama creada por Copilot.
• Borrador de pull request con estado en tiempo real.
• Vínculo directo para revisar el código generado en GitHub.

Revise y combine la solicitud de incorporación de cambios

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

2. Si está satisfecho con los cambios, convierta la solicitud de incorporación de cambios en borrador en una solicitud de incorporación de cambios normal.

   La discusión del elemento de trabajo se actualiza automáticamente cuando cambia el estado de la solicitud de incorporación de cambios.

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

4. Fusiona la pull request en GitHub cuando estés listo.

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

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

   1. Actualice el estado del elemento de trabajo para reflejar la finalización.
   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 ¿Qué es GitHub Copilot?

Solución de problemas

• Comprobar los detalles del error: mantenga el puntero sobre el icono de error para ver los detalles.

• Volver a ejecutar Copilot: seleccione Volver a ejecutar Copilot para intentarlo de nuevo con las mismas instrucciones o actualizadas.

  

• 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: confirme que tiene una suscripción de GitHub Copilot activa y, a continuación, seleccione Obtener una licencia si se le solicita.

Acceso al repositorio

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

errores de Copilot

• Problema: Copilot detecta errores.
• Solución: revise los detalles del error, aclare las instrucciones y vuelva a ejecutar Copilot.

Errores repetidos después de volver a ejecutar

• Problema: Copilot sigue produciendo un error después de volver a ejecutar.
• Solución:
  • Compruebe la rama vinculada y la solicitud de incorporación de cambios en GitHub para ver el estado de la operación más reciente.
  • Confirme que los permisos del repositorio y de la rama siguen permitiendo a Copilot crear ramas y solicitudes de incorporación de cambios.
  • Si el problema continúa, póngase en contacto con el administrador del proyecto o la organización con el vínculo del elemento de trabajo y el vínculo de solicitud de incorporación de cambios.

Cancelación de una operación en curso

El estado no se actualiza

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

procedimientos recomendados

• Las descripciones claras de los elementos de trabajo: Proporcione criterios de aceptación detallados y contexto para obtener mejores resultados de Copilot.
• Mantén los cambios simples y concisos: cuanto más compleja y detallada 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

Revise las siguientes limitaciones al usar GitHub Copilot con Azure Boards:

• Dependencias: Copilot no controla las dependencias entre elementos de trabajo. Mantenga cada elemento de trabajo independiente.
• Uso compartido de datos: GitHub Copilot recibe solo el título del elemento de trabajo, campos de texto grandes, comentarios y el vínculo del elemento de trabajo.
• Complejidad: Las descripciones de elementos de trabajo demasiado complejas o verbosas pueden reducir la eficacia de Copilot.

Contenido relacionado

• Vinculación de elementos de trabajo a artefactos de desarrollo
• Configurar la integración de GitHub
• Trabajar con pull requests en Azure Repos
• Seguimiento del trabajo con vínculos y datos adjuntos