Une automatisation se lance sans qu'on la demande à chaque fois. Elle s'exécute selon un calendrier ou lorsqu'un événement se produit : l'ouverture d'un pull request, la création d'un ticket, un échec de vérification ou de déploiement.
Chaque automatisation est répertoriée dans l'Usine sous l'onglet Automatisations, avec les déclencheurs et les actions associées. Créez-en une dans Nouveau travail : sélectionnez « Automatisation », puis indiquez quand elle s'exécutera et ce qu'elle fera, en vos propres mots.
- PlanificationHeure
- Automatisation d'événementsUn événement se produit.
Une tâche ordinaire
Spécification, plan, développement, vérification, revue. Utilise un emplacement d'agent ; attribuez-lui une priorité plus faible.
P2P3Un pull request
Il ne peut pas fusionner lui-même ni valider dans votre branche de base.
Vous approuvez
Deux types de déclencheurs
| Déclencheur | Exécutions | Exemple |
|---|---|---|
| Un calendrier | Toutes les quelques heures, ou tous les jours, semaines ou mois | Demandez à Sentry de vous signaler les nouvelles erreurs toutes les heures et créez un ticket pour chacune d'entre elles. |
| Un événement se produit | Lorsque GitHub ou Coroid envoie l'événement | Lorsqu'une tâche échoue, identifiez la cause et créez un ticket pour la corriger. |
Utilisez un calendrier lorsque le déclencheur est lié au temps, ou lorsque la ressource à surveiller se trouve dans un autre système qui n'envoie pas d'événements Coroid, comme Sentry ou Jira. Le calendrier interroge ce système via vos Serveurs MCP et génère des tâches pour les éléments détectés. Voir Calendriers.
Utilisez un événement lorsque Coroid peut être informé du moment où il se produit. Cela évite les exécutions inutiles par rapport à un calendrier qui interroge sans cesse.
Événements que vous pouvez choisir dans Nouveau travail
Depuis GitHub, qui nécessite l' GitHub App:
- un pull request est ouvert, mis à jour ou fusionné
- Un ticket est ouvert
- Un commentaire mentionne Coroid ; cela ne compte que si son auteur dispose d'un accès en écriture au dépôt.
Depuis Coroid :
- Une tâche, un plan, une vérification de Qualité, un déploiement ou une vérification de santé du déploiement échoue
- Un déploiement réussit
- Une version est annulée
Les événements générés par vos propres systèmes nécessitent un compte de service, et les événements Slack, Telegram et Jira requièrent un filtre : modifiez l'événement de l'automatisation dans son éditeur. Voir Hooks.
Ce qu'elle fait
Un agent suit vos instructions. Il peut lire le code du projet et créer des tickets, mais ne modifie rien directement. Les tâches qu'il génère suivent le même processus de spécification, planification, construction, vérification et révision que tout le reste, et aboutissent à un pull request que vous approuverez.
Selon un calendrier, une automatisation peut également exécuter vos tests navigateur sur une surface de test.
Les automatisations permanentes créées par Coroid pour vous sont des commutateurs dans le Contrôle qualité, et non des éléments à créer dans Nouveau travail :
- Réviser les demandes de fusion. Le Contrôle qualité Demandes de fusion groupe exécute les vérifications du projet sur chaque pull request (Coroid Contrôle qualité) et comporte un commentaire Coroid Review associé.
- Transformer les messages et tickets en demandes. Les messages Slack et Telegram, les commentaires GitHub mentionnant Coroid et les nouveaux tickets Jira deviennent des demandes lorsque leur source est activée dans le Contrôle qualité, sous l'onglet « Avant le début du travail ». Voir Suivis de tickets pour Jira.
- Suivre les échecs. Une tâche échouée, un déploiement raté et une version annulée disposent chacun d'un commutateur sous Lorsqu'un problème survient.
- Éliminer la dette technique existante. La dette technique d'un projet Nettoyage hebdomadaire de la dette est un commutateur sur sa ligne « Anti-gaspillage ».
Une automatisation gérée par un commutateur est identifiée comme telle sur sa page dans l'Usine, avec un lien vers le commutateur. Vous pouvez la mettre en pause ou l'éteindre là-bas ; modifiez ses instructions et elle deviendra votre propre automatisation après confirmation.
Les automatisations créées précédemment pour générer des demandes continuent de fonctionner et sont répertoriées sous Automatisations. Les automatisations qui révisaient les demandes de fusion ont été mises en pause lorsque le Contrôle qualité a pris en charge Coroid Review.
Modèles de Nouveau travail
Nouveau travail proposait autrefois des modèles. Leur fonction a été transférée aux commutateurs ci-dessus, et les deux modèles qui publiaient sur Slack peuvent être personnalisés avec le nom du canal. Ils publient via un Serveur MCP que vous connectez dans Paramètres, sous Connexions : un calendrier peut l'utiliser, et une automatisation événementielle peut aussi l'utiliser une fois que vous avez autorisé les outils MCP dans son éditeur dans l'Usine. Les automatisations créées à partir d'un modèle continuent de fonctionner telles quelles. Un ancien lien vers un modèle ouvrira le commutateur qui l'a remplacé, ou Nouveau travail.
Surveiller une automatisation
Ouvrez une automatisation dans l'Usine pour voir chaque exécution : quand elle s'est produite, son coût, ce qu'elle a généré et pourquoi une exécution n'a pas abouti. À partir de là, les propriétaires et administrateurs peuvent la mettre en pause, la tester, l'éditer ou la supprimer. Tous les membres de l'organisation peuvent consulter les automatisations et leurs exécutions.
Garder les automatisations utiles
Le travail généré par une automatisation entre en concurrence avec le reste pour les mêmes emplacements d'agents. Une automatisation qui se déclenche souvent peut silencieusement épuiser votre capacité.
- Attribuez-lui une priorité plus faible que le travail demandé par les utilisateurs.
P2ouP3. - Rendez le déclencheur plus spécifique. Le message « Un contrôle a échoué » s'affiche en permanence sur un dépôt très actif. Le message « Ce contrôle a échoué sur la branche de base » apparaît uniquement lorsqu'un problème réel existe.
- Consultez le résultat produit. Si une automatisation crée vingt tâches et que vous n'en fusionnez que deux, elle génère du bruit et des coûts sans créer de valeur.
La véritable mesure d'une automatisation réside dans la proportion de tâches ouvertes qui sont fusionnées, et non dans la fréquence à laquelle elle se déclenche.
Sentinel
Les anciennes versions de cette documentation mentionnaient Sentinel, un outil de surveillance qui détecte les conditions. Il ne s'agit pas d'une fonctionnalité distincte. Une condition peut être un événement qui déclenche une automatisation, ou un élément vérifié par un planning.