L'éditeur d'Apps

1. Présentation

Cette interface réunit tous les éléments nécessaires à la création, le paramétrage et la mise en ligne de vos Apps.

Vous pouvez paramétrer vos Apps à travers plusieurs onglets dans l’éditeur latéral, et naviguer entre vos Apps à travers les onglets en haut de page. Sur l’espace central de la page vous trouverez les Blocs et leurs contenus.

Le volet latéral est composé de quatre onglets, chacun d’eux vous permettra d’ajuster différents éléments sur votre App.

App, l’accueil de votre App
Hiérarchie, l’arborescence de vos blocs
Wizard, l’assistant et son workflow
Réglages, pour les paramètres d’IA

2. App

C’est ici que vous pourrez définir comment se présente votre App et quels sont les Utilisateurs ayant le droit d’y accéder.

Logo et nom de l’App
Cliquez sur le titre de l’App pour le modifier directement, et faites de même pour le logo.
Les images supportées pour le logo sont de type JPEG ou PNG.

Description
Pour présenter brièvement votre App.

Lien public
Il vous permet de générer un lien pour partager votre App en dehors de la plateforme.


Attention à qui vous partagez ce lien, il n’est pas encore possible de le désactiver. Ce lien n’est pas soumis aux restrictions d’accès. L’utilisation de l’App sera facturée sur la Team à laquelle elle appartient, comme si les publications étaient réalisées par des membres de la Team.

Restreindre l’accès à
Vous pouvez choisir si cette App doit être accessible par tous les Utilisateurs de votre Team ou seulement à certains groupes d’Utilisateurs. Le changement est immédiat, vous n’avez pas besoin de publier une nouvelle version de l’App lors de la modification des droits d’accès.
Pour en savoir plus sur les rôles et les Groupes, consultez cette documentation.

Publier la version actuelle
Les Administrateurs et les Architectes de la Team voient constamment les Apps dans une version “preview”, ce qui leur permet de travailler sans impacter les Apps en production. En preview les changements réalisés sur les blocs et le wizard sont visibles en temps réel, chaque ajustement étant pris en compte immédiatement.

Les Utilisateurs voient les Apps :
Qui leur sont accessibles par leur(s) Groupe(s) ou disponibles pour toute la Team (selon le paramétrage du champ “Restreindre l’accès à” des Apps)*
Ayant déjà été publiées au moins une fois (une v1 ou plus doit exister)*
Dans leur dernière version. Les versions précédentes de l’App fonctionneront seulement pour accéder à une ancienne publication de leur historique des publications. Un Utilisateur ne peut pas choisir quelle version de l’App il veut utiliser.*

Quand l’App est prête pour vos Utilisateurs, il convient alors de publier la version actuelle pour la mettre en ligne. Autrement dit, lors du clic sur ce bouton le paramétrage de l’App disponible à l’instant T pour l’Architecte deviendra la nouvelle version de l’App disponible en production.

3. Hiérarchie

Le volet latéral affiche l’arborescence des Blocs et Blocs imbriqués.

Cette arborescence permet de suivre le nombre d’”étages” que constituent les différents niveaux d’imbrications de blocs, elle sert également à s’y retrouver aisément et rapidement sur l’organisation des Blocs, à travers leur intitulé et leur icône indiquant leur type.



Dans cette arborescence, vous pouvez ajouter et déplacer des blocs pour les organiser. Les icônes indiquent le type du bloc concerné et vous aideront à identifier la structure mise en œuvre.

Au clic sur le titre d'un bloc, vous verrez apparaitre trois icônes d'actions supplémentaires.



Le "+" vous permettra d'ajouter de nouveaux blocs après avoir sélectionné l'option souhaitée dans le menu qui apparait.



Au clic sur une de ces options, le bloc du type sélectionné sera inséré en tant que bloc enfant du bloc sur lequel vous avez cliqué sur "+".

La recherche d'un bloc existant se fera à travers une fenêtre en milieu de page qui vous permettra de retrouver le bloc concerné puis vous pourrez le glisser/déposer dans l'arborescence pour l'affecter à l'emplacement souhaité.



Il est possible d’imbriquer un Bloc dans un autre, toujours via glisser/déposer, on parle alors de Bloc Parent et de Bloc Enfant, ou de Bloc Parent et de Bloc Imbriqué pour les désigner. Tous les Blocs n’acceptent pas nécessairement de Bloc Enfant. Un Bloc peut avoir un ou plusieurs blocs imbriqués.



