> ## Documentation Index
> Fetch the complete documentation index at: https://tomee-mintlify-cecfcf7e.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Créer une automatisation personnalisée

> Créez une automatisation Mintlify déclenchée par un calendrier, un push sur un dépôt ou un événement d'intégration, avec contexte et prompt dédiés.

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

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
</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="settings" /> de paramètres à côté d'une automatisation.
3. Cliquez sur **Delete**.