Configuración de la revisión de código mediante GitHub Copilot

Introducción

Puede configurar Copilot code review para revisar las solicitudes de incorporación de cambios automáticamente y puede establecer el Copilot esfuerzo de revisión. Para obtener información general, consulte Sobre la revisión de código de GitHub Copilot.

Configuración de la revisión automática de código para tus propias solicitudes de incorporación de cambios

Puede establecer Copilot code review para revisar las solicitudes de incorporación de cambios que cree, en cualquier repositorio donde Copilot code review esté disponible.

1. En la esquina superior derecha de cualquier página de GitHub, haz clic en la fotografía de perfil y luego en Copilot settings.
2. En la barra lateral, en Copilot, haga clic en Revisión de código.
3. Habilite Automático Copilot code review.
4. Opcionalmente, para revisar cada nueva inserción en una solicitud de incorporación de cambios que Copilot ya está revisando, habilite Revisar nuevas inserciones.
5. Opcionalmente, para revisar las solicitudes de incorporación de cambios mientras siguen marcadas como borradores, habilite Revisar solicitudes de incorporación de cambios de borrador.

Una solicitud de incorporación de cambios puede calificar para la revisión automática de varios orígenes independientes: la configuración del usuario, los conjuntos de reglas de repositorio o los conjuntos de reglas de la organización. Estos orígenes se evalúan por separado. Si se aplica más de un origen, Copilot sigue publicando una sola revisión. La configuración de usuario no puede deshabilitar las revisiones push ni las revisiones en borrador que haya habilitado un conjunto de reglas. Para obtener más información, vea Sobre la revisión de código de GitHub Copilot.

Configurar su Copilot esfuerzo de revisión

Puede elegir el Copilot esfuerzo de revisión que Copilot code review usa para las revisiones que solicite. Su elección se aplica a las revisiones automáticas y a las revisiones que solicite manualmente. Para obtener una visión general de los niveles y de cómo Copilot decide cuál usar, consulte Sobre la revisión de código de GitHub Copilot.

1. En la esquina superior derecha de cualquier página de GitHub, haz clic en la fotografía de perfil y luego en Copilot settings.
2. En la barra lateral, en Copilot, haga clic en Revisión de código.
3. Junto a la opción "Nivel de esfuerzo de revisión", seleccione el Copilot nivel de esfuerzo de revisión para las revisiones que solicite.
   • Lite: Revisión estándar.
   • Equilibrado: análisis más profundo de la lógica compleja, el código sensible a la seguridad y los cambios entre servicios.
   • Max: Revisión más exhaustiva. Esta opción aparece con una etiqueta Próximamente y aún no está disponible.

Para volver al valor predeterminado integrado, seleccione la opción Predeterminado en la parte superior del menú. Hasta que elija un nivel específico, el control muestra el valor predeterminado integrado que se aplica a usted, default (Lite) o Default (Balanced).

Tu esfuerzo de revisión Copilot es independiente de Automático Copilot code review. Desactivar la revisión automática no elimina tu Copilot esfuerzo de revisión ni hace que deje de aplicarse a las revisiones que solicites manualmente.

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

Puede habilitar las revisiones automáticas de código para un repositorio y personalizar cómo se realizan las revisiones de código.

Habilitación de revisiones automáticas

1. En GitHub, navegue hasta la página principal del repositorio.

2. Debajo del nombre del repositorio, haz clic en Settings. Si no puedes ver la pestaña "Configuración", selecciona el menú desplegable y, a continuación, haz clic en Configuración.

   

3. En la barra lateral izquierda, en "Código y automatización", haga clic en Conjuntos de reglas y, a continuación, haga clic en Conjuntos de reglas.

4. Haga clic en Nuevo conjunto de reglas.

5. Haga clic en Nuevo conjunto de reglas de rama.

6. En «Nombre del conjunto de reglas», escribe un nombre para el conjunto de reglas.

7. Para activar el conjunto de reglas, en "Enforcement Status", selecciona Active.

8. En "Ramas de destino", haz clic en Agregar destino y elige una de las opciones, por ejemplo, Incluir rama predeterminada o Incluir todas las ramas.

9. En "Ramas de destino", haz clic en Agregar destino y elige una de las opciones de destino.

10. En "Reglas de rama", seleccione Solicitar automáticamente Copilot code review.

11. De forma opcional, si quiere que Copilot revise todos los pushes nuevos de la solicitud de extracción, seleccione Revisar los pushes nuevos.

    Si esta opción no está seleccionada, Copilot solo revisará la solicitud de incorporación de cambios una vez.