Vous pouvez aussi plier et déplier les blocs parents pour afficher ou masquer les blocs imbriqués. Il est vivement recommandé d’utiliser cette fonctionnalité pour vous y retrouver et refermer les niveaux de blocs sur lesquels vous ne travaillez pas.


L’Imbrication est possible pour les Blocs suivants :

Bloc Groupe : le concept même de ce Bloc est d’y insérer autant de blocs que nécessaires, peu importe leur type.
Bloc Condition : conditionne la visibilité du ou des blocs enfants du Bloc Condition.
Bloc IA : fonctionne comme le Bloc Groupe, sauf que tous les blocs imbriqués vont constituer le Prompt qui sera envoyé à l’IA pour génération du contenu.
Bloc Choix : chaque Bloc Enfant fera office d’alternative possible, affichée dans la Publication quand l’attribut assigné au Bloc est présent. Il est possible d’utiliser des blocs Groupes pour constituer chaque variante et ainsi les remplir de différents contenus.
Bloc Recherche : le bloc enfant constitue la question posée pour la recherche.

Je vous invite à consulter le détail de chaque type de bloc depuis leur documentation dédiée.

Vous pouvez double-cliquer sur le titre d'un bloc pour le renommer ensuite, aussi bien depuis l'arborescence que depuis le volet central.


✅ Bonne pratique : il convient d’établir très rapidement une nomenclature de nommage des blocs pour s’y retrouver facilement. Il est préférable que cette nomenclature soit courte pour identifier en un coup d’œil à quel contenu correspond chaque bloc.


Le bouton à droite du "+" vous permet d'ouvrir le menu de paramétrage du bloc. C'est ici que vous pourrez assigner des attributs et leurs valeurs (indispensable pour les blocs enfants d'un bloc choix), modifier des conditions de visibilité (pour le bloc conditions) ou de manière générale retrouver les réglages spécifiques au type de bloc.

Vous pouvez assigner à un Bloc un ou plusieurs Attributs et une ou plusieurs Valeurs existantes pour chaque Attribut.

Il est possible d’ajouter autant d’Attributs et de Valeurs que souhaitées pour un même Bloc mais deux paramètres sont à considérer :

L’Attribut et/ou la Valeur de l’Attribut doit déjà exister sur l’Équipe.
L’assignation permet de conditionner la visibilité d’un Bloc selon le paramétrage réalisé lorsqu’il s’agit d’un Bloc Choix, il convient d’éviter des choix contradictoires ou des doublons.

4. Le wizard

L’Éditeur d’Assistant/Wizard va permettre de paramétrer l’ensemble des Étapes qui vont se dérouler lors du parcours de l’Utilisateur dans l’Interface de Publication.

On y définira les différentes Étapes, les Options qu’elles proposent, les Attributs qu’elles assignent, les Blocs IA qu’elles exécutent, etc. L’Assistant / Wizard agit comme chef d’orchestre des Blocs pour déclencher chaque élément au bon moment selon les actions de l’Utilisateur.

Le paramétrage des étapes s’organise autour de trois onglets, à savoir Général, Action et Flow.

Les vidéos suivantes sont réalisées avec notre ancienne interface mais la logique à mettre en oeuvre reste la même. De nouvelles vidéos arriveront prochainement avec la nouvelle présentation des Apps.





Nous verrons d’abord le paramétrage commun aux différentes étapes, puis ce qui est spécifique à chaque type.

4.1 Paramétrage commun

Ordre des étapes

Par défaut, le déroulement des Étapes se fait de haut en bas.
Vous pouvez cliquer sur une Étape pour la glisser/déposer à l’endroit souhaité, et changer ainsi l’ordre de vos Étapes simplement.


Les vidéos suivantes sont réalisées avec notre ancienne interface mais la logique à mettre en oeuvre reste la même. De nouvelles vidéos arriveront prochainement avec la nouvelle présentation des Apps.

Général

Pour tous les types d’Étapes, vous pourrez paramétrer les éléments suivants.

Nom de l’Étape : il s’agira de la question affichée à l’Utilisateur dans l’Interface de publication. Elle doit être claire et courte.
Type d’étape : À choisir entre Réponses prédéfinies, Saisie libre, Upload de fichier, Message et Fin.
Description : un complément d’information apportée à l’Utilisateur pour expliciter la question.

Action

À assigner : vous pouvez ajouter des attributs et/ou des valeurs d’attributs, ils seront assignés à la Publication dès la validation de l’Étape.
À retirer : vous pouvez ajouter des attributs et/ou des valeurs d’attributs, ils seront retirés de la Publication dès la validation de l’Étape.
Blocs à exécuter : permet de sélectionner les blocs IA, Recherche, Fichier, API ou les blocs exports dont l’exécution devra être déclenchée lors de la validation de l’Étape.



Les blocs Logique (Groupe, Choix, Condition) sont exécutés à chaque Étape pour prendre en compte les options saisies par l'Utilisateur. Les blocs IA (IA, Fichier, Recherche), Export et API peuvent être assignés manuellement dans l'Assistant pour qu'ils soient exécutés au moment souhaité.


⚠️ Il est recommandé d'exécuter toute l'App en une seule fois sur votre avant dernière étape pour que ce soit simple. Nous vous invitons à consulter la documentation détaillée sur l’exécution des blocs pour bien comprendre ce concept fondamental de Thinkeo.

Flow

Il est possible de masquer chaque Étape en lui assignant des critères de visibilité (selon la présence ou l’absence de certains attributs ou valeurs d’attributs).

Ici vous pourrez affecter un ensemble de critères conditionnels pour déterminer quand l’Étape doit être visible ou non. Il est ainsi possible de choisir la visibilité selon la présence d’un ou plusieurs attributs, d’une ou plusieurs valeurs d’attributs, d’absence d’attributs ou de valeurs, ou de combinaisons de critères.

Les vidéos suivantes sont réalisées avec notre ancienne interface mais la logique à mettre en oeuvre reste la même. De nouvelles vidéos arriveront prochainement avec la nouvelle présentation des Apps.




💡 Pour plus de précisions sur le fonctionnement des critères conditionnels vous pouvez consulter l'article sur le bloc condition qui détaille les possibilités.


Vous pouvez également modifier pour chaque Étape ou chaque Option l’Étape suivante par défaut pour en assigner une particulière. Cette option vous permet de sauter plusieurs Étapes sans avoir à les masquer par des règles conditionnelles.

⚠️ Attention avec cette méthode les Étapes intermédiaires jusqu'à l'Étape définie seront ignorées. Assurez-vous qu'aucune action nécessaire à votre scénario (exécution de bloc, assignation d'attributs, etc) n'est effectuée que sur ces Étapes intermédiaires.




