Overview
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 définissez votre invite une fois, sélectionnez vos déclencheurs et décidez quels outils Copilot doit être en mesure d’utiliser. Copilot exécute votre automatisation automatiquement chaque fois que le déclencheur de automation se déclenche.
Par exemple, vous pouvez utiliser automations pour :
- Reproduire les bogues : tentez de reproduire un bogue signalé lorsqu’un problème est ouvert.
- Prenez des captures d’écran pour examen : prenez des captures d’écran des modifications et joignez-les à une pull request lorsqu’elle est marquée comme prête pour examen.
- Examiner les incidents de production : commencez à examiner un incident lorsque votre outil de surveillance le détecte.
Vous pouvez également créer et gérer automations à partir de :
- Onglet Agents d’un référentiel sur GitHub
- L’onglet Automations dans GitHub Copilot app
- La fenêtre Agents dans VS Code
- L’API de l’REST
Lorsque vous créez un automation, vous définissez :
- Nom permettant d’identifier le automation.
- Un type, personnel ou partagé, qui détermine qui peut voir et modifier le automation, qui est facturé et quelle identité il utilise. Voir Éléments personnels et partagés automations.
- Invite décrivant la tâche que vous souhaitez Copilot effectuer.
- automation qui déterminent le moment où la **** s’exécute.
- Les outilsCopilot peuvent utiliser, ce qui détermine les actions qu’il peut effectuer dans votre dépôt.
- Si vous le souhaitez, utilisez le modèle et le niveauCopilot de raisonnement.
- AI credits Éventuellement, des limites qui contrôlent le nombre de AI credits que le automation peut consommer.
Vous pouvez ajouter automations à automation groups qui partagent un contexte et peuvent se suggérer des améliorations en fonction des résultats.
Pour obtenir des instructions sur la création et la gestion automations, consultez Création d’automatisations avec Copilot agent cloud.
Disponibilité et autorisations
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.
Tout utilisateur disposant d’un accès en écriture à un référentiel peut créer automations dans ce référentiel.
Vous pouvez créer et gérer automations à partir de :
- L’onglet Agents d’un dépôt sur GitHub, dans le volet Automations.
- Onglet Automations dans le GitHub Copilot app.
- L’onglet Automations de la fenêtre Agents dans VS Code.
Cloud VS Code dans automations nécessite la version 1.144 ou ultérieure et que le paramètre chat.automations.cloud.enabled soit activé.
Personnels et partagés automations
Lorsque vous créez un automation, vous choisissez son type, que vous ne pouvez pas modifier ultérieurement.
- Les agents personnels automations sont utiles pour automatiser votre travail, comme la préparation de vos mises à jour pour un stand-up.
- Partagez automations et permettez à votre équipe de créer et gérer automations ensemble, pour automatiser les flux de travail pour l’ensemble de l’équipe.
| Personnel | Shared | |
|---|---|---|
| Qui peut voir automation | Vous uniquement | Tout le monde disposant d’un accès en lecture au référentiel |
| Qui peut voir les exécutions de automation | Tout le monde disposant d’un accès en lecture au référentiel | Tout le monde disposant d’un accès en lecture au référentiel |
| Qui peut modifier automation | Seulement vous | Tout le monde disposant d’un accès en écriture au référentiel |
| À qui est facturé AI credits | Vous | Organisation ou utilisateur propriétaire du référentiel |
| Identité utilisée pour les actions sur GitHub | Votre identité | identité de Copilot |
Étant donné qu’un partage automation appartient au référentiel plutôt qu’à la personne qui l’a créé, il continue de fonctionner si cette personne quitte l’équipe ou perd l’accès au référentiel.
Pour qu’un automation partagé s’exécute dans un référentiel appartenant à l’organisation, l’organisation doit autoriser l’utilisation de Copilot cloud agent facturée à l’organisation. Un administrateur peut l’activer avec la stratégie « Autoriser l’utilisation de Copilot cloud agent facturé à l’organisation ».
Triggers
Une automation s’exécute lorsqu’un de ses déclencheurs est activé. Un vaste éventail de déclencheurs est disponible, notamment :
- Selon une planification : le automation s’exécute à intervalles réguliers — toutes les heures, tous les jours ou toutes les semaines.
- Lorsqu’un ticket est créé : le automation s’exécute chaque fois qu’un ticket est ouvert dans le dépôt.
- Lorsqu’une pull request est ouverte : le automation s’exécute chaque fois qu’une pull request est ouverte dans le dépôt.
- Lorsqu’une pull request est synchronisée : le automation s’exécute chaque fois que de nouveaux commits sont ajoutés à une pull request dans le dépôt.
Vous pouvez éventuellement configurer des filtres pour les déclencheurs basés sur des événements, par exemple :
- Pour le moment où un problème est créé, ajoutez un filtre de requête de recherche.
- Quand une demande de tirage est ouverte et qu’une demande de tirage est synchronisée, ajoutez un filtre de requête de recherche et un filtre pour les fichiers modifiés dans la demande de tirage.
Pour réduire le risque d’injection de prompt, automations ignorer GitHub les événements déclenchés par les utilisateurs qui n’ont pas d’accès en écriture au référentiel par défaut. Cela permet d’empêcher les utilisateurs non approuvés d’amener Copilot à agir, par exemple lorsqu’un contributeur externe ouvre un problème. Vous pouvez choisir d’autoriser ces événements si nécessaire. Pour plus d’informations, consultez Sécurité et sécurité.
Tous les automations peuvent être déclenchés via l’API, ce qui vous permet de connecter automations à des systèmes et outils externes. Lorsque vous démarrez un automation via l’API, vous pouvez inclure un contexte supplémentaire qui est passé au prompt.
Outils et actions
Les outils que vous sélectionnez lorsque vous créez un automation déterminent ce que Copilot peut faire lorsque le automation s’exécute.
Par exemple, vous pouvez autoriser Copilot à envoyer des modifications, à mettre à jour les libellés des tickets ou à créer une pull request.
Vous pouvez choisir parmi deux types d’outils :
-
GitHub outils, qui permettent Copilot d’utiliser votre référentiel sur GitHub. Par exemple, les outils GitHub permettent Copilot :
- Téléverser des pièces jointes
- Masquer et réafficher les commentaires et les avis
- Ajouter et supprimer des réactions
- Lire les discussions et leurs commentaires, et commenter les discussions
-
Outils à partir de serveurs MCP, qui permettent Copilot de travailler avec des systèmes externes. Un automation peut utiliser des outils à partir des serveurs MCP configurés dans les paramètres MCP du référentiel. Vous choisissez les outils de chaque serveur que le automation peut utiliser. Consultez « Configurer des serveurs MCP pour votre référentiel ».
La sélection d’outils est la façon principale de contrôler l’étendue d’un automation. Accordez uniquement les outils dont la tâche a besoin, de sorte que vous Copilot ne puissiez pas effectuer d’actions que vous n’avez pas prévues.
Vous pouvez sélectionner manuellement les outils que vous souhaitez activer, ou vous pouvez utiliser le bouton GitHub sur **** pour que Copilot suggère des outils en fonction de votre invite.
GitHub les outils peuvent uniquement effectuer des actions dans l’unique référentiel auquel le automation est limité. Les outils des serveurs MCP ne sont pas limités à ce référentiel : ils peuvent accéder à tout ce que la configuration et les identifiants du serveur autorisent, ce qui peut inclure d’autres référentiels et systèmes externes. Passez en revue à quoi chaque serveur MCP peut accéder avant de sélectionner ses outils.
Configuration héritée du référentiel
Automations utilisent la configuration Copilot cloud agent pour le dépôt auquel ils s’appliquent, notamment :
- Instructions personnalisées. Consultez « Ajout d’instructions personnalisées de référentiel pour GitHub Copilot ».
- Compétences de l’agent. Consultez « Ajout des compétences des agents pour GitHub Copilot ».
- Règles de pare-feu. Consultez « Personnalisation ou désactivation du pare-feu pour GitHub Copilot ».
- Secrets et variables. Consultez « Configurer des secrets et des variables pour Copilot agent cloud ».
Automations sont stockés séparément du contenu de votre référentiel. Ils ne font pas l’objet de commits dans Git, ils ne sont donc pas versionnés avec votre code ni gérés via des pull requests.
Billing
Chaque fois qu’une automation exécution est exécutée, elle démarre une Copilot cloud agent session qui utilise GitHub AI Credits et GitHub Actions minutes.
Pour un usage personnel automation, l’utilisation de AI credits est facturée à l’utilisateur qui a créé le automation.
Pour un automation partagé, l’utilisation de AI credits est facturée à l’organisation propriétaire du référentiel ou à l’abonnement Copilot du propriétaire du référentiel si un compte personnel possède le référentiel. Pour plus d’informations, consultez « Licences GitHub Copilot » et « Facturation des actions GitHub ».
GitHub Actions les minutes sont facturées séparément au propriétaire du référentiel.
Contrôle des coûts avec des limites AI credits
Vous pouvez définir des limites sur le nombre AI credits qu’un automation peut consommer. Cela vous permet d’automatiser le travail récurrent tout en gardant le contrôle de votre utilisation.
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.
Vous pouvez définir des limites lorsque vous créez ou mettez à jour un automation. Consultez « Création d’automatisations avec Copilot agent cloud ».
Améliorations proposées
Automations peut proposer des améliorations à ses propres outils, déclencheurs et prompts, ainsi qu’à ceux d’autres automations.
Automations peut suggérer des améliorations lorsqu’il rencontre des problèmes pendant le travail, comme les outils manquants.
Lorsque vous créez automations avec Copilot, Copilot peut vous aider à créer des automation groups auto-améliorants où certains automations travaillent et d’autres évaluent les résultats, en proposant continuellement des améliorations.
Lorsqu’un(e) automation comporte une amélioration proposée, vous recevrez une notification et verrez la proposition lors de l’affichage du automation.
Vous verrez une description de l’amélioration proposée et les modifications à appliquer au automation group. Vous pouvez décider s’il faut appliquer l’amélioration proposée ou la rejeter.
Sécurité et sécurité
Automations s’exécutent Copilot sans qu’une personne déclenche chaque tâche, de sorte qu’ils comportent des risques supplémentaires. GitHub fournit des protections intégrées pour aider à atténuer ces risques.
- Attribution.
- Les actions effectuées GitHub par un élément partagé automation sont attribuées à Copilot. Si votre référentiel nécessite au moins une approbation de pull request, une approbation supplémentaire est requise par défaut pour les pull requests créées par un automation partagé. Les administrateurs peuvent désactiver cette exigence supplémentaire dans les ensembles de règles, mais pas dans les règles de protection des branches.
- Les actions effectuées par un automation personnel sont attribuées à l’utilisateur qui a créé le automation. Comme pour les pull requests qu’un utilisateur crée lui-même, il ne peut pas les approuver, ce qui préserve les contrôles de révision prévus.
- Outils de moindre privilège. Vous choisissez exactement les outils qu’une application automation peut utiliser. Vous pouvez donc la limiter uniquement aux actions dont la tâche a besoin.
- Entrée non approuvée. Par défaut, automations ignore les événements déclenchés par des utilisateurs ne disposant pas d’un accès en écriture au dépôt, afin de réduire le risque d’injection de prompts par des utilisateurs non fiables.
- Exécutions de flux de travail. Par défaut, comme pour tous les Copilot cloud agent travaux, GitHub Actions les flux de travail ne s’exécutent pas sur une pull request tant qu’un utilisateur disposant d’un accès en écriture ne les approuve pas. Cela atténue le risque qu’une pull request ouverte par un automation déclenche automatiquement des flux de travail.
- Exécutions en transparence. Les Copilot cloud agent sessions démarrées par n’importe quel automation, personnel ou partagé, sont visibles par tous les utilisateurs disposant d’un accès en lecture au référentiel. Toute personne pouvant voir ces sessions peut voir l’instruction, les journaux de session, ainsi que les demandes de fusion ou autres modifications que Copilot crée.
Pour plus d’informations sur la façon dont GitHub atténue les risques de Copilot cloud agent, consultez Risques et atténuations pour l’agent cloud GitHub Copilot.
Pour en savoir plus
- Création d’automatisations avec Copilot agent cloud
- GitHub Copilot sur GitHub.com et GitHub Mobile
- Pour savoir comment stocker votre automatisation en tant que code, examinez-la par le biais de demandes d’extraction ou exécutez-la avec un autre agent de codage, consultez Flux de travail GitHub pilotés par des agents