Workflows

Accès depuis : Processus → Workflows

Un workflow est une automatisation qui exécute une séquence d'étapes sur vos données Amazon, soit à la demande, soit selon une programmation. Il vous permet d'auditer vos produits, de détecter des problèmes et de créer des tâches de vérification sans avoir à le faire manuellement.

Comment sont-ils créés ?

Aujourd'hui, il existe deux façons de créer un workflow dans Epinium :

• À partir d'un modèle — en clonant un modèle de la Bibliothèque de modèles. C'est la voie recommandée et la plus rapide.
• Avec VelaxAI — décrivez en langage naturel ce que vous souhaitez automatiser et VelaxAI génère le workflow.

Il n'existe pas encore d'option pour créer un workflow à partir de zéro sur une toile vierge. Une fois le workflow créé (cloné depuis un modèle ou généré par VelaxAI), vous pouvez le modifier librement : changer son déclencheur, ses conditions, son code, ses connexions, etc.

Workflow, Tâche ou VelaxAI ?

• Workflow — pour des règles récurrentes qui s'exécutent périodiquement (chaque lundi, chaque 1er du mois).
• Tâche — pour vérifier et approuver les suggestions qu'un workflow (ou VelaxAI) génère.
• VelaxAI — pour des consultations ponctuelles en langage naturel et pour créer de nouveaux workflows.

États du workflow

Un workflow peut être dans l'un de ces trois états :

État	Signification
En pause	Configuré mais ne s'exécutera pas automatiquement. C'est l'état par défaut au clonage d'un modèle. Il peut toujours être exécuté manuellement.
Actif	S'exécutera automatiquement selon son déclencheur.
Avec erreurs de validation	L'éditeur a détecté un problème dans le graphe (nœud non connecté, condition vide, référence cassée). Il ne peut pas être activé tant qu'il n'est pas corrigé.

L'éditeur visuel

L'éditeur affiche le workflow comme un graphe : chaque case est un nœud (une étape) et chaque ligne est une connexion (ce qui vient après).

• Toile — vous pouvez déplacer les nœuds pour réorganiser visuellement. Cela n'affecte pas la logique.
• Connexions — certaines sont simples (un seul chemin de sortie). D'autres bifurquent : une Condition a des sorties Oui et Non ; une Boucle a par élément (pour chaque élément) et à la fin (lorsque l'itération se termine).
• Configurer un nœud — un clic sur un nœud ouvre une fenêtre où vous pouvez éditer ses paramètres : message, URL, condition, affectation de variables, etc.
• Modifier le code d'un nœud — le nœud Exécuter du code ouvre un éditeur où vous pouvez lire et modifier le script (généré par VelaxAI ou copié depuis le modèle).
• Validation automatique — l'éditeur marque les erreurs en rouge (nœuds orphelins, connexions cassées, conditions sans opérateur). S'il y a des erreurs, le workflow ne peut pas être activé.

Types de nœuds

Voici les nœuds disponibles :

Nœud	Ce qu'il fait
Début	Marque le point de départ du flux. Chaque workflow a exactement un nœud de début.
Fin	Marque un point de fin. Un workflow peut avoir plusieurs nœuds de fin (un par branche, par exemple).
Action	Exécute une tâche concrète. Il a plusieurs sous-types (voir tableau suivant).
Condition	Bifurcation Oui / Non basée sur un champ et un opérateur (égal, supérieur à, contient, est vide…).
Multi-branche	Comme une condition, mais avec plusieurs sorties selon la valeur d'un champ. Utile lorsqu'il y a plus de deux cas.
Boucle (Pour chaque)	Itère sur un ensemble d'éléments (produits, campagnes, search terms…). Voir § Boucles.
Attente	Met le flux en pause pendant une durée (secondes, minutes, heures) avant de continuer.

Sous-types du nœud Action :

