Introducción a la revisión de código de Copilot para solicitudes de incorporación de cambios

servicios de Azure DevOps

Use GitHub Copilot para revisar las solicitudes de incorporación de cambios en Azure Repos. Copilot actúa como un revisor automatizado que publica comentarios y sugerencias sobre el código modificado, por lo que obtendrá comentarios antes de que un revisor humano cierre la sesión.

Para usar esta función, un Project Collection Administrator la activa para la organización; un Project Administrator administra los valores predeterminados a nivel de proyecto y las anulaciones del repositorio; los administradores del repositorio configuran los repositorios individuales cuando se permiten anulaciones; y los usuarios individuales activan las funciones en versión preliminar mediante Características en versión preliminar (a menos que el administrador habilite la versión preliminar para todos).

Prerequisites

Habilitación de la revisión de código Copilot

En el nivel de organización

Un administrador de la colección de proyectos debe habilitar la revisión de código de Copilot para la organización antes de que los propietarios de proyectos puedan activarla en proyectos y repositorios individuales.

Si selecciona la opción de nivel de organización Habilitar todo, se habilita la revisión de código de Copilot para todos los proyectos de la organización y para todos los repositorios de esos proyectos. No es necesario habilitar individualmente cada proyecto o repositorio.

1. Inicie sesión en su organización de Azure DevOps https://dev.azure.com/{yourorganization}).

2. Seleccione Configuración de organización>Repos>Repositories.

3. En revisión de código de GitHub Copilot, cambie Permitir que los repositorios de esta organización usen la revisión de código de Copilot a Activado.

   

En el nivel de proyecto

Una vez habilitado el acceso a nivel de organización, un administrador del proyecto puede habilitar opcionalmente la función a nivel de proyecto. Esta opción proporciona un control detallado sobre qué proyectos de la organización pueden usar la revisión de código de Copilot.

Si seleccionas la opción Habilitar todo del proyecto, la revisión de código de Copilot se habilita en todos los repositorios de ese proyecto. No es necesario habilitar individualmente cada repositorio.

1. Seleccione Project settings>Repos>Repositories.

2. En revisión de código de GitHub Copilot, cambie Habilitar la revisión de código de Copilot para este proyecto a Activado.

   

   Esta configuración se aplica a todos los repositorios del proyecto a menos que se invalide en el nivel de repositorio. Todavía puede habilitar o deshabilitar la característica para repositorios individuales según sea necesario.

En el nivel de repositorio

Después de habilitar el acceso de nivel de organización (y, opcionalmente, el acceso de nivel de proyecto), un propietario del repositorio activa Copilot revisión de código para cada repositorio que debe usarlo.

1. Seleccione Project settings>Repos>Repositories.

2. Seleccione el repositorio que desea habilitar.

3. En la pestaña Settings, active Habilitar la revisión de código de Copilot para las solicitudes de extracción en este repositorio a On.

   

Para comprobar que la característica está habilitada, abra cualquier solicitud de incorporación de cambios en el repositorio. GitHub Copilot ahora debería aparecer como revisor disponible en la lista Reviewers.

Configurar la revisión de código de Copilot

Después de habilitar la característica en los tres ámbitos, puede configurar cómo Copilot revisa las solicitudes de incorporación de cambios en los repositorios.

Configuración del esfuerzo de revisión predeterminado

El esfuerzo de revisión controla cómo Copilot analiza exhaustivamente una solicitud de incorporación de cambios. Un administrador de proyectos establece el esfuerzo predeterminado para todos los repositorios de un proyecto y decide si los administradores de repositorios pueden invalidarlo. Los usuarios pueden seleccionar un nivel de esfuerzo diferente para una revisión individual sin cambiar el valor predeterminado del proyecto o del repositorio.

Por lo general, los niveles de esfuerzo más altos consumen más tokens y pueden aumentar el costo de una revisión. Para obtener más información, vea Facturación.

Establecer el valor predeterminado del proyecto

1. Seleccione Project settings>Repos>Repositories.

2. En Revisión de código de GitHub Copilot, seleccione una opción de Nivel de esfuerzo predeterminado.

3. Para permitir que los administradores del repositorio establezcan un valor predeterminado diferente, seleccione Permitir que los repositorios individuales establezcan su propio nivel de esfuerzo predeterminado. Desactive esta opción para requerir que todos los repositorios usen el valor predeterminado del proyecto.

   

