L’Exécution des blocs

1. Présentation

L’Exécution des Blocs est l’action réalisée sur un bloc pour le passer de son état initial à un contenu généré dans l’Interface de publication. Quand un bloc est exécuté, il prend en compte les attributs assignés à la publication pour accomplir sa destinée.

Avant d’aller plus loin, il est important de comprendre le fonctionnement global de Thinkeo :

Le Wizard permet d’assigner des attributs et/ou des valeurs d’attributs à la publication
Ces attributs déterminent le comportement des blocs et les alimentent en contenu
Les blocs sont exécutés et génèrent un document en temps réel sur l’Interface de publication

Autrement dit, durant l’exécution, un bloc choix pourra sélectionner la variante qui correspond aux attributs assignés à la publication, un bloc condition deviendra visible ou masqué et un bloc IA changera son prompt en un texte généré en temps réel.

A chaque fois que l’Utilisateur clique sur “Suivant” dans son Wizard pour valider une Étape, une exécution des blocs est lancée.

⚠️ Dans Thinkeo, tous les blocs sont à exécuter avant la fin d’une publication. Certains le seront automatiquement et d’autres devront être déclenchés manuellement à travers une Étape du Wizard. L'approche la plus simple est d'executer toute votre App en une seule fois sur l'étape précédent l'étape Fin de votre Wizard.

Pourquoi tous les blocs ne s’exécutent pas tout seul ?

Certains blocs comme les blocs IA doivent être exécutés au bon moment durant le parcours de publication car ils auront besoin que l’Utilisateur ait saisi suffisamment d’informations pour que le Prompt soit complet. S’il est exécuté trop tôt alors le contenu généré ne sera pas pertinent ou il sera incomplet.

💡 Quand un bloc Parent est exécuté, tous ses blocs Enfants sont exécutés avant automatiquement. Il est ainsi facile de piloter l’exécution manuelle des blocs en choisissant les blocs Parents plutôt que leurs Enfants.

Il est nécessaire d’avoir des Étapes bloquantes avec l’option “Attendez que tout soit exécuté” activée pour s’assurer que les blocs enfants déclenchés manuellement ont terminé leur exécution avant de déclencher celle de leur bloc parent.

2. Spécificités

Détaillons maintenant les points à bien comprendre pour bien mettre en œuvre l’exécution.

On va donc répondre aux questions suivantes :

Quels sont les blocs à exécuter manuellement ?
Quand les exécuter au meilleur moment ?
Comment les exécuter simplement et efficacement ?

2.1 Quels sont les blocs à exécuter manuellement ?

Commençons par identifier les blocs qui s’exécutent automatiquement à chaque validation d’Étape, donc chaque fois que l’Utilisateur appuie sur le bouton “Suivant” durant son parcours de publication.

On distingue les blocs simples des blocs avancés, les premiers sont ceux exécutés automatiquement à chaque étape et les seconds ceux qui doivent être déclenchés manuellement.

Blocs simples


Les blocs simples exécutés automatiquement à chaque étape sont :

Bloc Groupe
Bloc Choix
Bloc Condition
Bloc Paragraphe

Vous l’aurez compris, tous ces blocs sont autonomes dans leur fonctionnement, ils sont exécutés à chaque étape jusqu’à ce que les attributs assignés durant le parcours de publication déterminent ce qu’ils doivent faire.

Par exemple :

Un bloc Condition va ainsi vérifier qu’il doit rester visible ou non selon les attributs ou valeurs d’attributs qui viennent d’être assignés sur l’étape.
Un bloc Paragraphe va actualiser son contenu pour remplacer une variable comme “Nom du client” par la valeur qui vient d’être saisie par l’Utilisateur.
Un bloc Choix va déterminer quelle variante il doit afficher selon les attributs ou valeurs d’attributs qui viennent d’être assignés sur l’étape.

Maintenant, identifions les blocs avancés, nécessitant une exécution manuelle.

Blocs avancés


Les blocs à exécuter manuellement en les assignant sur une Étape du Wizard sont :
Bloc IA
Bloc Fichier
Bloc Recherche
Bloc Word
Bloc Appel d'API

Le bloc IA aura besoin que tous les éléments de son prompt soient renseignés, il peut s’agir de variables et/ou de blocs imbriqués selon votre paramétrage.