Sous-type	Ce qu'il fait
Message dans le log	Écrit un message dans le journal d'exécution. Utile pour déboguer ou laisser des traces.
Requête HTTP	Appelle une URL externe (un webhook, une intégration avec un autre système). Permet d'envoyer des données à des outils tiers.
Exécuter du code	Exécute une logique personnalisée dans un environnement sécurisé. C'est le moteur des vérifications des modèles d'audit : il évalue des règles complexes sur un produit et renvoie un résultat structuré. Vous pouvez lire et modifier le script depuis l'éditeur.
Créer une tâche	Génère ou met à jour une tâche avec un ou plusieurs éléments pour vérification humaine. Voir § Tâches et supervision humaine.
Résoudre une tâche	Marque comme résolus les éléments d'une tâche dont les problèmes n'existent plus (parce qu'ils ont été corrigés).

Déclencheurs

Un workflow peut être lancé de deux façons :

• Manuel — bouton Exécuter sur la page du workflow. Il ouvre une fenêtre qui affiche le coût maximum estimé avant confirmation.
• Programmé — le workflow se lance seul selon une programmation :
  • Cron — expression cron standard à 5 champs. Exemples : chaque lundi à 9h00, le 1er de chaque mois à 5h00.
  • Intervalle — toutes les N minutes, heures ou jours.
  • Date unique — une seule exécution à une date/heure précises.
• Fuseau horaire — configurable par workflow (par exemple Europe/Paris). Le déclencheur est interprété dans ce fuseau, pas en UTC.

Coût estimé

Avant d'exécuter manuellement un workflow, Epinium calcule et affiche le coût maximum en crédits. Ce chiffre reflète le pire cas (tous les produits audités, tous les nœuds exécutés sans saut).

Vérifiez le coût avant d'activer

Si vous allez activer un workflow programmé qui itère sur tout le catalogue, lancez d'abord une exécution manuelle pour voir le coût réel. Sur de grands catalogues, une exécution quotidienne non intentionnelle peut consommer plus de crédits que prévu.

Boucles (Pour chaque)

Un nœud Pour chaque répète les étapes qu'il contient une fois par élément d'une liste.

Origine des données — deux modes :

• Requête — vous choisissez une collection de votre compte (produits, campagnes, search terms, ad groups, product ads, keywords, clusters) et appliquez des filtres pour la délimiter. C'est le mode le plus utilisé.
• Référence — itère sur une liste produite par un nœud précédent (par exemple, le résultat d'une requête HTTP).

Gestion des erreurs par élément — si l'évaluation d'un élément échoue, la boucle peut :

• Continuer (par défaut) — poursuit le traitement des autres éléments.
• Abandonner — arrête toute la boucle.

Collecter les résultats — facultativement, la boucle peut regrouper ce que produit chaque itération en un résumé final. Les modèles d'audit l'utilisent pour compter combien de produits sont conformes et combien ne le sont pas, et afficher le résumé dans le log.

La boucle a deux sorties : par élément (ce qui s'exécute pour chaque élément) et à la fin (ce qui s'exécute une fois tous traités).

Variables et contexte

Les workflows utilisent des variables pour passer des données entre les nœuds. La syntaxe est {{ ... }} et il y a trois origines :

Variable	D'où elle vient	Exemple
{{trigger.X}}	Données envoyées au workflow lors de son exécution manuelle.	{{trigger.email}}
{{nodes.NOM.result.X}}	Sortie d'un nœud précédent.	{{nodes.checkTitle.result.titleTooLong}}
{{forEach.NOM}}	L'élément actuel lorsque vous êtes à l'intérieur d'une boucle. Par défaut, il s'appelle item, mais les modèles utilisent généralement des noms plus lisibles comme product.	{{forEach.product}}

Exemple d'utilisation dans une Condition : évaluer si le résultat d'un nœud de code indique que le titre est trop court :

• Champ : {{nodes.checkTitle.result.titleTooLong}}
• Opérateur : est vrai

Tâches et supervision humaine

Les workflows peuvent générer des tâches afin qu'un humain vérifie leurs constats avant l'application des modifications. C'est le point fort du système : l'automatisation détecte les problèmes, mais rien n'est appliqué tant que vous n'avez pas approuvé.

Nœud Créer une tâche

Lorsqu'un workflow détecte un problème, ce nœud crée une tâche (ou ajoute des éléments à une tâche existante). Les éléments peuvent inclure une valeur suggérée (correction automatique) que l'utilisateur peut accepter en un clic.

• Idempotence — le workflow utilise une clé unique par problème. Une nouvelle exécution ne duplique pas les tâches : elle ajoute de nouveaux éléments si de nouveaux problèmes apparaissent, et laisse tranquilles ceux déjà présents.
• HITL (Human-in-the-Loop) — lorsqu'il est activé, les éléments ne s'appliquent pas automatiquement. Un humain les vérifie et les approuve avant qu'ils n'atteignent le produit ou la campagne.

Nœud Résoudre une tâche

Marque comme résolus les éléments d'une tâche dont les problèmes n'existent plus. Utile lorsque vous réexécutez un workflow et qu'un produit qui échouait auparavant est désormais conforme — le nœud ferme automatiquement les éléments associés.

Plus de détails sur le système de tâches dans Tâches.

Historique des exécutions

Chaque fois qu'un workflow s'exécute, l'exécution est enregistrée et consultable depuis sa page. Les états possibles sont :

État	Signification
En attente	En file, pas encore démarrée.
En cours	En cours d'exécution.
Terminée	Terminée sans erreurs.
Échouée	Un nœud a échoué et a interrompu le flux.
Annulée	Arrêtée manuellement.

Inspecteur d'exécution

Cliquez sur un nœud à l'intérieur d'une exécution pour ouvrir l'inspecteur et voir :

• Entrée — les variables résolues que ce nœud a reçues.
• Sortie — le résultat qu'il a produit.
• Erreur — le cas échéant, avec un message lisible.

Déboguer une exécution échouée

Commencez par le premier nœud en rouge. Lisez sa sortie ou son erreur. Vérifiez les variables d'entrée — la plupart des échecs proviennent d'une référence cassée vers un nœud précédent ou de données vides là où une valeur était attendue.

Créer des workflows avec VelaxAI

VelaxAI inclut un agent spécialisé qui génère des workflows à partir du langage naturel. L'utilisateur décrit ce qu'il souhaite automatiser et VelaxAI propose un workflow complet : nœuds, connexions, conditions, et, lorsque nécessaire, le code des nœuds Exécuter du code.

Ce que vous pouvez faire :

• Décrire votre besoin dans une conversation.
• Demander des modifications sur la proposition initiale.
• Vérifier et modifier manuellement le code généré dans les nœuds Exécuter du code.
• Ajuster le déclencheur (programmation, intervalle).
• Activer le workflow lorsque vous êtes satisfait.

Génération en évolution

La génération avec VelaxAI continue de s'améliorer. Les workflows très complexes peuvent nécessiter des ajustements manuels après la génération initiale — VelaxAI vous indiquera ce qui manque ou ce qu'il faut valider.

Plus sur VelaxAI dans VelaxAI.

Bonnes pratiques et limites

• Activez HITL lorsque le workflow modifie des données sensibles (prix, titres, descriptions, budgets de campagne). Cela vous donne un point de contrôle avant que la modification n'atteigne Amazon.
• Vérifiez le coût estimé avant d'activer un workflow programmé, surtout s'il itère sur tout le catalogue. Une exécution manuelle préalable vous indique le coût réel.
• Commencez en pause. Lancez le workflow manuellement une fois pour valider le résultat, puis seulement activez le cron.
• Les exécutions échouées ne se relancent pas seules. Si une exécution échoue, ouvrez l'historique, identifiez le nœud en erreur, corrigez la cause et relancez manuellement.
• Pour les audits massifs, préférez les modèles — ils sont optimisés pour traiter de grands catalogues avec traitement par lots et gestion des erreurs par élément.