Establecimiento de un valor predeterminado del repositorio

Si el proyecto permite invalidaciones de repositorio, un administrador del repositorio puede establecer un valor predeterminado diferente:

1. Seleccione Project settings>Repos>Repositories.
2. Seleccione el repositorio y, a continuación, seleccione la pestaña Configuración .
3. En Revisión de código de GitHub Copilot, seleccione una opción de Nivel de esfuerzo predeterminado.

Si el proyecto no permite invalidaciones de repositorio, el nivel de esfuerzo predeterminado es de solo lectura y muestra la configuración del proyecto heredado.

Configuración de directivas de revisión automática

Copilot puede revisar automáticamente las nuevas solicitudes de incorporación de cambios sin necesidad de solicitudes manuales. Puede configurar esta directiva para todos los repositorios de un proyecto o para repositorios individuales.

La habilitación de características y la revisión automática son configuraciones independientes. Habilitar la revisión de código de Copilot la pone a disposición de un repositorio. Una política de revisión automática solicita que Copilot realice una revisión cuando se crea un nuevo pull request.

Configuración de la revisión automática para todos los repositorios de un proyecto

Use la política a nivel de proyecto para solicitar automáticamente revisiones de Copilot en todos los repositorios del proyecto. No es necesario configurar la directiva para cada repositorio individualmente.

1. Seleccione Project settings>Repos>Repositories.

2. En revisión de código de GitHub Copilot, cambie Solicitar automáticamente la revisión de código de Copilot en las nuevas solicitudes de extracción para todos los repositorios de este proyecto a Activado.

   Esta configuración se aplica a todos los repositorios del proyecto a menos que una directiva de nivel de repositorio la invalide.

Configuración de la revisión automática para un repositorio

Use la directiva de nivel de repositorio cuando necesite un comportamiento específico del repositorio.

1. Seleccione Project settings>Repos>Repositories.

2. Seleccione el repositorio que desea configurar.

3. En la pestaña Configuración, en Revisión de código de GitHub Copilot, cambia Solicitar automáticamente la revisión de código de Copilot en las nuevas solicitudes de cambios a Activado.

4. (Opcional) Configurar el ámbito de revisión:

   • Aplicar a todas las solicitudes de incorporación de cambios: Copilot revisa cada nueva solicitud de incorporación de cambios en el repositorio.
   • Se aplica a políticas de rama específicas: Copilot revisa solo las solicitudes de extracción dirigidas a las ramas especificadas (por ejemplo, main o develop).

   Precedencia de políticas para las revisiones automáticas:

   • La directiva de revisión automática de nivel de proyecto se aplica a todos los repositorios del proyecto.
   • La configuración de revisión automática de nivel de repositorio invalida el valor predeterminado de nivel de proyecto para ese repositorio.

Al habilitar la revisión automática, Copilot comienza a revisar las nuevas solicitudes de incorporación de cambios inmediatamente después de la creación. Para solicitar revisiones adicionales manualmente, seleccione Solicitar junto a GitHub Copilot en la solicitud de incorporación de cambios.

Selección de un grupo de agentes

La revisión de código de Copilot ejecuta trabajos de revisión mediante un grupo de agentes de Azure Pipelines. De forma predeterminada, usa el grupo de Azure Pipelines predeterminado de la organización.

Algunas organizaciones deshabilitan el grupo de Azure Pipelines predeterminado. En esa configuración, la revisión de código de Copilot no puede ejecutarse hasta que selecciones un grupo alternativo compatible.

Si su organización ha configurado un grupo de DevOps administrado, puede seleccionarlo para ejecutar Copilot revisión de código en lugar del grupo predeterminado.

Al seleccionar una imagen para el grupo de DevOps administrado, asegúrese de seleccionar la versión más reciente Ubuntu Server.

Las imágenes de Windows no son compatibles con las revisiones de código de Copilot. No combine agentes de Ubuntu y de Windows en el mismo grupo.

1. Seleccione Configuración de organización>Repos>Repositories.

2. En revisión de código de GitHub Copilot, seleccione Grupo de proceso en el menú desplegable.

   La configuración del grupo de computación de su organización determina los grupos de computación disponibles. Si no hay grupos disponibles, póngase en contacto con el administrador de la organización.

3. Haga clic en Guardar.

