# Gérer les automatisations (/fr/automations/manage)

<!-- agent-signals: reading_time_min: 9 · est_tokens: 4024 · updated: 2026-07-31 -->
Related: [Automatisations prédéfinies](/fr/automations/reference.md), [Intégrations pour l'agent et les automatisations](/fr/automations/integrations.md), [Créer une automatisation personnalisée](/fr/automations/create.md)

<div id="prerequisites">
  ## Prérequis [#prérequis]
</div>

* Un projet Mintlify connecté à un dépôt GitHub ou GitLab
* Pour GitHub : la [GitHub App Mintlify](/fr/deploy/github) installée sur chaque dépôt que vous prévoyez d'utiliser dans l'automatisation
* Pour GitLab : un compte GitLab connecté (voir [Configuration GitLab](#gitlab-setup) ci-dessous)

<Tip>
  Vous pouvez également créer, lister et supprimer des automatisations depuis le terminal avec [`mint automations`](/fr/cli/commands#mint-automations). La CLI est utile pour les scripts et la CI. Le dashboard est le moyen le plus simple de configurer et de surveiller les exécutions d'automatisations.
</Tip>

<div id="enable-an-automation">
  ## Activer une automatisation [#activer-une-automatisation]
</div>

1. Ouvrez la page [Automations](https://app.mintlify.com/products/automations) dans votre dashboard.
2. Cliquez sur le bouton bascule à côté d'une automatisation pour l'activer.

   <Frame>
     <img src="/_assets/74d90cf5f87b84fd5b7b2022086d866a5b918949dfaa49b96df7ca1af346573f" alt="Le dashboard des automatisations." className="block dark:hidden" />

     <img src="/_assets/fcddd98f4c36849c167c1bce53cc3f240338f33c75b7822e14fc4dcb5da1701f" alt="Le dashboard des automatisations." className="hidden dark:block" />
   </Frame>

   Si l'automatisation peut s'exécuter avec les paramètres par défaut, elle s'active immédiatement. Sinon, le panneau de paramètres s'ouvre pour vous permettre de remplir les configurations requises.

   <Frame>
     <img src="/_assets/befd7701afa6b3962a0278a9dee2ea629bf7385769a9af2b1003c62600b05042" alt="Les options de configuration d'une automatisation." className="block dark:hidden" />

     <img src="/_assets/da0caabe03a68d7a49118c1b8c65010fe8449472cf43e9fa705e6b8c8214f383" alt="Les options de configuration d'une automatisation." className="hidden dark:block" />
   </Frame>
3. Si le panneau de paramètres s'ouvre, remplissez les champs requis.
4. Cliquez sur **Turn on automation**.

Pour modifier les paramètres d'une automatisation active, cliquez sur le bouton <Icon icon="<svg xmlns=&#x22;http://www.w3.org/2000/svg&#x22; viewBox=&#x22;0 0 24 24&#x22; fill=&#x22;none&#x22;><path d=&#x22;M21.3175 7.14139L20.8239 6.28479C20.4506 5.63696 20.264 5.31305 19.9464 5.18388C19.6288 5.05472 19.2696 5.15664 18.5513 5.36048L17.3311 5.70418C16.8725 5.80994 16.3913 5.74994 15.9726 5.53479L15.6357 5.34042C15.2766 5.11043 15.0004 4.77133 14.8475 4.37274L14.5136 3.37536C14.294 2.71534 14.1842 2.38533 13.9228 2.19657C13.6615 2.00781 13.3143 2.00781 12.6199 2.00781H11.5051C10.8108 2.00781 10.4636 2.00781 10.2022 2.19657C9.94085 2.38533 9.83106 2.71534 9.61149 3.37536L9.27753 4.37274C9.12465 4.77133 8.84845 5.11043 8.48937 5.34042L8.15249 5.53479C7.73374 5.74994 7.25259 5.80994 6.79398 5.70418L5.57375 5.36048C4.85541 5.15664 4.49625 5.05472 4.17867 5.18388C3.86109 5.31305 3.67445 5.63696 3.30115 6.28479L2.80757 7.14139C2.45766 7.74864 2.2827 8.05227 2.31666 8.37549C2.35061 8.69871 2.58483 8.95918 3.05326 9.48012L4.0843 10.6328C4.3363 10.9518 4.51521 11.5078 4.51521 12.0077C4.51521 12.5078 4.33636 13.0636 4.08433 13.3827L3.05326 14.5354C2.58483 15.0564 2.35062 15.3168 2.31666 15.6401C2.2827 15.9633 2.45766 16.2669 2.80757 16.8741L3.30114 17.7307C3.67443 18.3785 3.86109 18.7025 4.17867 18.8316C4.49625 18.9608 4.85542 18.8589 5.57377 18.655L6.79394 18.3113C7.25263 18.2055 7.73387 18.2656 8.15267 18.4808L8.4895 18.6752C8.84851 18.9052 9.12464 19.2442 9.2775 19.6428L9.61149 20.6403C9.83106 21.3003 9.94085 21.6303 10.2022 21.8191C10.4636 22.0078 10.8108 22.0078 11.5051 22.0078H12.6199C13.3143 22.0078 13.6615 22.0078 13.9228 21.8191C14.1842 21.6303 14.294 21.3003 14.5136 20.6403L14.8476 19.6428C15.0004 19.2442 15.2765 18.9052 15.6356 18.6752L15.9724 18.4808C16.3912 18.2656 16.8724 18.2055 17.3311 18.3113L18.5513 18.655C19.2696 18.8589 19.6288 18.9608 19.9464 18.8316C20.264 18.7025 20.4506 18.3785 20.8239 17.7307L21.3175 16.8741C21.6674 16.2669 21.8423 15.9633 21.8084 15.6401C21.7744 15.3168 21.5402 15.0564 21.0718 14.5354L20.0407 13.3827C19.7887 13.0636 19.6098 12.5078 19.6098 12.0077C19.6098 11.5078 19.7888 10.9518 20.0407 10.6328L21.0718 9.48012C21.5402 8.95918 21.7744 8.69871 21.8084 8.37549C21.8423 8.05227 21.6674 7.74864 21.3175 7.14139Z&#x22; stroke=&#x22;currentColor&#x22; stroke-linecap=&#x22;round&#x22; stroke-width=&#x22;1.5&#x22;/><path d=&#x22;M15.5195 12C15.5195 13.933 13.9525 15.5 12.0195 15.5C10.0865 15.5 8.51953 13.933 8.51953 12C8.51953 10.067 10.0865 8.5 12.0195 8.5C13.9525 8.5 15.5195 10.067 15.5195 12Z&#x22; stroke=&#x22;currentColor&#x22; stroke-width=&#x22;1.5&#x22;/></svg>" /> de paramètres à côté de celle-ci. Utilisez le bouton bascule dans l'en-tête de la modale pour activer ou désactiver l'automatisation sans quitter la vue des paramètres.

<div id="configurations">
  ## Configurations [#configurations]
</div>

<div id="trigger">
  ### Déclencheur [#déclencheur]
</div>

Chaque automatisation possède un déclencheur par défaut qui contrôle son moment d'exécution. Pour changer le déclencheur, sélectionnez une autre option dans le panneau des paramètres.

* **Mise à jour de contenu** : s'exécute chaque fois que vous poussez du contenu vers le dépôt de votre projet, y compris les fusions de pull requests et les pushes directs.
* **Modification de code** : s'exécute lorsqu'une pull request est fusionnée dans un dépôt de code source connecté. Vous devez spécifier au moins un dépôt source.
* **Calendrier personnalisé** : s'exécute selon un calendrier récurrent que vous définissez. Les automatisations sont mises en file d'attente dans les 10 minutes suivant l'heure planifiée.
* **Intégration** : s'exécute lorsqu'un événement sélectionné se produit dans une intégration partagée connectée. Disponible pour les automatisations personnalisées. Sélectionnez l'intégration et l'événement, puis remplissez les champs supplémentaires affichés.

<div id="update-mode">
  ### Mode de mise à jour [#mode-de-mise-à-jour]
</div>

Chaque automatisation possède un mode par défaut pour effectuer les mises à jour. Soit fusionner directement les modifications dans votre dépôt de contenu, soit ouvrir une pull request pour relecture.

Pour exiger une relecture avant que l'automatisation ne mette à jour votre contenu, sélectionnez **Require review** dans le panneau des paramètres.

<Note>
  Pour les dépôts GitHub, les mises à jour automatiques nécessitent que la GitHub App Mintlify dispose d'autorisations de contournement (bypass) sur chaque ensemble de règles ciblant votre branche de déploiement, y compris les ensembles de règles au niveau de l'organisation et du dépôt. Consultez [Configurer l'automerge](/fr/guides/configure-automerge) pour les instructions d'installation.

  Pour les dépôts GitLab, l'automerge utilise la connexion OAuth GitLab et nécessite au moins le rôle Maintainer sur chaque projet.
</Note>

<div id="context-repositories">
  ### Dépôts de contexte [#dépôts-de-contexte]
</div>

Pour les automatisations personnalisées et certaines automatisations prédéfinies, vous pouvez ajouter des dépôts de contexte — des dépôts de code source supplémentaires que l'agent lit lorsque l'automatisation s'exécute. C'est utile lorsque le prompt de votre automatisation fait référence à du code, des API ou d'autres contenus qui se trouvent en dehors de votre dépôt de projet.

Vous pouvez ajouter jusqu'à 10 dépôts de contexte par automatisation. Pour chaque dépôt GitHub, installez la GitHub App Mintlify. Ajoutez des dépôts sur la page [GitHub App settings](https://app.mintlify.com/settings/organization/github-app).

<div id="integrations">
  ### Intégrations [#intégrations]
</div>

Pour les automatisations personnalisées et les autres automatisations prédéfinies compatibles, vous pouvez activer des [intégrations](/fr/automations/integrations) afin que l'agent récupère du contexte depuis des outils partagés comme Notion, Jira ou Linear.

Ouvrez les paramètres de l'automatisation et sélectionnez les intégrations dans **Tools**. Vous pouvez connecter une intégration partagée depuis le sélecteur. Les intégrations personnelles ne sont disponibles que pour leur propriétaire lorsqu'il utilise l'agent Slack et ne peuvent pas être ajoutées aux automatisations.

Si vous sélectionnez **Intégration** comme déclencheur, l'intégration déclencheuse est automatiquement ajoutée comme outil. Consultez [Intégrations](/fr/automations/integrations) pour les portées, événements et autorisations.

<div id="slack-notifications">
  ### Notifications Slack [#notifications-slack]
</div>

Envoyez des messages Slack à un ou plusieurs canaux lorsque les automatisations s'exécutent.

Pour activer les notifications Slack :

1. Installez l'[application Slack Mintlify](/fr/agent/slack) dans votre espace de travail.
2. Cliquez sur **Configure Slack** sur la page [Automations](https://app.mintlify.com/products/automations) de votre dashboard.
3. Sélectionnez un ou plusieurs canaux vers lesquels envoyer les notifications.
4. Cliquez sur **Save changes**.

Une fois activé, Mintlify publie dans les canaux sélectionnés lorsque :

* Une automatisation ouvre une pull request pour relecture.
* Une pull request d'automatisation attend une relecture depuis trois jours.
* Une automatisation fusionne une pull request, ou échoue à se terminer.

<div id="instructions">
  ### Instructions [#instructions]
</div>

Ajoutez des instructions facultatives qui s'ajoutent au prompt de base de l'automatisation à chaque exécution. Utilisez-les pour ajuster le style, le ton ou d'autres comportements spécifiques au projet sans modifier la logique principale de l'automatisation.

<div id="target-languages">
  ### Langues cibles [#langues-cibles]
</div>

Lorsque vous activez l'automatisation **Translate content**, sélectionnez une ou plusieurs langues à maintenir en synchronisation avec votre contenu source.

* Mintlify lit les [langues](/fr/organize/navigation#languages) définies dans votre `docs.json` pour identifier votre langue par défaut et présélectionne les langues cibles déjà configurées.
* Vous devez sélectionner au moins une langue cible pour enregistrer l'automatisation.
* Vous ne pouvez pas sélectionner la langue source comme cible.

Vous pouvez ajouter des langues cibles à tout moment en ouvrant les paramètres de l'automatisation et en modifiant le champ **Translate to**.

## Configuration GitLab [#configuration-gitlab]

Pour utiliser des dépôts GitLab dans une automatisation, connectez chaque projet via la page de paramètres [OAuth GitLab](https://app.mintlify.com/settings/organization/gitlab-oauth). Connectez chaque dépôt que l'automatisation utilise — votre dépôt de documentation et tous les dépôts de déclenchement ou de contexte. Vous devez disposer au minimum du rôle Mainteneur sur chaque projet.

<Note>
  Les automatisations nécessitent un forfait GitLab payant. L'agent utilise des jetons d'accès de projet à courte durée de vie pour l'accès aux dépôts, ce que le forfait gratuit de GitLab ne prend pas en charge.
</Note>

<div id="disable-an-automation">
  ## Désactiver une automatisation [#désactiver-une-automatisation]
</div>

1. Accédez à la page [Automations](https://app.mintlify.com/products/automations) dans votre dashboard.
2. Cliquez sur le bouton bascule à côté d'une automatisation pour la désactiver.

Lorsque vous réactivez une automatisation planifiée ou modifiez son calendrier, Mintlify recalcule la prochaine heure d'exécution à partir de l'heure actuelle. Les automatisations désactivées ne conservent pas d'heure d'exécution en attente.

<div id="run-an-automation-manually">
  ## Exécuter une automatisation manuellement [#exécuter-une-automatisation-manuellement]
</div>

Vous pouvez déclencher toute automatisation activée à la demande sans attendre sa prochaine exécution planifiée ou déclenchée par un événement.

1. Ouvrez la page [Automations](https://app.mintlify.com/products/automations) dans votre dashboard.
2. Cliquez sur le bouton <Icon icon="<svg xmlns=&#x22;http://www.w3.org/2000/svg&#x22; viewBox=&#x22;0 0 24 24&#x22; fill=&#x22;none&#x22;><path d=&#x22;M18.8906 12.846C18.5371 14.189 16.8667 15.138 13.5257 17.0361C10.296 18.8709 8.6812 19.7884 7.37983 19.4196C6.8418 19.2671 6.35159 18.9776 5.95624 18.5787C5 17.6139 5 15.7426 5 12C5 8.2574 5 6.3861 5.95624 5.42132C6.35159 5.02245 6.8418 4.73288 7.37983 4.58042C8.6812 4.21165 10.296 5.12907 13.5257 6.96393C16.8667 8.86197 18.5371 9.811 18.8906 11.154C19.0365 11.7084 19.0365 12.2916 18.8906 12.846Z&#x22; stroke=&#x22;currentColor&#x22; stroke-linejoin=&#x22;round&#x22; stroke-width=&#x22;1.5&#x22;/></svg>" /> d'exécution à côté de l'automatisation que vous souhaitez démarrer.

Les exécutions manuelles utilisent la configuration actuelle de l'automatisation, sont décomptées de votre utilisation de crédits et apparaissent dans l'historique des exécutions aux côtés des exécutions planifiées.

<div id="trigger-a-scheduled-automation-via-api">
  ## Déclencher une automatisation planifiée via l'API [#déclencher-une-automatisation-planifiée-via-lapi]
</div>

Pour les automatisations avec un déclencheur **Calendrier personnalisé**, vous pouvez démarrer une exécution depuis vos propres outils au lieu d'attendre la prochaine heure planifiée. Utilisez l'endpoint [Trigger automation](/fr/api/automations/trigger) pour déclencher une exécution depuis un pipeline CI/CD, un script de version ou tout service capable de faire une requête HTTP authentifiée.

Les exécutions déclenchées par API se comportent exactement comme les exécutions planifiées : elles récupèrent tout ce qui a changé depuis la dernière exécution terminée, sont décomptées de votre utilisation de crédits et apparaissent dans l'historique des exécutions.

<div id="view-run-history">
  ## Consulter l'historique des exécutions [#consulter-lhistorique-des-exécutions]
</div>

Chaque automatisation conserve un journal des exécutions passées, incluant le statut et un résumé des modifications effectuées.

1. Ouvrez la page [Automations](https://app.mintlify.com/products/automations?tab=runs) dans votre dashboard.
2. Utilisez les menus déroulants pour filtrer par automatisations spécifiques ou par statut.

Chaque exécution affiche l'un des statuts suivants :

* **Review needed** : l'agent a terminé l'exécution, mais les modifications doivent être relues et fusionnées par une personne de votre équipe.
* **Running** : l'agent travaille activement sur la tâche d'automatisation.
* **Accepted** : l'agent a terminé l'exécution et les modifications ont été fusionnées dans votre dépôt.
* **Closed** : l'agent a terminé l'exécution, mais quelqu'un a rejeté les modifications.
* **Failed** : l'agent n'a pas pu terminer l'exécution. Les exécutions en échec ne comptent pas dans votre limite quotidienne d'exécutions.
* **No action needed** : l'agent a terminé l'exécution mais n'a rien trouvé à mettre à jour.

Cliquez sur une exécution individuelle pour voir son prompt, les fichiers qu'elle a lus ou modifiés, et toute pull request qu'elle a ouverte.

<div id="continue-a-run-in-the-editor">
  ## Poursuivre une exécution dans l'éditeur [#poursuivre-une-exécution-dans-léditeur]
</div>

Lorsqu'une automatisation se termine et crée des modifications sur une branche, vous pouvez ouvrir ces modifications directement dans l'éditeur pour les examiner, les affiner ou les publier.

1. Ouvrez la page [Automations](https://app.mintlify.com/products/automations) dans votre dashboard.
2. Cliquez sur **View changes** à côté de l'exécution du workflow sur laquelle vous souhaitez continuer à travailler dans l'éditeur.

L'éditeur s'ouvre sur la branche de l'automatisation avec le panneau de l'agent déjà ouvert. Le panneau de l'agent affiche chaque page modifiée par l'automatisation. Cliquez sur une page pour voir les modifications effectuées par l'automatisation.

L'agent de l'éditeur dispose d'un contexte complet sur ce que l'automatisation a fait, y compris son prompt, un résumé des modifications et les pages modifiées. Demandez à l'agent d'affiner ou d'étendre ce travail sans avoir à réexpliquer le contexte.