Skip to main content

Acerca de los resúmenes de solicitudes de incorporación de cambios de Copilot

Con Copilot pull request summaries, puede crear una descripción generada por IA para obtener una solicitud de incorporación de cambios.

¿Quién puede utilizar esta característica?

Members of an enterprise with a subscription to GitHub Copilot Enterprise

Nota: Actualmente está viendo la documentación de los planes Free, Pro y Team. GitHub Copilot Enterprise solo está disponible para los clientes del plan GitHub Enterprise Cloud. Para obtener documentación completa de Copilot Enterprise, vea "GitHub Copilot para empresas". en la documentación de GitHub Enterprise Cloud.

Acerca de Copilot pull request summaries

Copilot pull request summaries es una característica con tecnología de inteligencia artificial que le permite crear un resumen de los cambios realizados en una solicitud de incorporación de cambios, saber a qué archivos afectan y en qué debe centrarse un revisor al realizar su revisión.

Cuando un usuario solicita un resumen, Copilot examina la solicitud de incorporación de cambios y proporciona información general sobre los cambios realizados en el texto, así como una lista con viñetas de los cambios con los archivos a los que afectan.

El único idioma admitido para Copilot pull request summaries es el inglés.

Copilot pull request summaries usa un flujo de solicitud simple que aprovecha la API Copilot, sin modelos entrenados adicionales. Esta opción usa el modelo de lenguaje grande genérico.

Generación de respuestas

El proceso actual usa un modelo de lenguaje grande para iniciar el proceso de autocompletar y generar el resumen de la solicitud de cambios.

Enfoque de canalización

Cuando un usuario solicita un resumen, se desencadena un flujo de trabajo. El flujo de trabajo usa las diferencias de código para crear una llamada de aviso, que solicita a Copilot que genere un resumen de la solicitud de incorporación de cambios. La solicitud de resumen inicia un proceso de canalización que incluye diferencias sin procesar de archivos resumibles en un mensaje y solicita a Copilot que genere un resumen global para la solicitud de cambios.

Formato de salida

Puede iniciar esta característica al crear una solicitud de incorporación de cambios; para ello, edite la descripción de la solicitud de incorporación de cambios después de su creación o hágalo en un comentario del subproceso de solicitud de incorporación de cambios. Al iniciarse, Copilot generará un resumen en dos partes:

  • Un párrafo, escrito en prosa, que proporciona información general sobre los cambios en la solicitud de cambios.
  • Una lista con viñetas de los cambios clave, vinculados a las líneas de código respectivas en las que se producen esos cambios.

Las solicitudes de cambios mayores pueden tardar un par de minutos en ser generadas por Copilot. Según la configuración de la empresa, puede compartir sus comentarios directamente desde la interfaz de usuario después de que se genere un resumen para ayudarnos a seguir mejorando la función.

Caso de uso para resúmenes de solicitudes de incorporación de cambios

El objetivo de Copilot pull request summaries es optimizar la capacidad de un autor para proporcionar rápidamente contexto cuando se solicita una revisión humana que requiera compartir el contexto de los cambios realizados. Esto puede ayudarle a aumentar la productividad del desarrollador reduciendo a su vez el tiempo necesario para abrir una solicitud de incorporación de cambios.

Para muchos usuarios, podría proporcionar un contexto más útil para los cambios realizados en una solicitud de incorporación de cambios que normalmente estarían disponibles.

Mejora del rendimiento de los resúmenes de solicitudes de incorporación de cambios

UseCopilot pull request summaries como una herramienta, no como un reemplazo.

Esta característica está pensada para complementar en lugar de reemplazar el trabajo de un humano para agregar contexto, y le animamos a seguir agregando contexto útil y permitir que Copilot haga el tedioso trabajo de analizar el código y vincularlo a archivos específicos. De todos modos, sigue siendo su responsabilidad revisar y evaluar la precisión de la información en una solicitud de incorporación de cambios que cree.

Envío de comentarios

