# Créer une automatisation personnalisée (/fr/automations/create)

<!-- agent-signals: reading_time_min: 4 · est_tokens: 1702 · updated: 2026-07-31 -->
Related: [Automatisations prédéfinies](/fr/automations/reference.md), [Gérer les automatisations](/fr/automations/manage.md), [Intégrations pour l'agent et les automatisations](/fr/automations/integrations.md), [Accordion](/fr/components/accordions.md)

Une automatisation personnalisée exécute l'agent selon un calendrier, en réponse à des pushes sur un dépôt ou lorsqu'un événement survient dans une intégration connectée, en utilisant les instructions que vous rédigez. Utilisez une automatisation personnalisée lorsque vous avez besoin d'un comportement non couvert par une [automatisation prédéfinie](/fr/automations/reference), ou lorsque vous souhaitez combiner votre propre prompt avec des dépôts de contexte et des intégrations spécifiques. Pour un aperçu des déclencheurs, des modes de mise à jour et des options de configuration communs à toutes les automatisations, consultez [Automatisations](/fr/automations).

<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)

<div id="create-a-custom-automation">
  ## Créer une automatisation personnalisée [#créer-une-automatisation-personnalisée]
</div>

<Note>
  L'agent s'exécute dans un sandbox isolé avec un accès Internet restreint. Il ne peut pas installer de packages ou d'outils supplémentaires à l'exécution. Les prompts qui font référence à des outils indisponibles peuvent produire des résultats inattendus ou échouer.
</Note>

1. Ouvrez la page [Automations](https://app.mintlify.com/products/automations) dans votre dashboard.
2. Cliquez sur **Create a custom automation**.
3. Configurez le nom de l'automatisation, le déclencheur, les instructions, les dépôts de contexte, les intégrations et le mode de mise à jour. Pour plus de détails sur chaque champ, consultez [Configurations](/fr/automations/manage#configurations).
4. Cliquez sur **Create automation**.

<Tip>
  Vous pouvez également demander à l'[agent dans Slack](/fr/agent/slack#manage-automations) de créer une automatisation pour vous en décrivant ce que vous souhaitez qu'elle fasse.
</Tip>

<div id="write-effective-instructions">
  ## Rédiger des instructions efficaces [#rédiger-des-instructions-efficaces]
</div>

Des instructions d'automatisation efficaces se concentrent sur une seule tâche et définissent un résultat clair et vérifiable. Les automatisations présentent une certaine variabilité car les agents sont non déterministes, mais des instructions bien formulées produisent des résultats plus cohérents.

* **Décrivez le résultat.** Indiquez à l'agent à quoi devrait ressembler une exécution réussie.
* **Rédigez une procédure.** Donnez à l'agent un guide étape par étape à suivre.
* **Restez précis dans la portée.** Divisez les tâches complexes en plusieurs automatisations plutôt que de les combiner dans un seul prompt.

Pour plus d'exemples et de modèles, consultez [Utiliser les automatisations](/fr/guides/use-automations).

<Tip>
  Vérifiez les résultats de vos automatisations personnalisées pour confirmer qu'elles fonctionnent comme prévu. Mettez à jour vos instructions pour améliorer les résultats.
</Tip>

## 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="delete-a-custom-automation">
  ## Supprimer une automatisation personnalisée [#supprimer-une-automatisation-personnalisée]
</div>

La suppression d'une automatisation est définitive et supprime sa configuration ainsi que l'historique de ses exécutions.

1. Accédez à 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;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é d'une automatisation.
3. Cliquez sur **Delete**.