El grupo seleccionado procesa todas las revisiones de código Copilot para repositorios de su organización. Puede cambiar esta opción de configuración en cualquier momento. Para usar grupos diferentes para distintos proyectos o repositorios, configure las asignaciones de grupo a través de grupos de DevOps administrados.

Personaliza el comportamiento de revisión de Copilot

Para obtener instrucciones sobre cómo usar instrucciones personalizadas y aptitudes del agente para adaptar los comentarios de revisión de código de Copilot, consulte Configuración de instrucciones de revisión de código Copilot.

Usar la revisión de código de Copilot

Con la característica habilitada en los tres ámbitos, puede pedir Copilot revisar una solicitud de incorporación de cambios. En las secciones siguientes se describe qué esperar.

Solicitar una revisión

De forma predeterminada, GitHub Copilot revisa una solicitud de incorporación de cambios solo cuando se solicita una:

1. Abrir una solicitud de incorporación de cambios.

2. En la sección Revisores, use una de las siguientes opciones junto a GitHub Copilot:

   • Para usar el nivel de esfuerzo predeterminado del repositorio, seleccione Solicitar.
   • Para usar un nivel de esfuerzo diferente para esta revisión, abra el menú desplegable junto a Solicitar y seleccione un nivel de esfuerzo.

3. Espere a que se complete la revisión. La revisión puede tardar unos instantes, según el tamaño del repositorio y el número de cambios en la solicitud de incorporación de cambios. Cuando finalice la revisión, el estado cambia a Revisión completada.

   

Si Copilot identifica posibles problemas, agrega comentarios y sugerencias directamente a la solicitud de incorporación de cambios para que examine y solucione.

El nivel de esfuerzo seleccionado solo se aplica a esa revisión. Azure DevOps registra el solicitante y el nivel de esfuerzo en la actividad de solicitud de incorporación de cambios.

Leer los comentarios de Copilot

• Copilot publica sus comentarios como un revisor habitual llamado GitHub Copilot en la pull request.
• Cada comentario aparece en la línea de código al que se aplica y, siempre que sea posible, incluye un cambio sugerido que puede aplicar con un solo clic.
• Copilot siempre deja un comentario de revisión. Nunca aprueba la solicitud de extracción ni solicita cambios, por lo que su revisión no satisface las políticas de revisores obligatorios y no bloquea la fusión.
• Los comentarios de Copilot funcionan como los comentarios de un revisor humano. Puede responder a ellos, reaccionar a ellos, resolverlos u ocultarlos. Copilot no lee las respuestas y no sigue.

Volver a revisar después de nuevas confirmaciones

Copilot no vuelve a revisar automáticamente una pull request cuando subes nuevos commits. Para obtener una revisión nueva después de una confirmación, seleccione Request junto a GitHub Copilot en la lista Reviewers.

Cancelar una revisión en curso

Si una revisión de código tarda más de lo esperado o necesita detenerla, puede cancelar la ejecución de revisión.

1. Abra la solicitud de incorporación de cambios donde Copilot está revisando actualmente.
2. En la sección Revisores, junto a GitHub Copilot, seleccione el botón Cancelar (o seleccione Más opciones>Cancelar revisión).
3. Confirme la cancelación cuando se le solicite.

La ejecución de la revisión se detiene inmediatamente y no se añaden comentarios adicionales. Los resultados de la revisión parcial, incluidos los comentarios agregados antes de la cancelación, permanecen en la solicitud de incorporación de cambios. Puede solicitar una nueva revisión en cualquier momento.

Requisitos y límites

Los siguientes requisitos y límites se aplican durante la versión preliminar y pueden cambiar.

Copilot revisa una solicitud de incorporación de cambios solo cuando cumple estos requisitos:

Estos límites de simultaneidad y frecuencia también se aplican:

Billing

Cada revisión de código completada consume tokens, incluidos los tokens de entrada que se envían al modelo, los tokens de salida que genera el modelo y los tokens almacenados en caché que reutilizan el contexto existente. Los tokens usados para cada revisión se convierten en una unidad de facturación estándar llamada crédito de IA de GitHub, donde 1 crédito equivale a 0,01 $ USD.

El esfuerzo de revisión seleccionado afecta al consumo. Por lo general, los niveles de esfuerzo más altos analizan más contexto y consumen más tokens que los niveles de esfuerzo inferiores. El tamaño de la solicitud de extracción, las instrucciones personalizadas del repositorio y los cambios en el modelo también pueden afectar al consumo. Para ver los intervalos de referencia actuales y advertencias, consulte Consumo estimado.