Nota: La capacidad de proporcionar comentarios a GitHub sobre Copilot pull request summaries depende de la configuración empresarial. Para obtener más información, vea «Habilitación de funciones GitHub Copilot Enterprise».

Si surge algún problema o limitación con Copilot pull request summaries, puede hacer clic en el botón "Resumen incorrecto" (un icono de pulgar hacia abajo), que se muestra debajo del cuadro de texto, para enviar comentarios después de generar un resumen y antes de hacer clic en Crear solicitud de cambios o Actualizar comentario.

Captura de pantalla de la parte inferior de un comentario de solicitud cambios Los iconos de comentarios, los pulgares hacia arriba y los pulgares hacia abajo se resaltan con un contorno naranja oscuro.

Tras clasificar un resumen como bueno o incorrecto, puede enviar comentarios por escrito al hacer clic en el vínculo que se muestra.

Limitaciones de los resúmenes de solicitudes de incorporación de cambios

Actualmente, nuestro equipo tiene en cuenta que hay limitaciones en esta característica. Se espera que muchos de ellos aprovechen nuestras API de Copilot; sin embargo, hay algunas específicas de Copilot pull request summaries que tienen un ámbito limitado, tiempos de procesamiento más largos y respuestas inexactas. También tenemos en cuenta que los usuarios deben esperar que los términos que usen en su solicitud de incorporación de cambios aparezcan en el resumen generado por IA. Esta característica está sujeta a la formación de equipos de RAI Red, y continuaremos supervisando la eficacia y la seguridad de la característica a lo largo del tiempo. Para obtener más información, consulte Microsoft AI Red Team creará un futuro de inteligencia artificial más seguro en el blog de seguridad de Microsoft.

Ámbito limitado

Debido a esta capacidad, sabemos que las solicitudes de incorporación de cambios más grandes que hacen referencia a 30 o más archivos requerirán más tiempo para procesarse exhaustivamente. Actualmente no tenemos un umbral exacto, pero hemos observado que los primeros 30 archivos se tienen en cuenta y que, a continuación, se omiten los archivos adicionales del resumen. Estamos trabajando para poder resolver cuanto antes esta limitación en el ámbito.

Tiempo de procesamiento

En general, esperamos que se devuelva un resumen en 40 segundos o menos después de que un usuario inicie la acción. Sin embargo, sabemos que esto puede tardar hasta un minuto y que, en algunos casos, hasta un par de minutos. Estamos trabajando para reducir el tiempo de procesamiento, ya que es posible que los usuarios no quieran esperar a que finalice el proceso antes de ir a otras partes de la solicitud de incorporación de cambios.

Respuestas inexactas

Cuantas más entradas y contextos tenga Copilot para aprender, mejores serán los resultados. Sin embargo, dado que esta característica es bastante nueva, tardará tiempo en alcanzar la precisión exacta con los resúmenes que se generen. Mientras tanto, en algunos casos puede que el resumen generado sea menos preciso y requiera que el usuario realice modificaciones antes de guardar y publicar la solicitud de cambios con esta descripción. Además, existe un riesgo de "alucinación", donde Copilot genera instrucciones inexactas. Por ello, la revisión es un requisito indispensable, y nuestro equipo le recomienda encarecidamente revisar los resultados.

Regeneración de resúmenes

Los resúmenes de solicitudes de cambios solo se crean cuando los usuarios los solicitan manualmente. Cuando los usuarios envían actualizaciones o cambios de su solicitud de cambios, el resumen no se actualiza automáticamente. Los usuarios pueden pedir aCopilot que genere un nuevo resumen si es necesario. Se recomienda encarecidamente revisar manualmente el resumen de Copilot. El resumen actualizado conlleva los mismos riesgos de imprecisión que el resumen original.

Replicación del contenido de una solicitud de incorporación de cambios

Dado que un resumen es un esquema de los cambios realizados en una solicitud de incorporación de cambios, si los términos perjudiciales u ofensivos se encuentran dentro del contenido de la solicitud de incorporación de cambios, es posible que el resumen también incluya esos términos.

Información adicional