Création d’automatisations avec Copilot agent cloud

Présentation

Avec automations, vous pouvez configurer Copilot cloud agent pour qu’il s’exécute automatiquement, soit selon une planification, en réponse à un événement dans un référentiel, soit déclenché via l’API. Automations peut effectuer des actions dans le référentiel dans lequel il est configuré, comme ouvrir une pull request ou étiqueter un ticket.

Vous pouvez créer et gérer automations à partir de l’onglet Agents d’un référentiel sur GitHub.

Vous pouvez également créer et gérer automations à partir de :

• L’onglet Automations dans GitHub Copilot app
• La fenêtre Agents dans VS Code
• L’API de l’REST

Pour obtenir une vue d’ensemble des automationsdéclencheurs, outils, visibilité et sécurité, consultez Automatisations Copilot.

Prerequisites

Pour automations être disponible dans un référentiel, toutes les valeurs suivantes doivent être remplies :

• Le référentiel doit être privé ou interne. Automations ne sont pas disponibles dans les dépôts publics.
• Copilot cloud agent doit être activé pour le référentiel. Si vous avez Copilot Business ou Copilot Enterprise, un administrateur doit activer la Copilot cloud agent stratégie. Consultez « Gestion des GitHub Copilot dans le cloud pour votre entreprise ou organisation ».
• L’organisation doit autoriser les deux Copilot cloud agent et automations dans le référentiel (les deux sont activées par défaut). Consultez « Gestion des GitHub Copilot dans le cloud pour votre organisation ».

Automations sont disponibles avec les offres GitHub Copilot Pro, GitHub Copilot Pro+, GitHub Copilot Max, GitHub Copilot Business et GitHub Copilot Enterprise.

Activation du cloud automations dans VS Code

Pour utiliser le cloud automations à partir de VS Code, remplissez les prérequis du dépôt ci-dessus, puis :

1. Mise à jour vers VS Code la version 1.144 ou ultérieure.
2. Dans l’éditeur Paramètres, activez chat.automations.cloud.enabled.
3. Ouvrez la fenêtre Agents , puis sélectionnez l’onglet Automations .

Pour obtenir des instructions de création et de gestion, consultez Créer et gérer des automatisations d’agent dans la VS Code documentation.

Création d’un automation

1. Sur GitHub, accédez à la page principale du référentiel.
2. Sous le nom de votre référentiel, cliquez sur Agents.
3. Dans la barre latérale, cliquez sur Automations.
4. Cliquez sur Créer automation.
5. Cliquez sur Créer avec l’agentCopilot pour créer votre automations, ou Créer manuellement pour configurer automations avec un formulaire.

Création d’un automation avec Copilot

Une fois que vous avez cliqué sur Créer avec l’agent, une fenêtre de conversation s’affiche et Copilot vous demande ce que vous souhaitez automatiser.

Vous pouvez utiliser Copilot pour concevoir votre automation, configurer les déclencheurs, les outils et l’invite.

Copilot peut même vous aider à créer des groupes d’auto-amélioration qui apprennent à partir des résultats de automations et se suggèrent des améliorations.

Création manuelle d’un automation

1. Entrez un nom pour le automation.

2. Sous Type, choisissez le type de automation que vous souhaitez créer :

   • Personnel: Vous seul pouvez voir le automation. AI credits sont facturés à vous et les actions effectuées sur GitHub utilisent votre identité.
   • Partagé : tout le monde ayant accès au référentiel peut voir le automation. AI credits sont facturés à l’organisation ou à l’utilisateur propriétaire du référentiel, et les actions effectuées sur GitHub utilisent l’identité de Copilot.

   Vous ne pouvez pas modifier le type après avoir créé le automation. Consultez « Automatisations Copilot ».

3. Sélectionnez un ou plusieurs automation qui déterminent quand le **** s’exécute. Vous pouvez facultativement configurer des filtres pour les déclencheurs afin de contrôler quand ils se déclenchent.

   Pour les issues et les déclencheurs de pull request, vous pouvez choisir :

   • Quelles ressources sur GitHub peuvent être mises à jour pendant l’exécution ? Dans la liste déroulante Ce que les outils configurés peuvent modifier, choisissez N’importe quel élément de ce référentiel pour permettre aux GitHub outils de créer et de mettre à jour n’importe quelle ressource dans le référentiel. Choisissez Seulement ce problème pour limiter les écritures de ces outils au problème ou à la pull request qui a déclenché l’exécution et à toutes les ressources créées pendant l’exécution. Ce paramètre ne limite pas les outils des serveurs MCP, qui peuvent accéder aux ressources autorisées par leur configuration de serveur et leurs informations d’identification. Selon la configuration de votre référentiel, l’option Tout dans ce référentiel peut ne pas être disponible.
   • Si l’activité de Copilot dans le cloud peut déclencher ceci automation : dans la liste déroulante Peut être déclenchée par, sélectionnez Tout le monde sauf Copilot dans le cloud pour ignorer les événements déclenchés par Copilot, y compris automations. Sélectionnez N’importe lequel pour écouter tous les événements, y compris les événements déclenchés par Copilot.
   • Indique si les utilisateurs disposant uniquement d’un accès en lecture au référentiel peuvent déclencher ceci automation : par défaut, automations ignore l’activité des utilisateurs qui n’ont pas accès en écriture au référentiel. Décochez la case Ignorer les événements déclenchés par les utilisateurs sans accès en écriture à cette zone de référentiel pour écouter ces événements. Selon la configuration de votre référentiel, l’option Ignorer les événements déclenchés par les utilisateurs sans accès en écriture à ce référentiel peut être verrouillée dans un état activé.