12. Opcionalmente, si desea Copilot revisar las solicitudes de incorporación de cambios mientras siguen siendo borradores, seleccione revisar las solicitudes de incorporación de cambios del borrador.

    Esto puede ser una opción útil para detectar errores con antelación, antes de solicitar una revisión humana.

13. En la parte inferior de la página, haz clic en Crear.

Personalización Copilot code review

Puede configurar cómo Copilot code review completa las revisiones de código en el repositorio.

1. En GitHub, navegue hasta la página principal del repositorio.

2. Debajo del nombre del repositorio, haz clic en Settings. Si no puedes ver la pestaña "Configuración", selecciona el menú desplegable y, a continuación, haz clic en Configuración.

   

3. En la barra lateral, en "Código, planeamiento y automatización", Haga clic en Copilot y, a continuación, en Revisión de código.

4. Para elegir la profundidad de las revisiones de código Copilot, junto a la opción "Nivel de esfuerzo de revisión", seleccione el nivel de esfuerzo de las revisiones automáticas en este repositorio.

   • Lite: Revisión estándar.
   • Equilibrado: análisis más profundo de la lógica compleja, el código sensible a la seguridad y los cambios entre servicios.

   Las revisiones equilibradas usan más AI credits y pueden requerir ligeramente más GitHub Actions minutos. Consulte Sobre la revisión de código de GitHub Copilot.

5. Para elegir si Copilot puede aprobar solicitudes de incorporación de cambios en el repositorio, configure las opciones en "Aprobación automática".

   • Permitir que Copilot apruebe solicitudes de extracción: Activa esta opción para permitir que Copilot envíe revisiones de aprobación.

   • Permitir que las aprobaciones de Copilot cuenten para cumplir los requisitos de fusión: actívalo para que las aprobaciones de Copilot puedan cumplir los requisitos de aprobación de las pull requests.

   • Rutas de archivo: de forma opcional, limite qué solicitudes de extracción cuentan para cumplir los requisitos de fusión. Escriba un patrón glob por línea para contar las aprobaciones solo para las solicitudes de extracción en las que todos los archivos modificados coincidan con alguno de los patrones indicados. Deje en blanco para contar las aprobaciones de todos los archivos. Se admiten hasta 15 globs.

   Nota:

   Copilot las aprobaciones están en versión preliminar pública y están sujetas a cambios.

Configuración de la revisión automática de código para repositorios de una organización

Puede habilitar revisiones automáticas de código para repositorios de su organización y personalizar cómo se realizan las revisiones de código.

Habilitación de revisiones automáticas

1. En la esquina superior derecha de GitHub, haz clic en la foto del perfil y luego en Your organizations.

2. Seleccione una organización haciendo clic en ella.

3. Debajo del nombre de la organización, haz clic en Settings. Si no puedes ver la pestaña "Configuración", selecciona el menú desplegable y, a continuación, haz clic en Configuración.

   

4. En la barra lateral, en "Código, planeamiento y automatización", Haga clic en Repositorio y, a continuación, haga clic en Conjuntos de reglas.

5. Haga clic en Nuevo conjunto de reglas.

6. Haga clic en Nuevo conjunto de reglas de rama.

7. En «Nombre del conjunto de reglas», escribe un nombre para el conjunto de reglas.

8. Para activar el conjunto de reglas, en "Enforcement Status", selecciona Active.

9. En "Repositorios de destino", haz clic en Agregar destino y elige Incluir por patrón o Excluir por patrón.

10. Escriba un patrón que coincida con los nombres de repositorio que desea establecer como destino, por ejemplo, *feature para que coincidan con todos los repositorios con nombres que terminan en feature.

    Para obtener la sintaxis de coincidencia de patrones, consulte Creación de conjuntos de reglas para repositorios de la organización.

11. Haga clic en Agregar patrón de inclusión o en Agregar patrón de exclusión.

12. Repita el proceso para cualquier patrón adicional.

    Nota:

    Puedes agregar varios criterios de selección de destino al mismo conjunto de reglas. Los patrones de exclusión se aplican después de los patrones de inclusión. Por ejemplo, podrías incluir cualquier repositorio que coincida con el patrón *cat* y excluir específicamente un repositorio que coincida con el patrón not-a-cat.

13. En "Ramas de destino", haz clic en Agregar destino y elige una de las opciones de destino.

14. En "Reglas de rama", seleccione Solicitar automáticamente Copilot code review.

