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é.

La fenêtre de configuration d'un nœud

L'icône d'engrenage (⚙️) de chaque nœud ouvre sa configuration. Selon le type de nœud, différents onglets apparaissent :

Onglet	Ce qu'il contient
Général	Le nom du nœud — le texte affiché sur le diagramme. Présent sur tous les nœuds
Configuration	Les paramètres propres au type de nœud : la condition, les données de la tâche, l'URL de la requête HTTP…
Filtres	Uniquement sur les boucles Pour chaque avec une source Requête : quels éléments seront itérés. Voir § Filtres de la boucle
Code de réduction	Uniquement sur les boucles Pour chaque qui collectent des résultats : le code qui les agrège. Voir § Code de réduction

Renommer un nœud — modifiez-le dans l'onglet Général. Donnez-lui un nom qui dit ce qu'il fait (« Vérifier le titre », « Notifier sur Slack ») plutôt que le nom générique : les noms apparaissent sur le diagramme, dans l'historique des exécutions et dans les références de variables des autres nœuds, un nom clair se rentabilise donc au moment du débogage. Si vous laissez le champ vide, le nom par défaut est conservé.

Historique des versions

Chaque fois que vous enregistrez un workflow, Epinium archive la version précédente avant de l'écraser. Le bouton Historique des versions ouvre la liste, avec une ligne par version : nom, statut, nombre de nœuds, erreurs de validation et date.

Vous pouvez y Restaurer n'importe quelle version antérieure. La version actuelle est archivée avant la restauration, donc revenir en arrière ne perd rien : si la version récupérée n'était pas la bonne, restaurez la précédente.

À la restauration, le graphe est validé de nouveau. Si la version récupérée comportait des erreurs, le workflow se retrouve avec des erreurs de validation et ne pourra pas être activé avant correction.

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).

Filtres de la boucle

Avec la source en mode Requête, l'onglet Filtres du nœud restreint les éléments qui seront itérés. Sans filtres, la boucle parcourt tous les éléments de la collection.

Les filtres s'organisent en groupes de règles, et la manière de les combiner est l'essentiel :

• Les règles au sein d'un même groupe se combinent avec OU — il suffit qu'une seule soit vraie.
• Les groupes entre eux se combinent avec ET — tous les groupes doivent être vrais.

C'est ainsi que l'on exprime des conditions du type « (marque A ou marque B) et (sans image principale) » : une marque par règle dans le premier groupe, et la condition de l'image dans un second groupe.

Chaque règle a trois parties et un interrupteur :

Partie	À quoi elle sert
Champ	Le chemin de la donnée dans l'élément, par exemple commonFields.ASIN
Valeur	Ce à quoi on la compare
Format	Comment interpréter la valeur : Texte, ObjectId, Booléen, Date ou Existe (nombre) — ce dernier prend les éléments qui ont un nombre dans ce champ
Actif	Désactive la règle sans la supprimer, pratique pour tester

Le format compte

Une même valeur filtre différemment selon le format. true en Texte cherche la chaîne « true » ; en Booléen, il cherche la valeur vraie ; en Existe (nombre), il vérifie que le champ contient un nombre (une enchère maximale configurée, par exemple). Si un filtre ne renvoie pas ce que vous attendez, le format est la première chose à vérifier.

En mode Référence, l'onglet Filtres ne s'applique pas : la boucle itère sur ce qu'a produit un nœud précédent, le filtrage doit donc se faire dans ce nœud.

Code de réduction

Quand la boucle a Collecter les résultats activé, l'onglet Code de réduction permet d'agréger ce que renvoie chaque itération en un seul résultat final.

Il fonctionne par lots (streaming) : le code s'exécute une fois par lot, pas une fois par élément. Il reçoit input.items (le lot en cours) et input.accumulator (le résultat du lot précédent, null pour le premier) et doit renvoyer l'accumulateur pour le lot suivant.

C'est ainsi qu'on obtient les totaux d'un audit — combien de produits sont conformes et combien ne le sont pas — sans garder tout le catalogue en mémoire. Le résultat final est visible sur le nœud, dans l'inspecteur de l'exécution.

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

Sélection des campagnes (Smart Campaigns)

Le workflow Smart Campaigns Optimizer propose, dans son onglet Variables, un contrôle pour décider sur quelles campagnes il agit.

Prendre toutes les campagnes avec un ACOS cible configuré (interrupteur) :

• Activé — le workflow gère automatiquement toute campagne dont l'ACOS/ROAS cible et l'enchère maximale sont configurés.
• Désactivé — sélection manuelle : le workflow n'agit que sur les campagnes que vous choisissez. Lorsque vous ajoutez un nouveau workflow, l'interrupteur démarre désactivé. Il s'enregistre instantanément (sans cliquer sur « Enregistrer les modifications »).

Avec l'interrupteur désactivé, le bouton Campagnes de l'algorithme s'active et ouvre un tableau où, pour chaque campagne (Sponsored Products) :

Colonne	Ce qu'elle fait
Optimiser	Indique si le workflow doit optimiser cette campagne. Activable uniquement si la campagne a un objectif défini.
Objectif	Type d'objectif — ACOS ou ROAS.
Valeur	La valeur cible (p. ex. 25 % d'ACOS).

Le tableau est paginé, dispose d'une recherche et affiche d'abord les campagnes déjà gérées. Les changements sont enregistrés avec le bouton Enregistrer de la fenêtre.

Relation avec les Paramètres IA par campagne

Cocher une campagne ici équivaut à forcer ce workflow depuis les Paramètres IA de la campagne : c'est la même information vue du côté du workflow, et l'objectif que vous modifiez est celui de la campagne.

Si, l'interrupteur désactivé, vous ne cochez aucune campagne, le workflow n'en traite aucune — il n'échoue pas, il n'agit simplement pas tant que vous ne choisissez pas.

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.
Partielle	Terminée, mais certains éléments ont échoué et n'ont pas été traités. Cela apparaît dans les workflows qui itèrent : une campagne qui échoue, par exemple, tandis que les autres sont optimisées normalement.
É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.