Toutes les étapes, peu importe leur type, peuvent être passées en “bloquante” ce qui permet d’attendre que les Exécutions des blocs soient terminées.

Nous vous recommandons de bien cocher “Attendez que tout soit exécuté” dès que votre prochaine action nécessite qu’un contenu généré par une étape précédente soit disponible. Autrement dit, cette option permet d’être sûre que l’IA a fini son travail sur les étapes d’avant.


⚠️ L'avant-dernière Étape de votre Assistant doit toujours être bloquante pour assurer que tous les blocs ont bien été exécutés avant de terminer la publication.





Nous vous invitons à consulter la documentation détaillée sur l’exécution des blocs pour bien comprendre ce concept fondamental de Thinkeo.

4.2 Paramétrage spécifique

Chaque type d’Étape a des paramètres spécifiques, qui s’ajoutent à ceux énumérés plus haut.

Étape Saisie libre

Sur cette Étape, l’Utilisateur aura à remplir un champ de saisie.

Le texte saisi deviendra la valeur de l’Attribut Texte assigné à l’Étape, il pourra être utilisé comme variable dans les différents Blocs qui composent l’App. Cette Étape permet donc de récupérer une information donnée par l’Utilisateur pour l’exploiter sur la Publication.

L’Attribut à assigner doit être un Attribut Texte sans valeur existante, de préférence. S’il a déjà des valeurs possibles, elles seront remplacées par la saisie faite par l’Utilisateur.

Les vidéos suivantes sont réalisées avec notre ancienne interface mais la logique à mettre en oeuvre reste la même. De nouvelles vidéos arriveront prochainement avec la nouvelle présentation des Apps.

Étape Réponses prédéfinies

Cette Étape permettra de proposer à l’Utilisateur d'App plusieurs réponses possibles, plusieurs Options, qui assigneront des attributs et une valeur existante d’attribut lorsque l’Option est sélectionnée.

Les vidéos suivantes sont réalisées avec notre ancienne interface mais la logique à mettre en oeuvre reste la même. De nouvelles vidéos arriveront prochainement avec la nouvelle présentation des Apps.

