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

<!-- agent-signals: reading_time_min: 6 · est_tokens: 2417 · updated: 2026-09-23 -->
Related: [Intégrations pour l'agent et les automatisations](/fr/automations/integrations.md), [Gérer les automatisations](/fr/automations/manage.md), [Automatisations prédéfinies](/fr/automations/reference.md), [Contact de sécurité](/fr/dashboard/security-contact.md)

Une automatisation personnalisée exécute l'agent selon un calendrier, en réponse à des pushes sur un dépôt, lorsqu'un événement survient dans une intégration connectée ou lorsqu'une requête webhook entrante est reçue, 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>

* Une [offre Pro ou Enterprise](https://mintlify.com/pricing?ref=automations). Le déclencheur Intégration nécessite une offre Enterprise.
* 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 **New automation**.
3. Sur la page de configuration, définissez le nom de l'automatisation, le déclencheur, le prompt, 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 **Save**.

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

<div id="test-your-automation">
  ## Tester votre automatisation [#tester-votre-automatisation]
</div>

Testez une nouvelle automatisation avec une exécution manuelle afin de ne pas avoir à attendre que son déclencheur se produise. Les exécutions manuelles utilisent la configuration actuelle de l'automatisation et apparaissent dans l'historique des exécutions aux côtés des exécutions automatisées. Vous ne pouvez pas exécuter manuellement les automatisations avec un déclencheur d'intégration ou de webhook ; envoyez un événement ou une requête webhook à la place. Consultez [Exécuter une automatisation manuellement](/fr/automations/manage#run-an-automation-manually) pour choisir la portée d'une exécution de test.

Examinez l'exécution dans l'[historique des exécutions](/fr/automations/manage#view-run-history) pour voir le prompt, les fichiers modifiés par l'agent et toute pull request ouverte. Si le résultat ne correspond pas à vos attentes, mettez à jour vos instructions et relancez l'exécution.

## 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="edit-a-custom-automation">
  ## Modifier une automatisation personnalisée [#modifier-une-automatisation-personnalisée]
</div>

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;M15.5 12C15.5 13.933 13.933 15.5 12 15.5C10.067 15.5 8.5 13.933 8.5 12C8.5 10.067 10.067 8.5 12 8.5C13.933 8.5 15.5 10.067 15.5 12Z&#x22; stroke=&#x22;currentColor&#x22; stroke-width=&#x22;1.5&#x22;/><path d=&#x22;M21.011 14.0965C21.5329 13.9558 21.7939 13.8854 21.8969 13.7508C22 13.6163 22 13.3998 22 12.9669V11.0332C22 10.6003 22 10.3838 21.8969 10.2493C21.7938 10.1147 21.5329 10.0443 21.011 9.90358C19.0606 9.37759 17.8399 7.33851 18.3433 5.40087C18.4817 4.86799 18.5509 4.60156 18.4848 4.44529C18.4187 4.28902 18.2291 4.18134 17.8497 3.96596L16.125 2.98673C15.7528 2.77539 15.5667 2.66972 15.3997 2.69222C15.2326 2.71472 15.0442 2.90273 14.6672 3.27873C13.208 4.73448 10.7936 4.73442 9.33434 3.27864C8.95743 2.90263 8.76898 2.71463 8.60193 2.69212C8.43489 2.66962 8.24877 2.77529 7.87653 2.98663L6.15184 3.96587C5.77253 4.18123 5.58287 4.28891 5.51678 4.44515C5.45068 4.6014 5.51987 4.86787 5.65825 5.4008C6.16137 7.3385 4.93972 9.37763 2.98902 9.9036C2.46712 10.0443 2.20617 10.1147 2.10308 10.2492C2 10.3838 2 10.6003 2 11.0332V12.9669C2 13.3998 2 13.6163 2.10308 13.7508C2.20615 13.8854 2.46711 13.9558 2.98902 14.0965C4.9394 14.6225 6.16008 16.6616 5.65672 18.5992C5.51829 19.1321 5.44907 19.3985 5.51516 19.5548C5.58126 19.7111 5.77092 19.8188 6.15025 20.0341L7.87495 21.0134C8.24721 21.2247 8.43334 21.3304 8.6004 21.3079C8.76746 21.2854 8.95588 21.0973 9.33271 20.7213C10.7927 19.2644 13.2088 19.2643 14.6689 20.7212C15.0457 21.0973 15.2341 21.2853 15.4012 21.3078C15.5682 21.3303 15.7544 21.2246 16.1266 21.0133L17.8513 20.034C18.2307 19.8187 18.4204 19.711 18.4864 19.5547C18.5525 19.3984 18.4833 19.132 18.3448 18.5991C17.8412 16.6616 19.0609 14.6226 21.011 14.0965Z&#x22; stroke=&#x22;currentColor&#x22; stroke-linecap=&#x22;round&#x22; stroke-width=&#x22;1.5&#x22;/></svg>" /> de paramètres sur la carte de l'automatisation pour ouvrir sa page de configuration.
3. Mettez à jour n'importe quel des champs décrits dans [Configurations](/fr/automations/manage#configurations).
4. Cliquez sur **Save**.

<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;M15.5 12C15.5 13.933 13.933 15.5 12 15.5C10.067 15.5 8.5 13.933 8.5 12C8.5 10.067 10.067 8.5 12 8.5C13.933 8.5 15.5 10.067 15.5 12Z&#x22; stroke=&#x22;currentColor&#x22; stroke-width=&#x22;1.5&#x22;/><path d=&#x22;M21.011 14.0965C21.5329 13.9558 21.7939 13.8854 21.8969 13.7508C22 13.6163 22 13.3998 22 12.9669V11.0332C22 10.6003 22 10.3838 21.8969 10.2493C21.7938 10.1147 21.5329 10.0443 21.011 9.90358C19.0606 9.37759 17.8399 7.33851 18.3433 5.40087C18.4817 4.86799 18.5509 4.60156 18.4848 4.44529C18.4187 4.28902 18.2291 4.18134 17.8497 3.96596L16.125 2.98673C15.7528 2.77539 15.5667 2.66972 15.3997 2.69222C15.2326 2.71472 15.0442 2.90273 14.6672 3.27873C13.208 4.73448 10.7936 4.73442 9.33434 3.27864C8.95743 2.90263 8.76898 2.71463 8.60193 2.69212C8.43489 2.66962 8.24877 2.77529 7.87653 2.98663L6.15184 3.96587C5.77253 4.18123 5.58287 4.28891 5.51678 4.44515C5.45068 4.6014 5.51987 4.86787 5.65825 5.4008C6.16137 7.3385 4.93972 9.37763 2.98902 9.9036C2.46712 10.0443 2.20617 10.1147 2.10308 10.2492C2 10.3838 2 10.6003 2 11.0332V12.9669C2 13.3998 2 13.6163 2.10308 13.7508C2.20615 13.8854 2.46711 13.9558 2.98902 14.0965C4.9394 14.6225 6.16008 16.6616 5.65672 18.5992C5.51829 19.1321 5.44907 19.3985 5.51516 19.5548C5.58126 19.7111 5.77092 19.8188 6.15025 20.0341L7.87495 21.0134C8.24721 21.2247 8.43334 21.3304 8.6004 21.3079C8.76746 21.2854 8.95588 21.0973 9.33271 20.7213C10.7927 19.2644 13.2088 19.2643 14.6689 20.7212C15.0457 21.0973 15.2341 21.2853 15.4012 21.3078C15.5682 21.3303 15.7544 21.2246 16.1266 21.0133L17.8513 20.034C18.2307 19.8187 18.4204 19.711 18.4864 19.5547C18.5525 19.3984 18.4833 19.132 18.3448 18.5991C17.8412 16.6616 19.0609 14.6226 21.011 14.0965Z&#x22; stroke=&#x22;currentColor&#x22; stroke-linecap=&#x22;round&#x22; stroke-width=&#x22;1.5&#x22;/></svg>" /> de paramètres sur la carte de l'automatisation pour ouvrir sa page de configuration.
3. Cliquez sur **Delete automation** en bas de la page et confirmez.