Configuring code review by GitHub Copilot

Set up Copilot to review pull requests.

Dans cet article

Introduction

You can configure Copilot code review to review pull requests automatically. For an overview of automatic pull request reviews, see À propos de la révision de code avec GitHub Copilot.

Configuring automatic code review for your own pull requests

Remarque

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

  1. Dans le coin supérieur droit de n’importe quelle page, cliquez sur votre photo de profil, puis sur Paramètres Copilot.

  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. Sur GitHub, accédez à la page principale du référentiel.

  2. Sous le nom de votre référentiel, cliquez sur Paramètres. Si vous ne voyez pas l’onglet « Paramètres », sélectionnez le menu déroulant , puis cliquez sur Paramètres.

    Capture d’écran d’un en-tête de dépôt montrant les onglets. L’onglet « Paramètres » est mis en évidence avec un encadré orange foncé.

  3. Dans la barre latérale gauche, sous « Code et automatisation », cliquez sur Règles, puis sur Ensembles de règles.

    Capture d’écran de la barre latérale de la page « Paramètres » d’un dépôt. Le sous-menu « Règles » est développé et l’option « Ensembles de règles » est encadrée en orange.

  4. Cliquez sur Nouveau jeu de données.

  5. Cliquez sur Nouvel ensemble de règles de branche.

  6. Sous « Nom de l’ensemble de règles », tapez un nom pour l’ensemble de règles.

  7. Pour activer l’ensemble de règles, sous « État de l’application », sélectionnez Actif.

  8. Under "Target branches," click Add target and choose one of the options—for example, Include default branch or Include all branches.

  9. Sous « Branches cibles », cliquez sur Ajouter une cible et choisissez l’une des options cibles.

  10. Sous « Règles de branche », sélectionnez Demander automatiquement Copilot code review.

    Un ensemble d’options subsidiaires est alors développé.

    Capture d’écran de l’option d’ensemble de règles de branche « Demander automatiquement Copilot code review ».

  11. Si vous souhaitez que Copilot passe en revue tous les nouveaux envois vers la demande de tirage, sélectionnez Passer en revue les nouveaux envois.

    Si cette option n’est pas sélectionnée, Copilot ne passera en revue la demande de tirage qu’une seule fois.

  12. Si vous souhaitez que Copilot passe en revue les demandes de tirage encore à l’état de brouillon, sélectionnez Passer en revue les demandes de tirage brouillon.

    Cette option peut être utile pour détecter les erreurs à un stade précoce, avant de demander une révision humaine.

  13. En bas de la page, cliquez sur Créer.

Customizing Copilot code review

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

  1. Sur GitHub, accédez à la page principale du référentiel.

  2. Sous le nom de votre référentiel, cliquez sur Paramètres. Si vous ne voyez pas l’onglet « Paramètres », sélectionnez le menu déroulant , puis cliquez sur Paramètres.

    Capture d’écran d’un en-tête de dépôt montrant les onglets. L’onglet « Paramètres » est mis en évidence avec un encadré orange foncé.

  3. Dans la barre latérale, sous « Code, planification et automatisation », 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 À propos de la révision de code avec 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.

    Remarque

    Copilot approvals are in préversion publique 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. Dans le coin supérieur droit de GitHub, cliquez sur votre photo de profil, puis sur Vos organisations.

  2. Sélectionnez une organisation en cliquant dessus.

  3. Sous le nom de votre organisation, cliquez sur Settings. Si vous ne voyez pas l’onglet « Paramètres », sélectionnez le menu déroulant , puis cliquez sur Paramètres.

    Capture d’écran des onglets dans le profil d’une organisation. L’onglet « Paramètres » est présenté en orange foncé.

  4. Dans la barre latérale, sous « Code, planification et automatisation », cliquez sur Référentiel, puis sur Ensembles de règles.

    Capture d’écran de la page des paramètres d’une organisation. Dans la barre latérale, un lien intitulé « Ensembles de règles » est encadré en orange.

  5. Cliquez sur Nouveau jeu de données.

  6. Cliquez sur Nouvel ensemble de règles de branche.

  7. Sous « Nom de l’ensemble de règles », tapez un nom pour l’ensemble de règles.

  8. Pour activer l’ensemble de règles, sous « État de l’application », sélectionnez Actif.

  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 Création d'ensembles de règles pour les dépôts de votre organisation.

  11. Click Add inclusion pattern or Add exclusion pattern.

  12. Repeat for any additional patterns.

    Remarque

    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. Sous « Branches cibles », cliquez sur Ajouter une cible et choisissez l’une des options cibles.

  14. Sous « Règles de branche », sélectionnez Demander automatiquement Copilot code review.

    Un ensemble d’options subsidiaires est alors développé.

    Capture d’écran de l’option d’ensemble de règles de branche « Demander automatiquement Copilot code review ».

  15. Si vous souhaitez que Copilot passe en revue tous les nouveaux envois vers la demande de tirage, sélectionnez Passer en revue les nouveaux envois.

    Si cette option n’est pas sélectionnée, Copilot ne passera en revue la demande de tirage qu’une seule fois.

  16. Si vous souhaitez que Copilot passe en revue les demandes de tirage encore à l’état de brouillon, sélectionnez Passer en revue les demandes de tirage brouillon.

    Cette option peut être utile pour détecter les erreurs à un stade précoce, avant de demander une révision humaine.

  17. En bas de la page, cliquez sur Créer.

Customizing Copilot code review

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

  1. Dans le coin supérieur droit de GitHub, cliquez sur votre photo de profil, puis sur Vos organisations.

  2. Sélectionnez une organisation en cliquant dessus.

  3. Sous le nom de votre organisation, cliquez sur Settings. Si vous ne voyez pas l’onglet « Paramètres », sélectionnez le menu déroulant , puis cliquez sur Paramètres.

    Capture d’écran des onglets dans le profil d’une organisation. L’onglet « Paramètres » est présenté en orange foncé.

  4. Dans la barre latérale, sous « Code, planification et automatisation », 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 À propos de la révision de code avec 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.

    Remarque

    Copilot approvals are in préversion publique 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 Application de la gouvernance du code dans votre entreprise avec des ensembles de règles.
  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. Accédez à votre entreprise. Par exemple, depuis la page Entreprises sur GitHub.com.
  2. En haut de la page, cliquez sur AI controls.
  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.

    Remarque

    Copilot approvals are in préversion publique and subject to change.