> ## Documentation Index
> Fetch the complete documentation index at: https://docs.alyzai.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Construire un workflow

> L’éditeur visuel : ajouter des nœuds, les relier, puis déployer une version.

> [!NOTE]
>
> Tutoriel · 12 min

## Résultat attendu

Vous allez créer un brouillon dont le chemin principal est lisible de l’entrée au résultat. Chaque
nœud aura une responsabilité, une configuration complète et une connexion explicite. Le workflow
ne sera pas encore déployé.

## Avant de commencer

* Écrivez le déclencheur, l’entrée et le résultat attendu sous forme de trois phrases.
* Listez les systèmes et ressources appelés.
* Préparez une donnée de test identifiable.
* Décidez comment éviter ou détecter un doublon.
* Vérifiez vos droits sur les sources et destinations.

<Snippet file="snippets/permissions.mdx" />

L’éditeur est un **canvas** : les nœuds représentent les étapes, les arêtes indiquent l’ordre de
circulation et l’inspecteur configure le nœud sélectionné.

**1. Ouvrez l’éditeur**

Depuis **Automatisations**, créez un workflow. Décrivez le résultat à l’assistant de
construction ou choisissez **Accéder à l’éditeur** pour partir directement du canvas. Nommez
le workflow avec un verbe et un résultat, puis utilisez le panoramique et le zoom pour repérer
son chemin.

![Canvas Alyzai montrant une requête structurée reliée à une écriture de données puis à une transformation](https://mintcdn.com/alyzai/St7evzCbpXJOLQ-i/images/product/automatisations/editeur.png?fit=max\&auto=format\&n=St7evzCbpXJOLQ-i\&q=85\&s=bc272372164b4e7e6a7926e69e4a38e8)

Un zoom du canvas rend lisibles les premières étapes et les liaisons entre leurs ports.

**2. Configurez le nœud de départ**

Sélectionnez le premier nœud et choisissez son déclencheur : **Manuel**, **Événement Alyzai**,
**Application connectée**, **Planification** ou **Formulaire**. Commencez par **Manuel** si
vous devez encore construire et tester le flux sans lancement automatique.

**3. Ajoutez une étape**

Utilisez le bouton **+** du canvas, puis choisissez la catégorie et le nœud adaptés : lecture
d’une source, transformation, condition, action ou sortie. Un nœud doit avoir une seule
responsabilité et un nom compréhensible dans l’historique.

**4. Reliez les ports dans l’ordre**

Faites glisser la liaison du port de sortie vers l’entrée suivante. Évitez les connexions qui
se croisent sans nécessité et vérifiez qu’aucun nœud obligatoire ne reste isolé. La simple
proximité visuelle de deux cartes ne crée aucune relation d’exécution.

![Nœuds Requête structurée, Écriture de données et Transformation reliés de gauche à droite par leurs ports](https://mintcdn.com/alyzai/St7evzCbpXJOLQ-i/images/product/automatisations/editeur.png?fit=max\&auto=format\&n=St7evzCbpXJOLQ-i\&q=85\&s=bc272372164b4e7e6a7926e69e4a38e8)

Les ports et arêtes définissent l’ordre d’exécution visible sur le canvas.

**5. Configurez l’étape dans l’inspecteur**

Sélectionnez le nœud, choisissez sa ressource et mappez ses entrées. Utilisez une sortie
précise d’une étape précédente plutôt qu’un objet complet lorsque seul un champ est nécessaire.

**6. Ajoutez les branches et la sortie**

Utilisez une condition uniquement si deux comportements différents sont attendus. Nommez les
branches selon leur résultat, puis terminez chacune par une action ou une fin contrôlée.

**7. Contrôlez le brouillon**

Relisez le flux de gauche à droite, puis quittez et rouvrez l’éditeur pour confirmer que les
nœuds, paramètres et liaisons sont conservés. Le badge affiché avec **Déployer** signale les
changements qui ne font pas encore partie de la version active. Ne déployez pas avant le test.

![Bouton Déployer et badge de changements dans l’éditeur d’automatisation Alyzai](https://mintcdn.com/alyzai/St7evzCbpXJOLQ-i/images/product/automatisations/deployer.png?fit=max\&auto=format\&n=St7evzCbpXJOLQ-i\&q=85\&s=cf9b1c9b712195fc07fbce641eb79915)

Déployer publie les changements du brouillon ; l’action reste réservée à une chaîne entièrement testée.

## Vérification finale

* Le nom du workflow décrit son résultat.
* Le déclencheur et les données d’entrée sont identifiables.
* Chaque nœud possède une responsabilité, un nom et une configuration.
* Chaque variable provient d’une étape antérieure.
* Toutes les étapes obligatoires sont reliées par des arêtes visibles.
* Toutes les branches ont une fin explicite.
* Le badge de **Déployer** correspond aux changements attendus et le brouillon n’a pas été publié.

## En cas de problème

| Symptôme | Contrôle recommandé |
| - | - |
| Un nœud ne peut pas être relié | Vérifiez le sens des ports et la compatibilité de l’entrée et de la sortie. |
| Une ressource n’apparaît pas | Contrôlez le workspace, la connexion et vos permissions. |
| Une variable est indisponible | Sa source doit se trouver sur un chemin antérieur et produire ce champ. |
| Deux cartes proches ne s’exécutent pas ensemble | Zoomez sur leurs ports : une arête doit réellement relier la sortie à l’entrée. |
| Le canvas devient difficile à lire | Scindez les responsabilités ou réorganisez les branches. |
| Une modification reste absente de la version active | Vérifiez le badge de **Déployer** : brouillon et version active sont distincts. |

## Étapes suivantes

> [card] [Nœuds et variables](https://docs.alyzai.com/fr/automatisations/noeuds-et-variables.md)
>
> Configurer précisément le passage des données.

> [card] [Tester et déployer](https://docs.alyzai.com/fr/automatisations/tester-et-deployer.md)
>
> Prouver le comportement avant d’activer une version.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.