Qu'est-ce que Mistral Workflows ?
Workflows est en préversion publique. Nous ne prévoyons pas de changements majeurs concernant les API et les fonctionnalités, mais ils peuvent toujours se produire. Nous vous informerons à l'avance le cas échéant.
Mistral Workflows est une plateforme pour construire des workflows IA de qualité production : des processus multi-étapes qui combinent des appels LLM, l'utilisation d'outils, des API externes et une intervention humaine. Ils survivent aux crashes, aux redémarrages et aux défaillances de n'importe quelle étape.
Vous écrivez les workflows sous forme de code. La plateforme gère l'exécution : durabilité, réessais, planification, streaming, observabilité et intégration avec le reste de Mistral.
Ce que les workflows résolvent
Les applications LLM doivent souvent faire plus que répondre à un prompt. Elles orchestrent plusieurs appels de modèle, attendent des validations humaines, appellent des API externes et s'exécutent pendant des minutes, des heures ou des jours. Construire cela sur une infrastructure brute revient à écrire vos propres mécanismes de réessai, votre propre machine à états et votre propre logique de reprise — et à constater que la moitié cesse de fonctionner au premier redémarrage d'un processus.
Workflows s'en charge pour vous :
- Un crash ne fait pas perdre le travail effectué. Chaque étape est enregistrée dans un historique d'événements. Quand un processus meurt, un autre reprend à partir de la dernière étape terminée.
- Les réessais sont natifs. Configurez le backoff par activité ; la plateforme gère le reste.
- Orchestration de longue durée. Mettez un workflow en pause sur réception d'un signal humain ou d'un événement externe ; reprenez-le à l'arrivée d'une entrée. Les workflows s'exécutent de quelques secondes à plusieurs mois.
- Observable par défaut. Les événements sont diffusés en direct, l'historique est interrogeable et les traces OpenTelemetry fonctionnent sans configuration supplémentaire.
- Primitives IA incluses. Exécutez une boucle d'agent, diffusez les tokens LLM vers les clients et appelez l'API de Mistral sans écrire le code d'intégration.
L'exécution durable repose sur Temporal, un moteur open source tolérant aux pannes pour l'orchestration de workflows.
Quand utiliser les workflows
Utilisez les workflows lorsque vous avez besoin de :
- Des pipelines LLM multi-étapes qui doivent survivre aux crashes et aux redémarrages.
- Des processus avec intervention humaine qui se mettent en pause pendant des heures ou des jours.
- Des tâches IA planifiées ou récurrentes (de type cron ou ponctuelles).
- Une orchestration multi-agents avec passages de relais et état partagé.
- Tout ce que vous construisez aujourd'hui avec une file d'attente, une machine à états et beaucoup de code de réessai.
Si vous appelez un seul endpoint LLM sans orchestration, de simples appels SDK suffisent.
Composer avec le reste de Mistral
Workflows constitue la couche d'exécution durable des applications IA que vous construisez sur Mistral. Lorsque vous composez d'autres briques — les agents, les juges, les ensembles de données, et bien plus — au sein d'un workflow, elles héritent de sa durabilité, de ses réessais, de son observabilité et de ses primitives d'intervention humaine.
Vous pouvez appeler un workflow que vous construisez depuis :
- L'API Mistral :
POST /v1/workflows/{name}/executedepuis n'importe quel client, dans n'importe quel langage. - Studio : déclenchez des exécutions depuis l'interface utilisateur, avec des formulaires d'entrée générés à partir de la signature de votre workflow, et suivez leur déroulement sur une chronologie d'exécution en direct.
- Vibe Work : les workflows apparaissent comme des assistants que les utilisateurs peuvent invoquer dans une conversation.
Ce qui s'exécute où
Workflows fonctionne en mode hybride : nous hébergeons l'orchestrateur, et le code de vos workflows et de vos activités s'exécute dans votre environnement.
Votre environnement contient le code que vous écrivez (généralement dans votre dépôt) et les workers qui l'exécutent. Les workers s'exécutent sur votre ordinateur portable pour le développement local, ou dans votre propre infrastructure (Kubernetes ou machines virtuelles, par exemple) pour la production.
L'environnement Studio héberge l'orchestrateur (état, historique, distribution des tâches) derrière une API REST publique et l'interface Studio. Les workers établissent des connexions sortantes ; l'orchestrateur n'initie jamais de connexion vers votre réseau.
Pour les clients Entreprise, l'environnement Studio peut également s'exécuter dans votre cloud privé ou sur site.
Mode hybride : vos données restent là où vous le souhaitez. Les entrées et sorties des workflows transitent par la plateforme, mais vous pouvez les garder sous votre contrôle :
- Chiffrement au niveau de la couche SDK : le SDK chiffre les charges utiles avant qu'elles ne quittent votre worker ; la plateforme ne stocke que du texte chiffré.
- Déchargement des charges utiles : la plateforme décharge les entrées et sorties de plus de 2 Mo vers votre stockage blob (S3, GCS ou Azure), en ne conservant que des références de son côté.
Pour plus de détails, consultez Déchargement des charges utiles et Chiffrement.
Prochaines étapes
| Si vous souhaitez | Commencez ici |
|---|---|
| Installer le SDK | Installation |
| Voir un workflow fonctionnel en 5 minutes | Votre premier workflow |
| Comprendre comment les éléments s'articulent | Concepts fondamentaux |
| Construire un agent LLM dans un workflow | Agents durables |
| Planifier un workflow récurrent | Planification |