Vous aurez à choisir le type de réponse :

Choix unique : comme son nom l’indique, une seule Option possible pour l’Utilisateur. Il est obligatoire de sélectionner une Option.
Case à cocher : plusieurs Options possibles, au moins une Option doit être sélectionnée pour valider l’Étape.
Liste déroulante : une seule Option possible, ce format est adapté lorsque les Options sont très nombreuses.



Dans « Possibilités » vous pouvez sélectionner un Attribut existant ayant au moins une valeur, toutes ses valeurs seront automatiquement ajoutées en tant qu’Options possibles. Vous pourrez alors modifier leur intitulé. Au clic sur l’engrenage, vous accéderez aux paramètres de l’Option.



Par défaut, l’Option ajoutée automatiquement assignera l’Attribut et la valeur à laquelle elle correspond. Vous pouvez ajouter des attributs ou des valeurs à assigner, à retirer, des Blocs à exécuter, etc

La majorité des paramètres disponibles pour les Étapes le sont également pour les Options, ce qui vous permettra de créer des réglages spécifiques et déclencher des logiques métiers à partir des Options. Le fonctionnement reste donc le même lors des assignations et exécutions, déclenchées à la validation de l’Étape.

Vous pouvez aussi afficher ou masquer l’Option avec les mêmes possibilités que pour les Étapes.

Étape Upload de fichier

Cette étape permet à l’Utilisateur de déposer un ou plusieurs fichiers qui viendront alimenter un attribut fichiers.
Cet attribut fichiers peut être associé à un ou plusieurs blocs Fichiers ou blocs Recherche, vous pouvez déposer un à plusieurs documents au cours d’une seule étape.

Vous pouvez consulter la documentation sur le bloc fichier ou celle sur le bloc recherche pour en savoir plus sur l’utilisation de l’attribut fichiers.

Types de fichiers supportés et limites

Formats supportés : PDF (.pdf), Word (.docx), PowerPoint (.ppt), Excel (.xlsx), CSV (.csv)
Taille maximale par fichier : 50 Mo

Étape Message

Elle sert à informer les utilisateurs en indiquant des informations via le Nom de l’étape ou la Description.
Il est vivement recommandé de l’utiliser en avant-dernière Étape de votre Assistant pour inviter vos Utilisateurs d'App à finaliser leur contenu, et vous assurer que tous les blocs sont bien exécutés en rendant cette Étape bloquante.


Les vidéos suivantes sont réalisées avec notre ancienne interface mais la logique à mettre en oeuvre reste la même. De nouvelles vidéos arriveront prochainement avec la nouvelle présentation des Apps.


Vous pouvez aussi en poser ponctuellement pendant le parcours pour déclencher des Exécutions de Blocs, tout en informant l’Utilisateur d'App de la suite.



Cette étape dispose d’une option supplémentaire dans l’onglet “Flow”, il s’agit de “Passer automatiquement à l’étape suivante”

Cette option valide automatiquement l’étape dès que l’exécution des blocs est terminée, nous vous conseillons de la combiner avec l’option “Attendez que tout soit exécuté” ce qui permettra un défilement automatique d’étapes avec un message informatif.

Par exemple, après une première étape d’upload de fichier par l’Utilisateur et si aucune autre action de sa part n’est requise, vous pouvez ajouter une ou plusieurs étapes messages avec ces deux options actives et créer un workflow entièrement automatisé.

Étape Fin

Lors de la création d’une App, un Assistant / Wizard est automatiquement créé et associé à cette App. Il contiendra par défaut une Étape Fin.
Elle clôture le parcours et permet le rapatriement des Publications exportées en Word, si les Blocs Exports concernés ont bien été Exécutés lors de l’Étape précédente. L’Étape fin doit être conservée et modifiée avec le message de votre choix.



⚠️ Cette Étape est obligatoire, systématiquement bloquante et n’est pas prévue pour exécuter des blocs ou assigner des attributs.


Les vidéos suivantes sont réalisées avec notre ancienne interface mais la logique à mettre en oeuvre reste la même. De nouvelles vidéos arriveront prochainement avec la nouvelle présentation des Apps.

5. Réglages

Cet onglet vous permettra de choisir des paramétrages pour vos blocs IA qui s’appliqueront à toute l’App. Vous pouvez ainsi mettre en place une configuration globale pour vos blocs IA sans avoir à les changer un à un.

