Vos premiers pas dans Studio

Aucun prérequis technique n’est nécessaire. Le premier parcours consiste à créer un workflow, manipuler le canvas, sauvegarder puis tester dans Semantics Chat.

1. Créer un workflow

1. Ouvrez la liste des workflows de votre organisation.
2. Cliquez sur Créer un workflow.
3. L’éditeur s’ouvre avec le bloc Début, point de départ de chaque exécution.
4. Renommez le workflow depuis la barre d’actions, par exemple Assistant RH ou Support N1.

Vous pouvez aussi ouvrir un workflow existant pour l’adapter. Les actions disponibles dépendent de votre rôle dans l’organisation : la création, la modification, l’import, l’export et la suppression de workflows sont réservées aux rôles autorisés à les modifier.

2. Manipuler le canvas

• Ajouter un bloc : cliquez sur un bloc dans la palette ou glissez-le vers le canvas. La palette présente les blocs disponibles dans une liste triée alphabétiquement.
• Relier les blocs : tirez un lien depuis la sortie d’un bloc vers le bloc suivant.
• Configurer un bloc : sélectionnez-le pour ouvrir son panneau latéral.
• Zoomer : utilisez la molette.
• Déplacer la vue : faites glisser le fond du canvas.
• Supprimer un bloc : sélectionnez-le puis appuyez sur Suppr.

La position des blocs est uniquement visuelle ; seuls les liens déterminent l’ordre d’exécution.

Si votre rôle ne permet pas de modifier les workflows, l’éditeur s’ouvre en lecture seule : vous pouvez parcourir le canvas et consulter la configuration de chaque bloc, mais pas ajouter, supprimer ou relier des blocs, ni modifier leurs champs. Le panneau d’un bloc l’indique par le message « Ce bloc est en lecture seule » et le bouton Sauvegarder le workflow n’est pas affiché. Adressez-vous à un administrateur de votre organisation si vous devez modifier le workflow.

Votre premier workflow

100 %

• Après succès
• Après échec
• Données ou résultat

Les encadrés pointillés représentent des données, des services ou des résultats.

Glissez pour déplacer. Utilisez + / − pour zoomer, les flèches pour déplacer et Début pour recentrer.

3. Relier les sorties

La plupart des blocs techniques proposent deux chemins :

• Après succès poursuit le parcours normal ;
• Après échec conduit vers un fallback, généralement un Message simple compréhensible.

Prévoir le succès et l’échec

100 %

• Après succès
• Après échec

Glissez pour déplacer. Utilisez + / − pour zoomer, les flèches pour déplacer et Début pour recentrer.

Certains blocs proposent des sorties portant un libellé métier. Reliez chaque sortie utile au bloc qui doit poursuivre le parcours ; le panneau affiche alors un lien Après « libellé ».

Si un bloc attend des sources ou des outils, utilisez sa section Ports contextuels. Les connexions de sources et d’outils préparent ces données avant ce bloc et se distinguent des liens du parcours principal.

4. Corriger et sauvegarder

Studio vérifie en continu les champs requis, le JSON, les références de variables et les blocs non reliés. Les anomalies apparaissent sur les champs et dans le panneau des problèmes en haut à droite de votre écran.

Cliquez sur Sauvegarder le workflow après avoir corrigé les problèmes. Si des anomalies subsistent, Studio affiche une confirmation avant la sauvegarde. Vérifiez-les avant de tester le workflow avec des utilisateurs.

Tant que vous n’avez pas sauvegardé, les utilisateurs ne voient pas vos changements. Une confirmation s’affiche si vous quittez avec des modifications non sauvegardées.

5. Tester dans Semantics Chat

Chaque message déclenche un parcours complet depuis Début.

1. Associez une App Semantics au workflow.
2. Testez le workflow minimal.
3. Ajoutez les blocs un par un.
4. Pour inspecter une variable, ajoutez temporairement un Message simple contenant {{codeblock maVariable}}.
5. Provoquez aussi un échec, par exemple avec une URL invalide, et vérifiez que le message d'erreur est clair.
6. Retirez les messages de debug avant la mise en production, surtout s’ils peuvent exposer un token ou une donnée métier.

Testez les deux routes

Vérifiez les sorties Après échec, le cas Sinon des conditions, les sorties métier, les sources et outils connectés, ainsi que les réponses obtenues avec une variable vide.

6. Exporter et importer un workflow

L’export et l’import permettent de dupliquer un workflow, d’en conserver une copie ou de le reprendre dans une autre organisation.

Exporter : dans la liste des workflows, ouvrez le menu de la carte du workflow puis cliquez sur Exporter. Studio télécharge un fichier JSON.

Importer :

1. Ouvrez le workflow qui recevra le contenu, ou créez-en un nouveau.
2. Cliquez sur Importer dans la barre d’actions de l’éditeur, puis choisissez le fichier JSON issu d’un export.
3. Confirmez : l’import remplace tout le contenu du workflow ouvert par celui du fichier. Le nom du workflow est conservé.
4. Complétez la configuration, puis cliquez sur Sauvegarder le workflow.

Configuration à compléter après un import

Le modèle et le connecteur LLM des blocs Instruction LLM et Requête LLM, ainsi que le modèle d’embedding et les sources du bloc Sources de données, sont propres à une organisation. Ils sont retirés à l’export : sélectionnez-les de nouveau après l’import. Le panneau des problèmes signale les champs à compléter.