> For the complete documentation index, see [llms.txt](https://docs.recital.ai/products/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.recital.ai/products/workflow/creer-un-workflow.md).

# Créer un Workflow

## Créer un nouveau workflow

Cliquez sur "Créer un Workflow" puis donnez lui un nom.

<figure><img src="/files/k9lU5kT7rHMtVaBs0gOh" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/a3dI5G20dEduLdkER8ch" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
Un workflow doit obligatoirement être composé au minimum d'un Etat "Début" et d'un Etat "Fin".
{% endhint %}

## Ajouter des actions

Pour ajouter des actions entre le début et la fin d'un workflow, cliquez sur le bouton "Ajouter une étape"

<figure><img src="/files/O9YVpOLxEQQwgmuJtTR0" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/I54nFsFEtVH7mKqICy6O" alt=""><figcaption></figcaption></figure>

Nous avons une page dédiée à la liste de tous les modules disponibles : [Les modules Workflow](/products/workflow/les-modules-workflow.md).

## Ajouter des transitions

Chaque module possède 2 points d'attache (sauf les états initiaux et terminaux qui n'en possèdent qu'un).

<figure><img src="/files/wlU9Awf33FFX18xBHM4L" alt=""><figcaption></figcaption></figure>

Une transition entre 2 modules peut être créée en reliant leurs points d'attache.

&#x20;

<figure><img src="/files/XOPuYZAtTaCvQfJDGeMg" alt=""><figcaption></figcaption></figure>

Il est possible de créer autant de transitions que souhaité en fonction des besoin.

<figure><img src="/files/GQ7rR1aw8KOHNpZQRbDe" alt=""><figcaption></figcaption></figure>

Une transition peut être libre (par défaut) ou bien conditionnelle. Pour créer une transition conditionnelle, cliquez sur la transition, cochez la case "Use code for transition", et écrivez en code Python la condition à respecter pour passer par cette transition.

<figure><img src="/files/lhduikD1oo02M53FTVhE" alt=""><figcaption></figcaption></figure>

## Terminer un Worflow

Chaque branche d'un workflow doit se terminer par un module d'état Terminal.

Une fois que l'architecture d'un Workflow est valide, on peut le tester et le publier.

### Publier un workflow

Publier un workflow permet de le tester, et de l'utiliser en production. Pour se faire, cliquez sur le bouton "Publier la version".

<figure><img src="/files/j8TPNE01MiRjHf5o50eI" alt=""><figcaption></figcaption></figure>

Une fois qu'un workflow est publié, on peut toujours retourner en mode Draft. Tant que le nouveau Draft ne sera pas publié, il n'aura aucun impact sur la production.

### Tester un workflow

Une fois que votre Workflow est publié, vous pouvez le tester.

<figure><img src="/files/Q4QcinsC6kMZ3VDpGxuZ" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/Pn90Lh29Pb8sZzt9KgSc" alt=""><figcaption></figcaption></figure>

**Donnée Initiale :**\
Chaque étape du workflow génère des données qui peuvent être utilisées au sein même de ce workflow et que l'on retrouve dans les résultats finaux. Il est également possible de transmettre des données initiales avant même la première étape. Un champ au format JSON est attendu.

{% hint style="info" %}
Transmettre des données initiales peut être très pratique pour les transitions conditionnelles, notamment si vous savez à l'avance dans quelle branche le workflow doit se diriger (par exemple, effectuer un vidéo-codage ou non).
{% endhint %}

**Métadonnées personnalisées :**\
Des données sous forme de chaînes de caractères, non exploitables dans le workflow, mais renvoyées telles quelles dans les résultats.

{% hint style="info" %}
Ce paramètre est souvent utilisé pour transmettre des identifiants internes (ID), afin de les retrouver dans les résultats et d'associer ces derniers à l'ID correspondant.
{% endhint %}

**Fichiers :**\
Les documents qui seront envoyés dans le workflow. Trois collections par défaut sont disponibles :

* **File :** Utilisée par la plupart des modules par défaut.
* **Email :** Utilisée par le module "Ingest Email" par défaut.
* **Attachment :** Non utilisée par défaut par aucun module, mais pratique dans certains cas spécifiques, comme tester une partie du workflow.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.recital.ai/products/workflow/creer-un-workflow.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.