Utiliser des automatisations dans l’application GitHub Copilot

À propos de automations

Automations vous permet d’enregistrer des tâches d’agent récurrentes et de les exécuter selon une planification ou à la demande. Par exemple, vous pouvez créer un automation qui traite chaque jour les nouveaux tickets ou vérifie chaque matin le statut de révision de vos pull requests ouvertes.

Vous pouvez également configurer des tâches périodiques au sein d’un projet pour prendre en charge un objectif continu. Consultez « Utilisation de projets dans l’application GitHub Copilot ».

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

• L’onglet Agents d’un dépôt sur GitHub, dans le volet Automations.
• L’onglet Automations de la fenêtre Agents dans VS Code.

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

Le GitHub Copilot app prend en charge deux types de automations:

• Local automations, qui s’exécute à partir de votre environnement local.
• Cloud automations, qui s’exécute dans un environnement cloud.

Ouvrez Automatisations dans la barre latérale pour afficher votre enregistrement automations. Chacun automation affiche son nom, sa planification, son dépôt associé et son état de dernière exécution.

Conditions préalables à l’utilisation du cloud automations

Pour utiliser le cloud automations, vérifiez que les paramètres suivants sont activés.

• 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 ».

Création d’un automation

Les sessions cloud automation, y compris les invites et les journaux de session, sont visibles par tous les utilisateurs disposant d’un accès en lecture au référentiel, même pour des automations personnels. N’incluez pas de secrets ou d’autres informations sensibles dans vos prompts.

1. Dans la barre latérale, cliquez sur Automations.
2. Cliquez sur Créer une automatisation dans le coin supérieur droit.

Création d’un cloud automation avec Copilot

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

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

1. Dans la liste déroulante sous la zone d’invite, choisissez le référentiel dans lequel vous souhaitez créer votre automation.

2. Dans la zone d’invite, décrivez ce pour quoi vous souhaitez que Copilot vous aide à automatiser dans votre référentiel.

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

   • Personnel : Vous seul pouvez voir le automation. AI credits vous sont facturés, et les actions effectuées sur GitHub utilisent votre identité.
   • Partagé : tout le monde ayant accès au dépôt 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 ».

4. Cliquez sur Démarrer une session.

Copilot vous posera des questions et vous aidera à configurer votre automation.

Création manuelle d’un automation

1. Cliquez sur Créer manuellement.

2. Entrez un nom pour le automation.

3. Si vous le souhaitez, activez l’exécution dans le cloud pour laisser l’exécution automation dans un environnement cloud, ce qui permet l’exécution automation même lorsque votre ordinateur est désactivé. Les déclencheurs disponibles diffèrent selon que vous l’exécutez en local ou dans le cloud.

4. Sélectionnez un déclencheur dans la liste déroulante. La sélection d’un déclencheur affiche des champs supplémentaires pour vous permettre de remplir.

   Pour les automations déclenchés par des issues ou des pull requests et en cours d’exécution dans le cloud, vous pouvez choisir :

   • Quelles ressources sur GitHub peuvent être mises à jour pendant l’exécution. Dans la liste déroulante Lorsqu’elle est déclenchée, cette automatisation peut modifier, choisissez N’importe quel élément de ce référentiel pour permettre à GitHub outils de créer et de mettre à jour n’importe quelle ressource dans le référentiel. Choisissez uniquement le problème qui a déclenché l’exécution 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 provenant de 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.
   • Indique si l’activité provenant de Copilot dans le cloud peut déclencher ceci automation : à partir de la liste déroulante Peut être déclenchée par, sélectionnez Uniquement les personnes pour ignorer les événements déclenchés par Copilot, y compris automations. Sélectionnez People and Copilot pour écouter tous les événements, y compris les événements déclenchés par Copilot.
   • Les utilisateurs disposant uniquement d’un accès en lecture au référentiel peuvent-ils 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 Exiger un accès en écriture pour le déclencheur pour écouter ces événements. Selon la configuration de votre dépôt, l’option Exiger un accès en écriture pour déclencher peut être verrouillée dans un état activé.

   Pour configurer plusieurs déclencheurs, cliquez sur Ajouter un autre déclencheur. Le automation s’exécute lorsque l’un de ses déclencheurs se produit.

5. Pour un nuage automation, sous Type, choisissez à qui appartient automation :

   • Personnel : Vous êtes le seul à pouvoir 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 ».

6. Pour un cloud automation, utilisez la liste déroulante Outils pour sélectionner les outils que Copilot peut utiliser, comme envoyer des modifications, mettre à jour les libellés des tickets ou créer une pull request. Vous pouvez également sélectionner des outils à partir de serveurs MCP configurés dans les paramètres MCP du référentiel. Un administrateur de référentiel doit d’abord configurer ces serveurs. Consultez « Configurer des serveurs MCP pour votre référentiel ». Sélectionnez uniquement les outils dont la tâche a besoin.

7. Dans la zone d’invite, décrivez la tâche que vous souhaitez voir Copilot effectuer chaque fois que automation s’exécute. Vous pouvez taper / pour utiliser une compétence disponible.

8. Si vous le souhaitez, pour un cloud automation, développez la section Limites de crédit IA directement sous la zone de prompt pour définir des limites sur le nombre de automation que le AI credits peut consommer. Consultez la définition des limites AI credits pour le cloud automations.

9. Utilisez les contrôles sous la zone d’invite pour sélectionner le modèle, l’effort de raisonnement et l’agent pour le automation.

10. Choisissez le référentiel ou le dossier local dans lequel s’exécutera le automation

11. Cliquez sur Créer pour enregistrer le automationfichier . Pour l’enregistrer et le tester immédiatement, ouvrez la liste déroulante en regard de Créer, puis cliquez sur Créer et exécuter.

Définition des AI credits limites pour le cloud automations

Pour contrôler les coûts, vous pouvez limiter la quantité de AI credits qu’un cloud automation peut consommer. Les limites ne sont pas disponibles en local automations.

Lorsque vous créez ou modifiez un cloud automation, développez la section limites de crédit IA directement sous la zone de prompt. Lorsque la section est repliée, elle indique si des limites sont définies.

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 automation et effacez la valeur.

Exécution à la demande d’une automation

Vous pouvez déclencher manuellement n’importe quelle automation enregistrée en cliquant sur le bouton de lecture de sa carte sur la page « Automatisations », sans attendre sa prochaine exécution programmée.

Vous pouvez également ouvrir automations directement dans l’application à l’aide de liens approfondis à partir de fichiers Markdown, d’outils tiers ou de scripts. Pour plus d’informations, consultez « Utiliser des liens directs pour ouvrir l’application GitHub Copilot ».