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

# Créer un workflow personnalisé

> Créez un workflow Mintlify personnalisé avec un trigger planifié ou push, des dépôts de contexte et un prompt d’agent pour automatiser vos tâches docs.

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

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

<div id="create-a-custom-workflow">
  ## Créer un workflow personnalisé
</div>

<Note>
  L'agent s'exécute dans un sandbox isolé avec un accès restreint à Internet. Il ne peut pas installer de packages ou d'outils supplémentaires au moment de 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 [Workflows](https://app.mintlify.com/products/workflows?tab=workflows) dans votre tableau de bord.
2. Cliquez sur **Create a custom workflow**.
3. Configurez le nom du workflow, le trigger, les instructions, les dépôts de contexte, les intégrations et le mode de mise à jour.
4. Cliquez sur **Create workflow**.

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

Des instructions de workflow efficaces se concentrent sur une seule tâche et définissent un résultat clair et vérifiable. Les workflows présentent une certaine variabilité car les agents ne sont pas déterministes, mais des instructions bien formatées produisent des résultats plus cohérents.

* **Décrivez le résultat.** Indiquez à l'agent à quoi doit ressembler le résultat d'une exécution réussie.
* **Rédigez une procédure.** Donnez à l'agent un guide étape par étape à suivre.
* **Limitez le périmètre.** Répartissez les tâches complexes entre plusieurs workflows plutôt que de les combiner dans un seul prompt.

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

<Tip>
  Examinez la sortie de vos workflows personnalisés pour confirmer qu'ils 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 un workflow, 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 le workflow 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 workflows 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-workflow">
  ## Supprimer un workflow personnalisé
</div>

La suppression d'un workflow est définitive et supprime sa configuration ainsi que son historique d'exécution.

1. Accédez à la page [Workflows](https://app.mintlify.com/products/workflows?tab=workflows) dans votre tableau de bord.
2. Cliquez sur le bouton <Icon icon="settings" /> de paramètres à côté d'un workflow.
3. Cliquez sur **Delete**.