Vous pouvez toujours modifier manuellement le paramètre d’un bloc pour lui appliquer un paramétrage particulier. Le paramétrage sur le bloc est toujours prioritaire sur le paramétrage au niveau de l’App.

Les paramètres utilisables sont :

Température (Temperature) : Ce paramètre contrôle le degré de variabilité dans les réponses du modèle. Une température basse rend les réponses plus déterministes et conservatrices, tandis qu'une température élevée augmente la créativité et la diversité des réponses, mais peut les rendre moins cohérentes.
Top P (ou Nucleus Sampling) : Ce paramètre limite les choix de tokens (mots ou parties de mots) en fonction de leur probabilité cumulée. Si Top P est bas, le modèle choisira parmi les tokens les plus probables. Si Top P est élevé, cela augmente la diversité des réponses possibles en incluant des tokens moins probables.
Pénalité de Fréquence (Frequency Penalty) : Ce paramètre pénalise les tokens qui apparaissent fréquemment dans la réponse générée. Une pénalité de fréquence plus élevée réduit la répétition des mots, rendant la réponse plus variée.
Pénalité de Présence (Presence Penalty) : Ce paramètre pénalise les tokens qui apparaissent déjà dans la réponse générée, encourageant ainsi le modèle à introduire de nouveaux concepts. Une pénalité de présence plus élevée augmente la diversité en dissuadant le modèle de réutiliser les mêmes mots.

Les valeurs possibles changeront selon le modèle sélectionné, la Température est ajustée de façon dynamique lorsque vous basculez d’un modèle à un autre, pensez à vérifier qu’elles correspondent à vos attentes.

Pour en savoir plus sur les blocs IA et leur paramétrage, vous pouvez consulter la documentation dédiée.

6. Le volet central

Le volet central constitue la « page » principale sur laquelle le contenu des blocs va être créé et modifié jusqu’à constituer une App.

Au clic dans un Bloc, il est alors sélectionné. On peut ensuite :

Saisir du texte, modifier ou supprimer du contenu.
Revenir sur l'arborescence pour y ajouter des blocs imbriqués ou assigner des attributs
Cliquer sur les “…” dans l’angle en haut à droite du bloc pour ouvrir un sous menu supplémentaire. Ce sous menu permet d’ouvrir le Bloc dans un nouvel onglet de l’Éditeur de Blocs, supprimer ce Bloc de son Bloc Parent ou même le supprimer définitivement.

À noter qu'en choisissant "Supprimer du bloc parent" le bloc ne sera pas supprimé de l’Équipe mais simplement retiré du Bloc où il était positionné.

7. Bonnes pratiques et astuces

Avant la fin : placez une Étape Message
Il est vivement recommandé d’ajouter une Étape Message avec l'option bloquante cochée entre votre étape fin et l'étape précédente qui exécute (normalement) toute votre App.

Cela permet de s’assurer que tous les traitements prévus ont été réalisés, que la génération de contenu par IA est terminée et que l’Utilisateur d'App a pu finaliser le contenu de la Publication avant de valider l’Étape.

Ajoutez l’Exécution des Blocs Exports sur l’avant-dernière Étape
L’Exécution d’un Bloc se fait toujours à la validation d’une Étape, il convient donc d’Exécuter les Blocs Exports sur l’avant-dernière Étape de l’Assistant / Wizard pour que le contenu final de la publication soit exporté.

Comment relancer un export
Aujourd’hui pour déclencher de nouveau l’Exécution des Blocs Exports, vous devez revenir sur une Étape précédente et changer une Option ou une saisie dans un Champ de texte puis valider l’Étape pour que le parcours s’ajuste et crée de nouveaux documents lors de l’Export.

Il n’est pas encore possible de relancer directement l’Export depuis la dernière Étape de l’Assistant/Wizard. Vous pouvez ajouter un espace " " dans un champ de saisie pour qu'il soit considéré comme différent et permette de relancer l'Export.

Organiser l’ordre de ses Étapes
Considérez le parcours comme un déroulement continu, privilégiez le masquage de questions pour mettre en place la logique de votre App.

La possibilité d’assigner une Étape par défaut à une Étape ou une Option doit ponctuellement servir sur des cas précis, abuser de cette fonctionnalité va grandement complexifier l’organisation et la maintenance de votre Assistant / Wizard.

Si vous avez du mal à vous projeter, utilisez des outils comme Miro ou Whimsical pour dessiner votre arborescence de questions.

Mis à jour le : 30/01/2025