4. Dans le champ d’invite, décrivez la tâche que vous souhaitez voir Copilot effectuer chaque fois que automation s’exécute.

   Par exemple : Label this issue as a bug, an enhancement, or other, based on its content.

5. Si vous le souhaitez, sélectionnez le modèle et le niveau de raisonnement que Copilot utilisera. Consultez « Modification du modèle IA pour GitHub Copilot agent cloud ».

6. Sélectionnez les outilsCopilot pouvant être utilisés lorsque automation s’exécute, par exemple pour envoyer des modifications, mettre à jour les étiquettes des tickets ou créer une pull request.

   Vous pouvez sélectionner GitHub outils, et des outils à partir de tous les serveurs MCP configurés dans les paramètres MCP du référentiel. Pour rendre les outils d’un système externe disponibles, un administrateur de référentiel doit d’abord configurer son serveur MCP pour le référentiel. Consultez « Configurer des serveurs MCP pour votre référentiel ».

   Sélectionnez uniquement les outils dont la tâche a besoin. Les outils que vous sélectionnez contrôlent les actions Copilot qui peuvent être effectuées dans votre référentiel. Si vous le souhaitez, vous pouvez utiliser le bouton Suggérer des outils pour demander Copilot à suggérer des outils en fonction de votre invite. Consultez « Automatisations Copilot ».

7. Si vous le souhaitez, sous Limites de crédits IA, définissez des limites sur la quantité de AI credits que le automation peut consommer. Consultez Définir des limitesAI credits.

8. Enregistrez-le automation en cliquant sur Créer une automatisation.

Configuration des limites AI credits

Chaque fois qu’une exécution automation s’exécute, elle consomme AI credits, qui vous sont facturés pour un automation personnel, ou au propriétaire du référentiel pour un automation partagé. Pour contrôler les coûts, vous pouvez définir des limites dans la section limites de crédit IA lorsque vous créez ou modifiez un automation.

Vous pouvez définir les limites facultatives suivantes, dans AI credits. Laissez une limite vide si vous ne souhaitez pas la définir.

• Par exécution : arrête une exécution dès qu’elle atteint la limite. Le minimum est de 30 AI credits.
• Quotidien : empêche les nouvelles exécutions de démarrer une fois la limite atteinte. Réinitialise chaque jour à 00:00 UTC.
• Hebdomadaire : empêche les nouvelles exécutions de commencer une fois la limite atteinte. Réinitialise tous les lundis à 00h00 UTC.
• Mensuel : empêche les nouvelles exécutions de commencer une fois la limite atteinte. Se réinitialise le premier jour de chaque mois à 00:00 UTC.

Les limites quotidiennes, hebdomadaires et mensuelles n’arrêtent pas une exécution déjà en cours. Pour limiter le coût de chaque exécution individuelle, définissez une limite par exécution.

Pour supprimer une limite, modifiez le automation et effacez la valeur.

Test d’un automation

Vous pouvez exécuter un automation immédiatement, sans attendre que son déclencheur s’active, pour vérifier qu’il se comporte comme prévu.

1. Ouvrez le automation que vous souhaitez tester dans le volet Automations.

2. Cliquez sur le bouton Run.

3. Dans la liste déroulante Déclencheur , sélectionnez le déclencheur que vous souhaitez simuler.

4. Si vous avez sélectionné le déclencheur manuel , entrez éventuellement Le contexte qui sera inclus dans l’invite de l’agent. Vous pouvez l’utiliser pour simuler le automation déclenchement via l’API.

   Si vous avez sélectionné un autre déclencheur, renseignez URL de la ressource avec la ressource appropriée, par exemple l’URL du problème qui a été ouvert ou le commentaire de pull request créé.

5. Cliquez sur Exécuter maintenant.

Copilot démarre une session Copilot cloud agent et exécute l’invite de automation avec les outils que vous avez sélectionnés. Vous pouvez ouvrir la session pour suivre sa progression et passer en revue les modifications qu’elle apporte.

Gérer votre Automations

Vos automations personnels sont privés et n’appartiennent qu’à vous. Les automations éléments partagés sont visibles par tous les utilisateurs disposant d’un accès en lecture au dépôt, et toute personne disposant d’un accès en écriture peut les modifier.

Les sessions démarrées à partir de n’importe quel automation sont visibles par tous les utilisateurs disposant d’un accès en lecture au référentiel.

Dans le volet Automations d’un dépôt, vous pouvez :

• Affichez vos données personnelles automations et les données automations partagées du dépôt, les sessions démarrées et les AI credits consommés.
• Modifiez un automation pour changer son nom, l’invite, les déclencheurs, les outils, le modèle, l’effort de raisonnement ou les limites de AI credits, puis suivez l’historique des révisions du automation.
• Passez en revue les améliorations proposées pour les outils, déclencheurs ou prompt d’un automation, proposés par lui-même automation ou d’autres automations.
• Désactivez une automation option pour l’arrêter en cours d’exécution ou réactivez-la ultérieurement.
• Supprimez un élément automation dont vous n’avez plus besoin.

Pour afficher l’ensemble de vos automations dans tous les référentiels et accéder à la gestion de chacun, utilisez la vue Automations au niveau de l’utilisateur.

Lectures complémentaires

• Automatisations Copilot
• Démarrage des sessions GitHub Copilot
• Risques et atténuations pour l’agent cloud GitHub Copilot