Aller au contenu principal

Concepts clés

Fondamentaux

Avant de construire, prenez deux minutes pour assimiler le vocabulaire. Tout le système repose sur cinq notions.


Workflow​

Un workflow est une automatisation complète : un déclencheur, suivi d'une chaîne de nodes reliés par des flèches. C'est l'unité que vous créez, activez et désactivez.

Un workflow a un état :

ÉtatSignification
BrouillonEn cours de construction, jamais exécuté automatiquement.
ActifLe déclencheur est armé : le workflow se lance dès que la condition se présente.
En pauseConservé mais désarmé : il ne se déclenchera plus tant que vous ne le réactivez pas.

Node​

Un node est une étape unique du workflow. Chaque node a :

  • un type (ex. agent.writer, cms.webflow.blog, approval.request) ;
  • une configuration (quelle page modifier, quel ton adopter, quel destinataire prévenir) ;
  • des entrées (ce qu'il reçoit du node précédent) et des sorties (ce qu'il transmet au suivant).

Les nodes se rangent en cinq familles : déclencheurs, agents IA, actions GEO, logique, approbations/notifications — plus les nodes CMS propres à chaque connecteur. La référence des nodes détaille chacun d'eux.

Un seul déclencheur, plusieurs actions

Tout workflow commence par exactement un déclencheur. Ensuite, vous pouvez enchaîner autant de nodes d'action que nécessaire, y compris des branches parallèles.


Déclencheur​

Le déclencheur (trigger) est le node de départ. Il décide quand le workflow s'exécute. Trois grandes catégories :

  • Manuel — vous lancez le workflow vous-même depuis le dashboard.
  • Planifié — selon un calendrier récurrent (« tous les lundis 9h », « le 1er du mois »).
  • Événementiel — en réaction à un événement GEO (audit terminé, score qui chute, concurrent détecté, bot IA qui visite une page, publication CMS, webhook entrant).

Voir la liste complète dans Déclencheurs.


Exécution (run)​

Chaque fois qu'un workflow se lance, CiteMe crée une exécution (ou run). Une exécution avance node par node et garde une trace de tout : ce que chaque node a reçu, produit, et combien de temps il a pris.

Une exécution passe par différents statuts au cours de sa vie :

StatutSignification
En fileEn attente d'un worker disponible.
En coursLes nodes s'exécutent les uns après les autres.
En attente de validationUn node d'approbation a mis le workflow en pause (voir Approbations).
En sommeilUn node « Attendre jusqu'à une date » a suspendu l'exécution ; elle reprendra seule.
TerminéTous les nodes atteignables ont fini avec succès.
ÉchouéUn node a rencontré une erreur bloquante.
AnnuléVous avez stoppé l'exécution manuellement.

Le détail de chaque exécution se consulte dans Exécutions & monitoring.


Variables​

Les nodes ne sont pas isolés : un node peut réutiliser ce qu'un node précédent a produit. On référence ces valeurs avec des variables, écrites entre doubles accolades.

SyntaxeCe qu'elle désigne
{{trigger.payload.url}}Une donnée fournie par le déclencheur.
{{node_n2.output.markdown}}La sortie d'un node précédent (ici le node n2).
{{loop.item}}L'élément courant dans une boucle « pour chaque ».

Exemple — un node de publication Webflow qui reprend le titre et le corps rédigés par l'agent au node n2 :

Titre : {{node_n2.output.title_tag}}
Corps : {{node_n2.output.markdown}}
astuce

Vous n'avez pas à mémoriser les noms de variables : le builder vous propose les sorties disponibles des nodes en amont quand vous remplissez un champ.


La suite​

Maintenant que le vocabulaire est posé, découvrez le builder visuel où vous assemblez concrètement ces nodes.