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

Certaines actions sont affichées uniquement quand elles sont compatibles avec le déclencheur courant et les capacités activées sur l'instance. Par exemple, les actions Tavily nécessitent un fournisseur web configuré, les actions de projet nécessitent au moins un projet accessible, et les actions IA nécessitent des modèles disponibles.

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

Projet

Le nœud Projet regroupe les actions projet courantes dans un seul sélecteur : Créer, Insérer ou Rechercher.

Sous-action Créer

Crée un projet à partir des données de l'automatisation.

Paramètres clés

Sortie

• project_id — identifiant du projet créé, utilisable par les actions suivantes.

Sous-action Insérer

Ajoute un document dans un projet existant ou dans un projet créé plus tôt dans la même automatisation.

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

Sous-action Rechercher

Recherche dans les documents d'un projet précis et produit une réponse avec sources.

Paramètres clés

Sortie

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

Subtilité — un bouton Optimiser la requête peut reformuler la question pour améliorer la recherche, puis vous laisser accepter ou refuser la version proposée.

Insérer fichiers dans projet

Copie les fichiers reçus par un formulaire ou un email comme documents sources permanents dans un projet.

Paramètres clés

Sortie

• Références des fichiers copiés dans le projet.

Utilisez cette action quand les fichiers doivent rester disponibles dans le projet après l'exécution. Pour une analyse ponctuelle sans conservation, préférez Fichiers et base temporaire.

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

Interroge les documents reçus par un formulaire ou un email. Le nœud peut travailler sur un fichier précis, tous les fichiers d'un champ multi-fichiers ou tous les documents disponibles.

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 aucun champ compatible n'est disponible, le sélecteur affiche un message d'avertissement. Ajoutez un déclencheur Formulaire avec champ fichier / multi-fichiers, ou un déclencheur Email avec téléchargement des pièces jointes.

Base de connaissances temporaire

Ajoute un corpus éphémère utilisable pendant l'exécution en cours. Ce corpus peut ensuite être interrogé par un Agent.

Sources disponibles

Sortie

• Ajoute les documents au corpus temporaire du run. Le nœud ne renvoie pas directement une réponse : utilisez ensuite un Agent avec l'option Base de connaissance temporaire activée.

Voir Fichiers et base temporaire pour choisir entre analyse temporaire, document Hub, projet ou base durable.

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 ("vrai si le statut HTTP indique un succès")
  ├── Vrai → Générer du texte (résumé du lead)
  └── Faux → 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)

Tavily Search

Recherche le web avec Tavily et retourne des résultats structurés, éventuellement accompagnés d'une réponse synthétique.

Paramètres clés

Sortie

• results — liste de résultats web.
• answer — réponse synthétique si demandée.

Tavily Extract

Extrait le contenu propre d'une ou plusieurs pages connues.

Paramètres clés

Sortie

• Pages extraites avec URL, titre et contenu.

Tavily Crawl

Explore un site depuis une URL racine et extrait plusieurs pages.

Paramètres clés

Sortie

• Liste de pages crawlées avec leur contenu.

Voir Recherche web pour choisir entre Serper, Tavily Search, Tavily Extract et Tavily Crawl.

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 décision vraie ou fausse.

Panneau de configuration d'un nœud Condition

Paramètres clés

Sortie

• Pas de variables — uniquement un branchement : la branche Vrai exécute les nœuds connectés à la sortie Vrai, la branche Faux ceux connectés à la sortie Faux.

Subtilités

• Formulez une condition qui peut être résolue strictement par vrai ou faux.
• Citez les données à évaluer avec @, par exemple le statut d'une requête HTTP ou le texte généré par une étape précédente.
• Si la décision doit être déterministe, gardez une consigne courte et explicite.

Exemple

Réponds vrai si @Requête HTTP.status indique un succès HTTP.
Réponds faux sinon.

Boucle

Exécute un sous-workflow pour chaque élément d'une liste.

Paramètres clés

Sortie

• Résultats des sous-workflows exécutés.

Voir Boucles et sous-workflows pour configurer le workflow parent et le déclencheur Workflow du sous-workflow.

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 les autres actions documentaires :

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

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

Trigger Formulaire (champs : "brief" [file], "cctp" [file])
  ↓
Base de connaissances temporaire (tous les documents du formulaire)
  ↓
Agent (base temporaire activée)
  ↓
Créer un document ou Envoyer un email

Pour une question très ciblée sur un document, remplacez l'agent par Interroger un document avec la portée adaptée.

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.
• Fichiers et base temporaire — choisir le bon stockage documentaire.