Docs

Engine Builder

The Engine Builder is where you design a conversation visually. You lay out phases on a canvas, fill them with cards, wire logic gates between them, and choose where the chat begins. This is the full reference.

Un moteur est une conversation, conçue comme un diagramme. Vous le construisez sur un canevas à partir d'une poignée de pièces, vous le testez dans le simulateur, puis vous le publiez. Cette page couvre chaque partie du constructeur. Si vous débutez, parcourez d'abord Personas : tout moteur tourne en incarnant un persona.

Concepts de base

Quelques mots reviennent partout dans le constructeur. Apprenez-les et le reste se met en place.

  • Phase: une étape de la conversation. Une phase, c'est un message d'ouverture (la façon dont l'IA lance cette étape) plus un deck de cartes qu'elle peut jouer tant que la conversation reste dans cette phase. Un moteur typique compte quelques phases : une ouverture à froid, une mise en confiance, une invitation.
  • Deck: l'ensemble des cartes attachées à une phase. À chaque tour, le moteur joue une carte du deck, choisie par tirage aléatoire pondéré : la même phase ne se ressemble jamais tout à fait.
  • Carte: un seul mouvement : discuter, poser une question, envoyer une photo, déposer un lien, conclure. Chaque carte a ses propres réglages (voir la référence des cartes plus bas).
  • Porte / transition: une règle qui fait passer la conversation d'une phase à une autre, ou qui déclenche une réaction. Certaines portes sont en ligne entre deux phases ; d'autres flottent et observent toute la conversation.
  • Fait: un détail que le moteur apprend sur le lead (son prénom, sa ville, ses centres d'intérêt). Les faits sont extraits du chat au fil de l'eau et peuvent être réinjectés dans les messages via un tag.
  • Points de départ: les nœuds qui indiquent où commence une conversation : l'IA écrit en premier, l'utilisateur écrit en premier, ou un événement externe.
  • Observateurs flottants: des portes qui ne sont pas câblées entre deux phases précises. Elles observent toute la conversation et se déclenchent dès que leur condition est remplie (par exemple, un fait apparaît, ou le lead accepte un lien).

Le canevas

Le constructeur est un canevas zoomable, fait de nœuds reliés par des arêtes. Vous faites glisser des pièces depuis le côté, vous déposez des cartes sur les phases et vous tracez des lignes pour câbler le flux.

Palette de nœuds

  • Départ: les nœuds de démarrage de conversation (Ouverture IA, Message entrant, Déclencheur d'événement).
  • Phases: ajoute un nouveau nœud de phase sur le canevas.
  • Règles: les portes logiques et les observateurs que vous câblez entre les phases ou autour d'elles.

Bibliothèque de cartes

La bibliothèque de cartes liste tous les types de cartes. Faites glisser une carte sur une phase pour l'ajouter au deck de cette phase. Un même type de carte peut apparaître dans plusieurs phases avec des réglages différents.

Câbler les arêtes

Faites glisser depuis la poignée de sortie d'un nœud vers un autre nœud pour créer une arête. Les arêtes sont ce qui permet à un point de départ d'atteindre sa première phase et aux portes de faire avancer le chat.

Réorganisation automatique

Les graphes câblés à la main deviennent vite illisibles. Le bouton Réorganiser (la baguette, en haut à droite du canevas de flux) redispose tout le graphe en une mise en page nette de gauche à droite, sans nœuds qui se chevauchent, puis l'ajuste à la vue. Les nouvelles positions sont enregistrées quand vous enregistrez le moteur. Lancez-le avant de terminer n'importe quel moteur.

Types de cartes

Les cartes sont les mouvements qu'un moteur peut faire à l'intérieur d'une phase. Voici les types intégrés, sous leurs noms dans la bibliothèque :

  • Discussion informelle (CHAT): message libre. C'est la seule carte qui respecte pleinement vos Instructions personnalisées : c'est donc votre cheval de bataille pour piloter la formulation.
  • Chercheur de faits (PROBE): demande le prochain fait manquant, en ciblant automatiquement le détail dont le moteur a encore besoin.
  • Envoyer une photo (PHOTO): envoie la photo la plus adaptée du coffre du persona, choisie automatiquement d'après la description de chaque photo.
  • Photo de preuve (VERIFICATION): demande au lead d'envoyer une photo de preuve / vérification de lui-même.
  • Déposer le lien (LINK_DROP): dépose votre lien de funnel. Nécessite une URL de funnel définie dans les réglages globaux.
  • Terminer / Conclure (CLOSE): conclut et met fin à la conversation.
  • Réagir (REACT), Taquiner / Flirter (TEASE), Se confier (SHARE), Faire écho (RELATE): de petites répliques intégrées qui gardent une conversation humaine. Voir le piège ci-dessous : ces quatre cartes jouent une ligne figée.

Attention

Réagir, Taquiner / Flirter, Se confier et Faire écho jouent une ligne intégrée figée et ignorent le champ Instructions. Tout ce que vous tapez dans ces quatre cartes (et tous les tags) est inutilisé. S'il vous faut une formulation sur mesure, utilisez plutôt une carte Discussion informelle .

Portes et transitions

Les portes décident quand la conversation avance ou réagit. Il en existe deux formes : les compteurs en ligne câblés entre deux phases, et les observateurs flottants qui surveillent tout le chat.

Compteur en ligne

  • Après N messages (MESSAGE_COUNT): câblé phase → porte → phase. Il compte les tours et fait avancer la conversation une fois le seuil atteint. Le seuil va de 1 à 20. C'est la façon standard de faire progresser un chat à travers ses phases.

Observateurs flottants

  • Vérification de fait (FACT_EXISTS): se déclenche quand un fait précis a été extrait de la conversation.
  • Vérificateur de conversion (CONVERSION_CHECK): se déclenche selon que le lead a accepté ou rejeté le dernier lien que vous avez déposé.
  • Détecteur de signal (DETECTOR): un observateur interne qui sous-tend la défense contre les accusations de bot. Il n'est pas proposé dans la palette ; vous ne le placez pas vous-même.

Points de départ

Tout moteur doit savoir comment un chat commence. Ajoutez un ou plusieurs nœuds de départ et câblez chacun vers la phase où ce chemin démarre.

  • Ouverture IA / Prise de contact: l'IA envoie le premier message (prise de contact à froid). À utiliser pour les funnels proactifs.
  • Message entrant / Défaut: l'utilisateur écrit en premier (le DM entrant normal). Un moteur doit avoir exactement un départ Message entrant / Défaut.
  • Déclencheur d'événement: démarre un chat quand un événement externe précis se produit. Il lui faut un id d'événement (par exemple, story_reaction).
  • Relance: relance un lead devenu silencieux et le ramène dans la conversation.

Attention

Les tags de prompt ne sont pas remplacés sur l'Ouverture IA. Un {name} tapé dans l'ouverture s'afficherait littéralement au lead. Rédigez l'Ouverture IA en toutes lettres.

Faits et l'onglet Connaissances

L'onglet Connaissances est l'endroit où vous gérez les faits que le moteur collecte. Il en existe deux sortes :

  • Faits système: des détails intégrés que le moteur essaie toujours d'apprendre (comme le prénom et la localisation du lead).
  • Faits personnalisés: vos propres champs, spécifiques à votre funnel.

Chaque fait est affecté à une phase: l'étape pendant laquelle le moteur doit essayer de l'apprendre. La carte Chercheur de faits poursuit ensuite le fait encore manquant pour la phase en cours.

Attention

Chaque fait appartient à exactement une phase. Si vous voulez que le moteur apprenne quelque chose à une autre étape, déplacez le fait. Vous ne pouvez pas l'affecter à deux phases à la fois.

L'inspecteur de nœud

Cliquez sur un nœud pour ouvrir l'inspecteur à droite. Ce que vous pouvez modifier dépend du nœud, mais les champs communs sont :

  • Instructions / directive: des consignes en langage clair sur ce que l'IA doit faire. Sur une carte, cela pilote le message ; sur une phase, c'est la raison d'être de la phase. (Rappel : les quatre cartes rapides l'ignorent.)
  • Ouverture de phase: le message d'ouverture d'une phase : comment l'IA démarre la conversation quand elle entre dans cette étape.
  • Limite d'utilisation (0–20): le nombre maximum de fois qu'une carte peut être jouée dans une conversation. 0 signifie illimité.
  • Attente entre deux utilisations: combien de tours attendre avant qu'une carte puisse être rejouée, pour éviter les répétitions coup sur coup.

Tags de prompt

Dans les Instructions d'une carte, vous pouvez taper un tag et le moteur y substitue la vraie valeur avant l'envoi du message. Les tags disponibles :

Détails du persona

  • {name}: le nom du persona
  • {age}: l'âge du persona
  • {origin}: d'où vient le persona
  • {city}: la ville du persona
  • {job}: le métier du persona
  • {hobbies}: les loisirs et centres d'intérêt du persona
  • {bio}: la bio du persona
  • {style_tags}: les traits de style d'écriture du persona
  • {time}: l'heure actuelle, pour que le persona parle comme le matin ou le soir

Votre funnel

  • {platform}: l'app sur laquelle vous échangez
  • {funnel_platform}: votre plateforme de funnel ou de destination

Actions

  • {photo}: envoie la photo la plus adaptée du coffre, choisie automatiquement d'après sa description
  • {link}: dépose votre lien de conversion, avec le contournement des filtres appliqué

Spécifiques à la carte

  • {fact}: sur une carte Chercheur de faits : le prochain détail à découvrir sur le lead
  • {vibe}: sur une carte Envoyer une photo : l'ambiance photo du moment, décontractée ou piquante
  • {context}: sur une carte d'entrée / d'ouverture : le premier message entrant auquel l'ouverture réagit

Réglages globaux et d'identité

Les réglages valables pour tout le moteur se trouvent dans l'onglet Identité / réglages globaux :

  • Plateforme de messagerie: l'app sur laquelle tourne la conversation (alimente le tag {platform} ).
  • Limite de tours (1–100, 60 par défaut): le nombre maximum de tours avant l'arrêt de la conversation.
  • Bulles de message max (1–5): en combien de bulles distinctes une même réponse peut être découpée.
  • Plateforme de funnel: votre plateforme de destination (alimente {funnel_platform}).
  • URL du funnel: le lien qu'envoie la carte Déposer le lien.
  • Masquage du lien: appliqué automatiquement pour contourner les filtres de liens au moment du dépôt.
  • Valeur de lead: ce que vaut un lead converti, utilisé par les analytics pour estimer le chiffre d'affaires.

Refus et défense anti-bot

Vous pouvez scénariser la façon dont le moteur gère les moments délicats : un lead qui se braque, ou qui accuse l'IA d'être un bot. Chaque scénario associe un déclencheur à une réponse, qui peut être un texte ou une image, pour que la conversation se rattrape avec élégance au lieu de caler.

Validation et publication

Le constructeur vérifie votre moteur au fil du travail et signale les soucis dans le panneau Problèmes. Deux niveaux comptent :

  • Les erreurs bloquent la publication. Vous ne pouvez pas publier un moteur qui échoue à la validation.
  • Seules les erreurs de limite dure bloquent l'enregistrement. Vous pouvez enregistrer un travail en cours qui présente encore des problèmes plus légers, et y revenir plus tard.
  • Le panneau Problèmes saute au nœud quand vous cliquez sur un souci, pour le corriger sur place.

Attention

Une phase doit avoir au moins une carte et un message d'ouverture. Une phase vide ne passera pas la validation.

Attention

Les portes et les nœuds de départ ne peuvent pas être renommés. Seuls les phases et les déclencheurs d'événement acceptent un nom personnalisé : laissez le constructeur nommer automatiquement tout le reste.

Attention

Publier sur le marketplace exige une validation totalement propre: c'est plus strict que l'enregistrement. Effacez chaque erreur du panneau Problèmes avant de publier.

Gestion des moteurs et marketplace

  • Nouveau: démarrer un moteur tout neuf sur un canevas vierge.
  • Copier (cloner): dupliquer un moteur existant pour itérer sans toucher à l'original.
  • Renommer: renommer un de vos propres moteurs.
  • Supprimer: retirer un moteur qui vous appartient.
  • Publier / dépublier: partager un moteur propre sur le marketplace, ou le retirer.

Étapes suivantes

Une fois un moteur construit, vous êtes prêt à le mettre au travail. Renseignez-vous sur le persona qu'il incarne dans Personas, partez d'un funnel éprouvé dans les modèles du Marketplace, faites-le tourner à blanc dans Tests et simulateur, et connectez-le en production avec Mise en production.

Engine Builder: FluidTalk Documentation | FluidTalk