Le bloc Recherche devra être exécuté une seule fois après le téléversement du fichier pour alimenter l’Attribut Fichier auquel il est associé, tous les autres blocs Recherche pourront être exécutés automatiquement via l’exécution des blocs IA parents.

Le bloc Word devra être exécuté lors de l’avant-dernière Étape, l’Étape Message qui précède l’étape Fin. Cela permettra de générer un lien sur l’interface de publication pour que l’Utilisateur puisse récupérer son document.

2.2 Quand les exécuter au meilleur moment ?

De manière générale, nous recommandons d'exécuter toute l'App en une seule fois juste avant votre étape Fin.

Si votre questionnaire est long et/ou votre App complexe, alors il devient pertinent de déclencher progressivement l'exécution de vos blocs au fil des étapes. Là aussi, privilégiez l'exécution de blocs parents pour que tous les blocs enfants s'exécutent automatiquement.

Pour le bloc IA, il vous faut attendre que tous les éléments de son Prompt soient disponibles.

Pensez donc à vérifier que les éléments suivants sont bien renseignés avant de déclencher son exécution sur une Étape :

Toutes les variables présentes dans le Prompt ont été saisies par l’Utilisateur
Tous les attributs nécessaires aux blocs enfants du bloc IA ont bien été assignés durant le parcours de publication

Pour le bloc Recherche, vous devez ajouter UN SEUL bloc Recherche lors de l’Etape “Upload de fichiers”, Il commencera ainsi le découpage des fichiers pour les rendre disponibles aux autres blocs Recherche.

Le bloc Doc (Export Word) devra être exécuté lors de l’avant-dernière Étape du parcours.

2.3 Comment les exécuter simplement et efficacement ?

En suivant les indications mentionnées plus haut dans ce document, vous avez déjà les clés pour exécuter les blocs au bon moment. Il reste encore un point pour maitriser complètement l’exécution des blocs, il s’agit de tirer parti de la hiérarchie des blocs.

Quand on exécute un bloc parent, il va automatiquement exécuter les blocs enfants en dessous de lui, sauf si un de ses blocs enfants est déjà en cours d’exécution manuelle.

Pensez donc à :

Rendre l’étape qui va exécuter un bloc parent comme “bloquante” pour vous assurer que ses blocs enfants sont soit déjà finis d’exécuter, soit prêts à être exécutés.
Exécuter les blocs parents plutôt que les enfants, pour que les exécutions s’enchainent facilement sans avoir à spécifier manuellement l’exécution de chaque bloc Recherche ou IA.

Dans cet exemple, on a assigné sur une Etape le bloc “AI - Job Flex - Missions” pour qu’il soit exécuté.



Dans l’ordre, il va donc automatiquement :

Exécuter le bloc Paragraphe imbriqué dans le bloc Recherche “RAG - Missions fiche de poste”
Exécuter les blocs du niveau au-dessus, donc le bloc Recherche “RAG - Missions fiche de poste”, et les blocs Paragraphes.
Exécuter le bloc Conditionnel et le Bloc choix. Le bloc Conditionnel affichera ou non ses blocs enfants déjà exécutés, et le bloc Choix affichera la bonne variante parmi les deux blocs enfants exécutés.
Exécuter le bloc IA parent qui va pouvoir utiliser tous les blocs imbriqués visibles et exécutés pour générer le contenu.

L’exécution se fera toujours du bas vers le haut, du bloc enfant le plus éloigné vers le bloc parent le plus haut

Dans cet exemple, nous n’avons donc pas eu besoin d’exécuter le bloc Recherche, seul le parent suffit.

Nous aurions aussi pu exécuter un bloc Groupe situé plus haut dans l’arborescence pour déclencher toute une section, il est même possible de déclencher toute une App en en une seule fois en exécutant le bloc Groupe qui contient l’ensemble de l’App.

Durant vos paramétrages, pensez à toujours exécuter manuellement le moins de blocs possibles en choisissant les bons blocs parents et à utiliser régulièrement l’option “bloquante” des Étapes pour vous assurer que les exécutions de blocs en cours sont terminées avant de lancer une exécution manuelle de bloc.

Mis à jour le : 31/01/2025