Actions

Une action est une étape exécutée par le moteur d'automatisation. Cette page liste chaque type d'action, ses paramètres, ses sorties, et les patterns de chaînage typiques. Pour la vue d'ensemble de l'automatisation (déclencheur, variables, exécution), voir Concepts.

Anatomie d'un nœud

Tous les nœuds partagent quelques notions :

• Libellé — nom personnalisé du nœud, distinct de son type (ex: « Lecture du brief client » au lieu de « Générer du texte »). C'est ce libellé que vous voyez dans le canevas.
• Configuration — les paramètres spécifiques au type d'action. Apparaissent dans le panneau de droite quand vous sélectionnez le nœud.
• Sortie(s) — les variables produites par le nœud, accessibles aux étapes suivantes. Tapez @ dans n'importe quel champ de configuration pour faire apparaître la liste des nœuds amont et leurs sorties, puis sélectionnez celle voulue — la référence est insérée comme un badge. Détails : Variables et templates.
• Politique d'erreur — chaque nœud permet de configurer ce qui se passe en cas d'échec (réessayer, ignorer, arrêter l'automatisation).

Sélectionner une action

Génération IA

Toutes les actions de cette catégorie utilisent la passerelle LLM intégrée — pas d'intégration externe à configurer côté utilisateur. Les modèles disponibles dépendent de la configuration de l'instance par votre administrateur.

Générer du texte

L'appel LLM le plus simple : un prompt en entrée, un texte en sortie.

Panneau de configuration d'un nœud Générer du texte

Quand l'utiliser

• Reformuler, résumer, traduire un texte.
• Générer du contenu depuis une consigne libre.
• Première étape d'une chaîne plus complexe.

Paramètres clés

Sortie

• text — le texte généré.

Subtilités

• Le prompt subit un wrapping automatique selon le format de sortie : si vous choisissez markdown, une instruction est ajoutée au début et un rappel à la fin pour garantir le rendu.
• Le bouton Aperçu (icône Play) lance un test live en utilisant les sorties simulées des nœuds amont — pratique pour valider un prompt avant d'exécuter toute l'automatisation.

Synthèse chronologique

Variante du nœud Générer du texte pour les gros inputs. Le texte est découpé en blocs, chaque bloc est traité séparément, puis les sorties sont concaténées (avec contexte glissant).

Quand l'utiliser

• Synthèse d'une transcription longue (réunion de 2h).
• Analyse d'un document trop volumineux pour tenir dans le contexte d'un modèle classique.
• Production d'un résumé section par section qui préserve l'ordre temporel.

Paramètres clés

Sortie

• text — la concaténation des sorties chunk par chunk.

Subtilités

• Plus de chunks = plus d'appels LLM = plus de tokens consommés. Calibrez la Taille de chunk au plus grand possible pour le modèle choisi.
• Le résultat n'est pas une synthèse globale : c'est une concaténation. Pour obtenir un résumé final, chaînez avec un nœud Générer du texte classique sur la sortie.

Générer une image

Génération d'une image à partir d'un prompt.

Paramètres clés

Sortie

• imageUrl — URL de l'image générée.

Pattern courant — dans une automatisation déclenchée par un projet, chaîner avec un nœud Insérer dans projet pour ajouter l'image dans un document du projet.

Générer un diagramme

Demande à l'IA de produire du code Mermaid (flowchart, gantt, sequence, class, ER, state, timeline, mindmap).

Paramètres clés

Sortie

• text — code Mermaid prêt à être inséré.

Pattern courant — dans un workflow déclenché par un projet :

Générer un diagramme (type=flowchart)
  ↓
Insérer dans projet (contentType=mermaid)

Le code Mermaid produit est inséré directement dans un document du projet sous forme de bloc diagramme rendu.

Agent

Invoque un agent existant (créé via l'app Agents IA) ou configure un agent inline dans le nœud.

Mode existing

Mode inline

Sortie

• text — la réponse de l'agent.
• trace_id — identifiant pour retrouver les détails (voir Discuter avec un agent).
• tokens_used, duration_ms, model.

Subtilité — préférez le mode existing quand l'agent est réutilisé dans plusieurs automatisations : centraliser sa configuration évite la dérive. Le mode inline est pratique pour un usage unique ou pour expérimenter avant de figer l'agent.

Documents et RAG

Base de connaissance

Deux sous-actions sélectionnées via le champ Action au-dessus du nœud :

Sous-action Rechercher

Interroger une base de connaissances avec une requête (RAG).

Paramètres clés

Sortie

• text — réponse rédigée par le LLM avec citations.
• sources — liste des passages utilisés (avec score de pertinence).

Sous-action Insérer

Ajouter du contenu généré par l'automatisation comme nouveau document de la base de connaissances (avec indexation automatique).

Paramètres clés

Sortie

• documentId — l'ID du document créé.

Recherche dans projet

Recherche RAG sur les documents d'un projet précis.

Paramètres clés

Sortie

• text — réponse synthétique avec citations.
• passages — passages bruts trouvés.

Subtilité — un bouton Optimiser la requête (icône Sparkles) est disponible : il appelle un LLM pour reformuler votre requête en version plus précise avant la recherche. Utile quand l'utilisateur final saisit une question vague.

Insérer dans projet

Crée ou étend un document BlockNote dans un projet.

Panneau de configuration d'un nœud Insérer dans projet, avec le sélecteur de contentType markdown / mermaid / blocks

Supporte trois types de contenu :

Paramètres clés (markdown)

Paramètres clés (mermaid)

Subtilité de configuration — au sein d'une automatisation à déclencheur Projet, le champ Append to document permet d'enrichir un document existant plutôt que d'en créer un nouveau. Pour les diagrammes Mermaid, le Type et le Libellé du diagramme sont obligatoires.

Analyser les fichiers du formulaire

Spécifique aux automatisations avec déclencheur Formulaire. Récupère les fichiers uploadés via le formulaire et les indexe comme documents RAG éphémères (durée de vie 24h).

Panneau de configuration du nœud Analyser les fichiers du formulaire, avec la liste de cases à cocher des champs fichier détectés

Paramètres clés

Sortie

• Indexe les fichiers, prépare les documents RAG éphémères. Ne retourne pas directement le texte des fichiers — chaînez avec un nœud Interroger un document en aval pour les exploiter.

Subtilités fortes

• Aucun champ coché est interprété comme « analyser tous les champs fichier du formulaire ». L'UI distingue le cas « jamais touché » (défaut implicite) du cas « décoché manuellement » via un bandeau d'info, mais le résultat stocké est le même : fields: [].
• TTL 24h : les documents indexés sont supprimés automatiquement après 24h. Conçu pour les analyses ponctuelles, pas pour de l'archivage.
• Aucun lien direct vers une base de connaissances existante : les documents restent limités à cette automatisation.

Pattern de chaînage obligatoire

Ce nœud est inutile seul. Le pattern canonique :

Trigger Formulaire (champ fichier "cctp" + champ fichier "offre")
  ↓
Analyser les fichiers du formulaire (coche cctp + offre)
  ↓
Interroger un document (fieldName: "cctp", prompt: "Résumé en 3 points")
  ↓
Interroger un document (fieldName: "offre", prompt: "Liste les engagements")
  ↓
Générer du texte (synthèse comparative)

Sans un nœud Interroger un document en aval, le fichier est indexé mais jamais interrogé — l'automatisation ne produit rien d'utile.

Interroger un document

Exécute une requête RAG ciblée sur un seul document, typiquement produit en amont par Analyser les fichiers du formulaire.

Panneau de configuration d'un nœud Interroger un document, avec le sélecteur de champ fichier

Paramètres clés

Sortie

• text — réponse synthétique avec citations.
• sources — passages utilisés.

Subtilité importante — si vous ne placez pas de déclencheur Formulaire en amont ou si le formulaire n'a pas de champ fichier, le sélecteur affiche un message d'avertissement vous demandant d'ajouter un trigger Formulaire avec au moins un champ de type fichier en amont de ce nœud — c'est volontaire, ça vous empêche de configurer un nœud qui ne pourrait pas s'exécuter.

Audio

Transcrire audio

Transcrit un fichier audio en texte.

Paramètres clés

Sortie

• transcript — la transcription textuelle.
• duration_ms, model.

Pattern courant — quand l'audio arrive par un autre canal qu'un trigger Compte rendu (ex: upload via formulaire) :

Trigger Formulaire (champ "audio" [file])
  ↓
Transcrire audio (provider=Whisper, model=large-v3, audio = @Trigger.audio)
  ↓
Générer du texte (synthèse de @Transcrire audio.transcript)

Intégrations externes

Requête HTTP

Effectuer un appel HTTP arbitraire vers une API externe.

Panneau de configuration d'un nœud Requête HTTP, avec méthode, URL, headers et body

Paramètres clés

Sortie

• status — code HTTP de la réponse.
• body — corps de la réponse (parsé en JSON si Content-Type le permet).
• headers — headers de la réponse.

Pattern courant — appeler une API métier puis brancher :

Requête HTTP (GET /api/leads/12345)
  ↓
Condition (@Requête HTTP.status === 200)
  ├── true  → Générer du texte (résumé du lead)
  └── false → Envoyer un email (alerte erreur)

Recherche web

Interroge Google via Serper.dev et renvoie une page de résultats de recherche (SERP) — titres, liens, snippets. Pratique pour alimenter un nœud de génération de texte avec quelques sources fraîches, ou pour vérifier l'existence d'une information avant d'agir.

Paramètres clés

Un bouton Aperçu lance la requête en direct pour visualiser le JSON retourné avant d'exécuter toute l'automatisation.

Sortie

• Réponse Serper brute (objet JSON). Selon le Type de recherche :
  • Web → tableau organic avec title, link, snippet.
  • Actualités → tableau news.
  • Images → tableau images.

Pattern courant — chercher puis synthétiser :

Trigger Manuel + champ "sujet"
  ↓
Recherche web (query = @Trigger.sujet, Type = Actualités, Pays = France)
  ↓
Générer du texte (synthèse à partir de @Recherche web.news)

Envoyer un email

Envoyer un email à des utilisateurs / équipes de l'instance ou à des destinataires externes.

Configuration requise — votre administrateur doit avoir configuré l'intégration Email (clé API Resend / SendGrid, expéditeur par défaut) côté admin. Si ce n'est pas le cas, le nœud échoue à l'exécution.

Paramètres clés

Sortie

• messageId — identifiant de l'envoi (selon le fournisseur).

Subtilité — le From est figé par la configuration de l'instance. Vous ne pouvez pas l'écraser depuis le nœud.

Logique

Condition

Brancher l'exécution selon une expression booléenne.

Panneau de configuration d'un nœud Condition, avec l'éditeur d'expression et l'autocomplétion @Node.field

Paramètres clés

Sortie

• Pas de variables — uniquement un branchement : la branche vrai exécute les nœuds en aval connectés à la sortie true, la branche faux la sortie false.

Subtilités

• L'expression doit être une expression JavaScript valide, pas un pseudo-langage. Égalité stricte ===, opérateurs logiques && ||, accès aux propriétés .field.
• La syntaxe @Node est résolue avant évaluation pour pointer sur les sorties du nœud référencé. Les espaces dans les noms de nœuds sont supportés (ex: @Requête HTTP.body.id).

Documents système

Créer un document

Crée un document dans l'instance à partir de données de l'automatisation, sans le rattacher à un projet ou une base de connaissances précis. Visible dans l'app Hub documentaire.

Paramètres clés

Sortie

• documentId — identifiant du document créé.

Différence avec Insérer dans projet :

Pattern de référence — Analyse de documents soumis par formulaire

Le pattern canonique pour les automatisations déclenchées par un formulaire avec champ fichier :

Trigger Formulaire (champs : "brief" [file], "cctp" [file])
  ↓
Analyser les fichiers du formulaire (parse "brief" + "cctp")
  ↓
Interroger un document (fieldName="brief", prompt="Liste les besoins")
  ↓
Interroger un document (fieldName="cctp", prompt="Liste les contraintes")
  ↓
Générer du texte (synthèse comparative)
  ↓
Envoyer un email (envoi du résultat au demandeur)

Pourquoi Analyser les fichiers du formulaire n'est jamais seul — il indexe sans retourner de texte. Le travail réel se fait dans les nœuds Interroger un document placés en aval.

Et ensuite ?

• Variables et templates — chaîner les sorties d'un nœud aux entrées du suivant.
• Exécuter et tester — valider un workflow et lire ses logs.
• Déclencheurs — point de départ d'un workflow.