Choisir ce que vous voulez construire
Studio permet de construire trois types de systèmes : les agents, les workflows et les applications. Choisissez pour chaque partie de votre processus, et non pour le projet entier : la plupart des processus en combinent deux ou trois, et ils partagent les mêmes connecteurs, secrets, traces et évaluations.
Cette page vous aide à choisir le système adapté à chaque partie, et montre comment ils fonctionnent ensemble.
Choisir selon la forme du processus
Répondez aux questions en partant de la première.
Partez des personnes. Si elles ont besoin de leur propre espace pour examiner les résultats, donner un retour ou approuver une action, construisez une application, et exécutez des agents et des workflows en arrière-plan. Sinon, regardez les étapes : si vous pouvez les écrire toutes à l'avance sous forme de règles métier, construisez un workflow ; si l'étape suivante dépend de ce que le système trouve, construisez un agent.
Les personnes peuvent utiliser vos agents et workflows dans Vibe avant que vous ne construisiez une application pour elles. Construisez l'application quand elles ont besoin d'une interface conçue pour la tâche.
Ce qui les distingue
Les trois systèmes diffèrent selon qui décide de l'étape suivante, comment ils conservent leur état, et comment les personnes y accèdent :
| Agent | Workflow | Application | |
|---|---|---|---|
| Qui décide de l'étape suivante | Le modèle, à partir de ses instructions, de son contexte et de ses outils | Votre code : chaque exécution suit les mêmes règles | Les personnes qui l'utilisent, et les agents et workflows en arrière-plan |
| État et échecs | Une session conserve la conversation ; en tant que worker durable, l'état survit à un crash | Studio conserve l'état d'exécution et relance les étapes qui échouent | L'application conserve ses données dans son propre backend et sa propre base de données |
| Personnes dans la boucle | Une politique d'autorisations met en pause un appel d'outil jusqu'à ce que quelqu'un l'approuve | Le workflow attend la décision ou l'entrée d'une personne, puis reprend | Les personnes se connectent et agissent dans l'interface |
| Comment les personnes y accèdent | L'API Sessions, ou Vibe | L'API, les déclencheurs, ou Vibe | Sa propre URL, ou le catalogue Vibe |
| Où il s'exécute | Sur votre machine, sur vos propres workers, ou géré par Mistral | Sur votre machine, sur vos propres workers, ou géré par Mistral | Gérée par Mistral, sur Mistral Cloud |
| Construit avec | Le SDK Agents, en Python | Le SDK Workflows, en Python | La Mistral CLI, à partir de fonctionnalités prêtes à l'emploi |
Les trois peuvent démarrer à partir d'un déclencheur ou d'un webhook, par exemple un nouveau message dans un canal ou un événement dans votre tracker. Leurs exécutions apparaissent dans les mêmes traces, ce qui vous permet de suivre une requête d'une application à travers un workflow jusqu'à un agent.
Apps, workflows autonomes et plugins
Un workflow autonome convient à un processus lancé par un appel API, une planification ou un autre déclencheur, sans interface dédiée. Il définit les étapes et leur exécution durable.
Placez le workflow dans une app lorsque les utilisateurs ont besoin de formulaires, d'un tableau de bord ou d'une interface de consultation. L'app fournit l'interface et les données ; le workflow conserve l'exécution durable des étapes. Une app de gestion des sinistres peut lancer le workflow à partir d'un formulaire et afficher sa décision. L'interface et le worker peuvent être déployés dans le même projet.
Un plugin enrichit une session Vibe avec des outils, des compétences ou des instructions. Il ne remplace ni une app hébergée ni un worker de workflow durable, mais peut donner accès à une app ou un workflow déployé. Consultez Plugins Vibe.
Les combiner
Un même processus utilise souvent les trois. Prenons l'exemple d'une équipe sécurité qui fait le tri des vulnérabilités nouvellement signalées :
- Un workflow pilote le processus. Il reçoit chaque constat, applique les règles de l'entreprise et décide quels constats nécessitent un examen plus approfondi.
- Un agent enquête. Pour ces constats, une étape du workflow démarre un agent qui inspecte le code, vérifie si le chemin vulnérable est atteignable et propose un correctif.
- Une personne décide. Le workflow se met en pause pendant qu'un ingénieur sécurité examine les preuves, dans une application ou dans Vibe, et approuve ou rejette le correctif.
- Les évaluations referment la boucle. Les cas difficiles issus de la production deviennent un ensemble de données d'évaluation, sur lequel la prochaine version de l'agent est testée avant d'être livrée.
Chaque partie utilise les mêmes connecteurs pour accéder au code et au tracker de tickets, et les mêmes secrets et autorisations.
Quand vous n'avez pas besoin d'un agent
Un simple appel à un modèle, avec ou sans outils, ne nécessite ni agent ni workflow : utilisez chat completions dans Inférence.
Pour construire un agent, utilisez le SDK Agents. L'API Agents et les agents durables dans Workflows sont sur le point d'être dépréciés. Si vous les utilisez aujourd'hui, consultez API Agents et Agents durables.