Préparation des pull requests à fusionner avec Agent Merge

Laissez Copilot surveiller vos pull requests et corriger les workflows ayant échoué ainsi que les conflits de fusion, tandis que vous vous concentrez sur d’autres tâches.

Dans cet article

À propos de Agent Merge

Agent Merge fait partie de Copilot in the cloud. Il surveille une demande de fusion pour les blocages que vous choisissez et démarre automatiquement quand il en trouve un. Vous pouvez autoriser Copilot à corriger les flux de travail GitHub Actions ayant échoué, à résoudre les conflits de fusion, ou les deux.

Agent Merge aide à préparer une pull request prête à être fusionnée et à le rester. Il ne remplace pas votre examen des modifications ou les exigences de fusion du dépôt.

Conditions préalables et limitations

Pour utiliser Agent Merge, vous devez avoir accès à Copilot in the cloud via un abonnement Copilot payant. Si votre organisation ou entreprise vous fournit l’accès à Copilot, ses stratégies doivent vous permettre d’utiliser Copilot in the cloud.

La stratégie Activer les automatisationsCopilot du dépôt doit également être activée.

Agent Merge ne prend pas en charge les pull requests empilées ni les pull requests ouvertes à partir d’un fork.

Activation de Agent Merge pour une pull request

  1. Sur GitHub, ouvrez la pull request que vous souhaitez Copilot surveiller.

  2. Dans la zone de fusion de la pull request, cliquez sur Surveiller et corriger.

  3. Choisissez les actions que vous souhaitez voir Copilot effectuer :

    • Correction des flux de travail Actions ayant échoué : permettre à Copilot d’examiner et de corriger les flux de travail GitHub Actions défaillants.
    • Résoudre les conflits de fusion : autorisez Copilot à résoudre les conflits entre la branche de la pull request et sa branche de base.

Quand l’un des problèmes bloquants que vous avez sélectionnés s’affiche, Copilot commence à travailler dans un environnement de développement cloud pour le corriger.

À la suite du travail de Agent Merge

À mesure que Copilot surveille votre pull request, vous verrez des mises à jour dans la section Agent Merge de l’encadré de fusion.

Lorsque Copilot commence à fonctionner, une mise à jour s’affiche en tant qu’événement de chronologie de pull request. La mise à jour explique pourquoi elle s’est déclenchée, par exemple un flux de travail ayant échoué ou un conflit de fusion.

Passez en revue les modifications effectuées par Copilot et vérifiez les résultats du flux de travail avant la fusion. Agent Merge ne supprime pas la nécessité d’un examen humain.

Activer Agent Merge automatiquement

Vous pouvez activer Agent Merge par défaut pour les pull requests que vous créez.

  1. Dans le coin supérieur droit de n’importe quelle page sur GitHub, cliquez sur votre photo de profil, puis sur Paramètres.
  2. Dans la barre latérale, sous Copilot, cliquez sur Cloud.
  3. Sélectionnez Activer Agent Merge automatiquement pour les pull requests que je crée.
  4. Utilisez les commutateurs Corriger les workflows Actions ayant échoué et Résoudre les conflits de fusion pour choisir les actions que Copilot peut effectuer lorsque Agent Merge est activé automatiquement pour vos pull requests. Vous pouvez activer l’une ou l’autre des actions, ou les deux.

Désactivation de Agent Merge pour une pull request

Vous pouvez désactiver Agent Merge pour une pull request si vous l’avez activée ou si vous avez accès en écriture au référentiel.

  1. Sur GitHub, ouvrez la pull request.
  2. Dans la zone de fusion située en bas de la pull request, cliquez sur Désattribuer Copilot.

Utilisation Agent Merge avec la fusion automatique

Agent Merge corrige les blocages, tandis que la fusion automatique effectue la fusion d’une pull request une fois que toutes les révisions requises et les vérifications d’état ont réussi. Activer Agent Merge n’active pas la fusion automatique.

Vous pouvez combiner les deux pour permettre à Copilot de préparer la pull request et de la garder prête, tandis que GitHub la fusionne dès que toutes les exigences sont remplies. Pour obtenir des conseils d’installation, consultez Fusion automatique d'une pull request.

Personnaliser l’environnement de Agent Merge

Bien que Agent Merge fasse partie de Copilot in the cloud, ses correctifs s’exécutent dans un environnement de développement basé sur GitHub Actions, et non dans un bac à sable cloud. Il utilise les mêmes personnalisations de référentiel que les autres Copilot tâches qui s’exécutent GitHub Actions, notamment :

Utilisation et facturation

Les AI credits utilisés par Agent Merge sont facturés à l’utilisateur qui l’active pour la pull request, et non pas nécessairement à l’auteur de la pull request. Pour plus d’informations sur l’utilisation et les quotas, consultez GitHub Copilot facturation et utilisation.