15. De forma opcional, si quiere que Copilot revise todos los pushes nuevos de la solicitud de extracción, seleccione Revisar los pushes nuevos.

    Si esta opción no está seleccionada, Copilot solo revisará la solicitud de incorporación de cambios una vez.

16. Opcionalmente, si desea Copilot revisar las solicitudes de incorporación de cambios mientras siguen siendo borradores, seleccione revisar las solicitudes de incorporación de cambios del borrador.

    Esto puede ser una opción útil para detectar errores con antelación, antes de solicitar una revisión humana.

17. En la parte inferior de la página, haz clic en Crear.

Personalización Copilot code review

Puede configurar cómo Copilot code review completa las revisiones de código en repositorios de su organización.

1. En la esquina superior derecha de GitHub, haz clic en la foto del perfil y luego en Your organizations.

2. Seleccione una organización haciendo clic en ella.

3. Debajo del nombre de la organización, haz clic en Settings. Si no puedes ver la pestaña "Configuración", selecciona el menú desplegable y, a continuación, haz clic en Configuración.

   

4. En la barra lateral, en "Código, planeamiento y automatización", Haga clic en Copilot y, a continuación, en Revisión de código.

5. Para elegir la profundidad de las revisiones de código Copilot, junto a "Nivel de esfuerzo de revisión", seleccione el nivel de esfuerzo predeterminado para las revisiones automáticas en los repositorios de su organización.

   • Lite: Revisión estándar.
   • Equilibrado: análisis más profundo de la lógica compleja, el código sensible a la seguridad y los cambios entre servicios.

   Las revisiones equilibradas usan más AI credits y pueden requerir ligeramente más GitHub Actions minutos. Consulte Sobre la revisión de código de GitHub Copilot.

6. Para elegir si Copilot puede aprobar solicitudes de extracción en sus repositorios, seleccione una opción en "Aprobaciones", junto a "Contar las aprobaciones de Copilot para los requisitos de combinación".

   • Habilitado globalmente: Copilot las aprobaciones pueden contar para cumplir los requisitos de fusión en todos los repositorios de la organización.

   • Permitir que los repositorios decidan: los administradores del repositorio pueden decidir esto en la configuración del repositorio.

   • Habilitar para los repositorios seleccionados: Copilot las aprobaciones solo pueden contar para los requisitos de fusión en los repositorios que selecciones. Si elige esta opción, asigne también los repositorios para los que desea habilitarlo.

   • Desactivado en toda la organización: Copilot las aprobaciones no pueden contabilizarse para cumplir los requisitos de fusión en ningún repositorio de la organización.

   Nota:

   Copilot las aprobaciones están en versión preliminar pública y están sujetas a cambios.

Configuración de la revisión automática de código para una empresa

Puede habilitar las revisiones automáticas de código para su empresa y personalizar cómo se realizan las revisiones de código.

Habilitación de revisiones automáticas

1. Cree un conjunto de reglas de rama de nivel empresarial. Consulte Imposición de la gobernanza del código en la empresa con conjuntos de reglas.
2. Seleccione las organizaciones y los repositorios donde Copilot code review debe ejecutarse automáticamente.
3. Habilite la directiva Solicitar automáticamente Copilot code review.
4. Opcionalmente, habilite las revisiones automáticas para las solicitudes de incorporación de cambios de borrador y después de cada inserción en una solicitud de incorporación de cambios.
5. Haga clic en Crear.

Personalización Copilot code review

Puede configurar cómo Copilot code review realiza revisiones de código para su empresa.

1. Vaya a su empresa. Por ejemplo, desde la página Empresas en GitHub.com.
2. En la parte superior de la página, haga clic en controles de IA.
3. Desplácese hacia abajo hasta "Agentes disponibles" y haga clic en Copilot code review.
4. Junto a "Copilot code review", seleccione una directiva.
5. A continuación, elija qué Copilot code review características habilitar para su empresa.
6. Para elegir si Copilot puede aprobar solicitudes de incorporación de cambios en las organizaciones, junto a "Permitir Copilot aprobar solicitudes de incorporación de cambios", seleccione una directiva.

   • Permitir que las organizaciones decidan: los propietarios de la organización pueden elegir si se habilitan Copilot las aprobaciones.

   • Habilitar para organizaciones seleccionadas: Copilot las aprobaciones solo están habilitadas para las organizaciones que seleccione.

   • Deshabilitado en todas partes: las organizaciones no pueden habilitar las aprobaciones Copilot. Este es el valor predeterminado.

   Nota:

   Copilot las aprobaciones están en versión preliminar pública y están sujetas a cambios.