Visualiser votre workflow

Le visualiseur de workflows affiche votre workflow sous forme de graphe dans Studio. Le worker construit le graphe à partir de votre code de workflow lorsqu'il démarre, si bien que le graphe est disponible avant la première exécution.

Ce qu'il fournit

Le graphe affiche les éléments suivants :

Le point d'entrée, et les activités et workflows enfants qu'il appelle.
Le flux de contrôle : branchements (if/elif/else), boucles, exécutions en parallèle (asyncio.gather) et sorties en erreur (raise).
Les handlers de signal, de mise à jour et de requête.
Les connecteurs déclarés par le workflow.
De courts résumés générés par IA pour chaque nœud, ainsi qu'un résumé de l'ensemble du workflow.

Chaque déploiement stocke son propre graphe. Lorsqu'un worker enregistre à nouveau un workflow, le nouveau graphe remplace le précédent.

Pour ouvrir le graphe :

Accédez à Studio›Workflows ↗.
Sélectionnez un workflow.
Ouvrez Visualiseur depuis le menu.

Prérequis

Le visualiseur nécessite mistralai-workflows 3.15.0 ou une version ultérieure sur vos workers :

uv add "mistralai-workflows>=3.15.0"

uv add "mistralai-workflows>=3.15.0"

Configurer le visualiseur

Le visualiseur est activé par défaut. Configurez-le avec des variables d'environnement sur vos workers :

Variable d'environnement	Par défaut	Effet
`UPLOAD_GRAPH`	`true`	Construit et télécharge le graphe du workflow au démarrage du worker.
`GRAPH_SUMMARISE_ENABLED`	`true`	Génère des résumés par IA pour le graphe. S'applique uniquement lorsque `UPLOAD_GRAPH` vaut `true`.

Pour désactiver le visualiseur, définissez :

UPLOAD_GRAPH=false

UPLOAD_GRAPH=false

Le téléchargement s'exécute en arrière-plan après que le worker a enregistré ses workflows. Il ne retarde pas le worker et, en cas d'échec, le worker se contente d'ajouter un avertissement dans les logs.

Données envoyées à Mistral

Quand le visualiseur est activé, chaque worker envoie à Mistral, au démarrage, des données dérivées de votre code de workflow. Les workers n'envoient ni les entrées ni les sorties d'exécution.

Graphe

Le graphe contient la structure du workflow, et non ses fichiers sources :

Les noms du workflow, des activités, des workflows enfants, des handlers et des connecteurs.
Les noms des paramètres et les annotations de type.
Le chemin du fichier source qui définit le workflow, ainsi que les positions de ligne de chaque nœud.
Les arêtes entre les nœuds.

Résumés par IA

Pour générer les résumés, le worker envoie des extraits de code du point d'entrée, des activités définies dans le fichier du workflow et de chaque nœud du graphe. Nous générons les résumés avec des modèles Mistral. Les résumés ne sont pas facturés sur votre compte.

Avant d'envoyer les extraits, le worker remplace chaque littéral de chaîne par '...', y compris les docstrings et les parties littérales des f-strings. Ainsi, les données d'authentification et autres secrets stockés sous forme de constantes de chaîne dans votre code restent dans votre environnement. Les identifiants et les commentaires sont envoyés tels qu'ils sont écrits : ne placez pas de secrets dans les commentaires ou les identifiants.

Pour envoyer uniquement le graphe, sans extraits de code, désactivez les résumés :

GRAPH_SUMMARISE_ENABLED=false

GRAPH_SUMMARISE_ENABLED=false