Para obtener respuestas a las preguntas más frecuentes sobre la facturación y los costes de la revisión de código de Copilot, consulte Solucionar problemas de la revisión de código de Copilot.

Los cargos van a la suscripción de Azure vinculada a la organización de Azure DevOps y aparecen como un medidor independiente en Azure Cost Management. Para calcular los costos esperados en su entorno, habilite la característica para uno o dos repositorios, compare los niveles de esfuerzo de revisión y supervise el uso diario.

Los cargos por revisión de código de Copilot en Azure Cost Management ahora incluyen etiquetas de proyecto de Azure DevOps, lo que permite generar informes de costes por proyecto. Puede filtrar o agrupar el análisis de costos por estas etiquetas de proyecto para asignar el uso y gastar en proyectos de Azure DevOps individuales.

Para controlar tus cargos diarios:

1. En el portal Azure, vaya a la suscripción.

2. Seleccione Cost Management>Análisis de costos.

3. Filtre por producto para ver los costos diarios de la organización. Para ver los costos de un proyecto específico, agregue un filtro o agrupe por la etiqueta del proyecto de Azure DevOps.

   

Establecimiento de una alerta de presupuesto

Cree un presupuesto Azure que le notifique cuando el gasto alcance un umbral establecido. Los presupuestos solo te avisan. No detienen las revisiones ni cambian ningún recurso. Necesita acceso de propietario, colaborador o colaborador de Cost Management en la suscripción vinculada a su organización de Azure DevOps.

1. En el portal de Azure, abra la suscripción vinculada a la organización de Azure DevOps.

2. Seleccione Cost Management>Presupuestos y, a continuación, seleccione Agregar.

3. En Filtros, agregue un filtro para Producto y seleccione GitHub Copilot para AzDO.

   

4. Si la suscripción está vinculada a varias organizaciones de Azure DevOps, agregue un filtro para Etiqueta y seleccione las etiquetas de nombre de la organización a las que desea que se dirija la alerta. Si hay etiquetas de proyecto presentes, también puede filtrar o agrupar por etiqueta de proyecto para crear alertas de presupuesto de nivel de proyecto.

5. Escriba un nombre de presupuesto, elija un período de restablecimiento y una fecha de expiración, establezca el importe del presupuesto y, a continuación, seleccione Siguiente.

6. Agregue uno o más umbrales de alerta como porcentaje del presupuesto (por ejemplo, 75% y 90%), establezca Tipo en Real o Previsto y escriba las direcciones de correo electrónico que se van a notificar.

7. Seleccione Crear.

   

Cuando el gasto alcanza un umbral, Azure envía un correo electrónico dentro de una hora de la siguiente evaluación. Para revisar las alertas desencadenadas, seleccione Alertas de costo de Cost Management>. Para evitar que los correos electrónicos de alerta acaben en la carpeta de correo no deseado, añada azure-noreply@microsoft.com a la lista de remitentes seguros. Para obtener más información, consulte Creación y administración de presupuestos.

Desactivar la revisión de código de Copilot

Para dejar de usar la revisión de código de Copilot, establezca el interruptor en Off en el ámbito en el que quiera desactivarla:

• Para un usuario: Desactiva el interruptor Funciones en vista previa en la configuración del usuario.
• En un repositorio: desactive el interruptor del repositorio en Configuración del proyecto>Repos>Repositorios.
• Para toda la organización: desactive el interruptor de la organización en Configuración de la organización>Repos>Repositorios. Esta acción deshabilita la característica para todos los repositorios.

Compartir comentarios

Para notificar problemas o compartir comentarios sobre esta versión preliminar, visite el Azure DevOps Developer Community.

Solucionar problemas de la revisión de código de Copilot

Para obtener respuestas a preguntas frecuentes sobre la facturación, la gestión de datos, el cumplimiento y la solución de problemas relacionados con las instrucciones personalizadas, consulte Solucionar problemas de la revisión de código de Copilot.

Paso siguiente

Contenido relacionado

• Solucionar problemas de la revisión de código de Copilot
• Configuración de instrucciones de revisión de código Copilot
• Acerca de la revisión de código de GitHub Copilot
• Acerca de las solicitudes de incorporación de cambios
• Configuración y directivas del repositorio