Configuring code review by GitHub Copilot

Set up Copilot to review pull requests.

En este artículo

Introduction

You can configure Copilot code review to review pull requests automatically. For an overview of automatic pull request reviews, see Sobre la revisión de código de GitHub Copilot.

Configuring automatic code review for your own pull requests

Nota:

This is only available if you are on the Copilot Pro, Copilot Pro+, or Copilot Max plans.

  1. En la esquina superior derecha de cualquier página, haz clic en la fotografía de perfil y luego en Copilot settings.

  2. Locate the Automatic Copilot code review option and click the dropdown button.

    Screenshot of the "Automatic Copilot code review" setting with the dropdown menu displayed.

  3. In the dropdown menu, select Enabled.

Configuring automatic code review for a repository

You can enable automatic code reviews for a repository and customize how code reviews are performed.

Enabling automatic reviews

  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.

    Captura de pantalla de un encabezado de repositorio en el que se muestran las pestañas. La pestaña "Configuración" está resaltada con un contorno naranja oscuro.

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

    Captura de pantalla de la barra lateral de la página "Configuración" de un repositorio. El submenú "Reglas" se expande y la opción "Conjuntos de reglas" tiene un contorno naranja.

  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. Under "Target branches," click Add target and choose one of the options—for example, Include default branch or Include all branches.

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

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

    Esto expande un conjunto de opciones subsidiarias.

    Captura de pantalla de la opción de conjunto de reglas de rama "Solicitar automáticamente Copilot code review".

  11. Opcionalmente, si deseas que Copilot revise todas las inserciones nuevas en la solicitud de incorporación de cambios, selecciona Revisar nuevas inserciones.

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

  12. Opcionalmente, si deseas que Copilot revise las solicitudes de incorporación de cambios mientras todavía son borradores, selecciona Revisar el borrador de solicitudes de incorporación de cambios.

    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.

Customizing Copilot code review

You can configure how Copilot code review completes code reviews in your repository.

  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.

    Captura de pantalla de un encabezado de repositorio en el que se muestran las pestañas. La pestaña "Configuración" está resaltada con un contorno naranja oscuro.

  3. En la barra lateral, en "Código, planeamiento y automatización", click Copilot, then Code review.

  4. To choose the depth of Copilot code reviews, next to "Review effort level," select the effort level for automatic reviews in this repository.

    • Lite: Standard review.
    • Balanced: Deeper analysis of complex logic, security-sensitive code, and cross-service changes.

    Balanced reviews use more AI credits, and may consume marginally more GitHub Actions minutes. See Sobre la revisión de código de GitHub Copilot.

  5. To choose whether Copilot can approve pull requests in your repository, configure the settings under "Auto-approval."

    • Allow Copilot to approve pull requests: Toggle on to let Copilot submit approving reviews.

    • Allow Copilot approvals to count toward merge requirements: Toggle on so Copilot approvals can satisfy pull request approval requirements.

    • File paths: Optionally, limit which pull requests count toward merge requirements. Enter one file glob per line to count approvals only on pull requests where every changed file matches one of the globs. Leave blank to count approvals for all files. Up to 15 globs are supported.

    Nota:

    Copilot approvals are in versión preliminar pública and subject to change.

Configuring automatic code review for repositories in an organization

You can enable automatic code reviews for repositories in your organization and customize how code reviews are performed.

Enabling automatic reviews

  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.

    Captura de pantalla de las pestañas en el perfil de una organización. La pestaña "Configuración" se destaca en naranja oscuro.

  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.

    Captura de pantalla de la página de configuración de una organización. En la barra lateral, aparece un vínculo etiquetado como "Conjuntos de reglas" con un contorno naranja.

  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. Under "Target repositories," click Add target and choose either Include by pattern or Exclude by pattern.

  10. Type a pattern that matches the repository names you want to target—for example, *feature to match all repositories with names ending in feature.

    For pattern-matching syntax, see Creación de conjuntos de reglas para repositorios de la organización.

  11. Click Add inclusion pattern or Add exclusion pattern.

  12. Repeat for any additional patterns.

    Nota:

    You can add multiple targeting criteria to the same ruleset. Exclusion patterns are applied after inclusion patterns. For example, you could include any repositories matching the pattern *cat*, and specifically exclude a repository matching the pattern 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", selecciona Solicitar automáticamente Copilot code review.

    Esto expande un conjunto de opciones subsidiarias.

    Captura de pantalla de la opción de conjunto de reglas de rama "Solicitar automáticamente Copilot code review".

  15. Opcionalmente, si deseas que Copilot revise todas las inserciones nuevas en la solicitud de incorporación de cambios, selecciona Revisar nuevas inserciones.

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

  16. Opcionalmente, si deseas que Copilot revise las solicitudes de incorporación de cambios mientras todavía son borradores, selecciona Revisar el borrador de solicitudes de incorporación de cambios.

    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.

Customizing Copilot code review

You can configure how Copilot code review completes code reviews in repositories in your organization.

  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.

    Captura de pantalla de las pestañas en el perfil de una organización. La pestaña "Configuración" se destaca en naranja oscuro.

  4. En la barra lateral, en "Código, planeamiento y automatización", click Copilot, then Code review.

  5. To choose the depth of Copilot code reviews, next to "Review effort level," select the default effort level for automatic reviews in repositories in your organization.

    • Lite: Standard review.
    • Balanced: Deeper analysis of complex logic, security-sensitive code, and cross-service changes.

    Balanced reviews use more AI credits, and may consume marginally more GitHub Actions minutes. See Sobre la revisión de código de GitHub Copilot.

  6. To choose whether Copilot can approve pull requests in your repositories, select an option under "Approvals," next to "Count Copilot approvals toward merge requirements."

    • Enabled everywhere: Copilot approvals can count toward merge requirements in every repository in the organization.

    • Let repositories decide: Repository admins can decide this in repository settings.

    • Enable for selected repositories: Copilot approvals can count toward merge requirements only in the repositories you select. If you choose this option, also assign the repositories you want to enable this for.

    • Disabled everywhere: Copilot approvals cannot count toward merge requirements in any repository in the organization.

    Nota:

    Copilot approvals are in versión preliminar pública and subject to change.

Configuring automatic code review for an enterprise

You can enable automatic code reviews for your enterprise and customize how code reviews are performed.

Enabling automatic reviews

  1. Create an enterprise-level branch ruleset. See Imposición de la gobernanza del código en la empresa con conjuntos de reglas.
  2. Target the organizations and repositories where Copilot code review should run automatically.
  3. Enable the Automatically request Copilot code review policy.
  4. Optionally, enable automatic reviews for draft pull requests and after each push to a pull request.
  5. Click Create.

Customizing Copilot code review

You can configure how Copilot code review completes code reviews for your enterprise.

  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. Scroll down to "Available Agents", then click Copilot code review.
  4. Next to "Copilot code review", select a policy.
  5. Then choose which Copilot code review features to enable for your enterprise.
  6. To choose whether Copilot can approve pull requests in your organizations, next to "Allow Copilot to approve pull requests," select a policy.

    • Let organizations decide: Organization owners can choose whether to enable Copilot approvals.

    • Enable for selected organizations: Copilot approvals are enabled only for the organizations you select.

    • Disabled everywhere: Organizations cannot enable Copilot approvals. This is the default.

    Nota:

    Copilot approvals are in versión preliminar pública and subject to change.