Un workflow est un graphe lisible
Un workflow se lit de gauche à droite. Chaque message envoyé dans Semantics Chat démarre une nouvelle exécution au bloc Début, suit une route précise et produit une réponse ou une action.
À retenir :
- la position est visuelle, les liens pilotent l’exécution ;
- un tour de conversation correspond à un parcours du graphe ;
- une condition peut proposer plusieurs sorties et un cas
Sinon; - les sorties d’un bloc peuvent être consommées par les blocs placés ensuite sur la même route ;
- les blocs connectés à des ports contextuels préparent des sources ou des outils avant le bloc qui les utilise ;
- le brouillon n’est appliqué qu’à la sauvegarde.
Parcours de construction recommandé
- Ajoutez les blocs nécessaires depuis la palette.
- Donnez à chacun un nom métier lisible.
- Reliez-les dans l’ordre d’exécution.
- Configurez d’abord les champs obligatoires.
- Sélectionnez les références réelles avec l’aide
{{. - Reliez les branches d’échec.
- Vérifiez le panneau des problèmes.
- Sauvegardez puis testez chaque route.
Anatomie d’un bloc
Informations de base
| Champ | Rôle |
|---|---|
| Nom | Libellé visible sur le canvas ; utilisez un nom métier explicite. |
| Identifiant | Nom technique utilisé par défaut dans les références, par exemple http-1. Il est en lecture seule. |
| Version | Version du bloc utilisé, affichée en lecture seule dans les informations de base. |
| Nom de la variable de sortie | Alias optionnel, proposé selon le bloc, rendant les références plus lisibles, par exemple documents. Il doit rester unique. |
Exemples de noms utiles : Recherche documents RH, Préparer instruction RAG, Réponse finale LLM, Charger outils Microsoft 365.
Évitez test, bloc 1, api ou prompt.
Configuration
La partie principale regroupe les champs nécessaires à l’usage courant. Commencez ici et n’ouvrez la configuration avancée que si votre cas le demande.
Selon le bloc, certains champs sont préremplis ou en lecture seule, et d’autres proposent une liste de valeurs. Renseignez les champs modifiables qui correspondent à votre usage.
Configuration avancée
Selon le bloc, elle peut contenir le budget de tokens, les outils, la configuration des documents ou les messages remplaçant des résultats expirés. Ne modifiez pas une valeur préremplie sans en comprendre l’impact.
Liens de sortie
Après succèssélectionne le prochain bloc si l’action aboutit.Après échecsélectionne un fallback si elle échoue.Après « libellé »sélectionne la suite d’une sortie métier, lorsque le bloc en propose.
Reliez chaque échec potentiel vers un message compréhensible ou une route alternative.
Connexions de sources et d’outils
La section Ports contextuels, lorsqu’elle est présente, associe au bloc un fournisseur de sources ou d’outils MCP. Le fournisseur reste détaché du parcours principal et prépare ses données avant ce bloc.
Utilisez Brancher le bloc ou Brancher les blocs pour sélectionner un fournisseur compatible. Suivez le guide des connexions pour configurer les sources, les serveurs MCP et les liens.