Studio

Mistral Studio réunit en un seul endroit tout ce qu’il faut pour construire des agents, des workflows et des apps d’IA, les exécuter en production et les améliorer à partir de l’usage réel. Vous les assemblez à partir de composants partagés, vous les connectez aux données et aux outils de votre entreprise, et vous les déployez sans monter l’infrastructure vous-même. Une fois un système en service, vous pouvez suivre ce qu’il fait et évaluer chaque modification sur des cas réels avant de livrer la version suivante (organisations de niveau Enterprise).

Les agents et les workflows s’exécutent sur le cloud de Mistral ou sur votre propre infrastructure, et les apps s’exécutent sur Mistral Cloud. Les secrets, les autorisations et les garde-fous sont intégrés.

Cette section s’adresse aux développeurs : vous construisez, déployez et exécutez vos systèmes avec du code que vous maîtrisez, à l’aide des SDK, de l’API, de la CLI Mistral et de l’agent de codage que vous utilisez déjà.

Les agents, les workflows et les requêtes API s’authentifient avec une clé API de votre espace de travail Studio.

1. Ouvrez la console Studio et accédez à Clés API (lien direct).
2. Sélectionnez Nouvelle clé, donnez un nom à la clé et définissez une date d’expiration.
3. Copiez la clé. Elle ne s’affiche qu’une seule fois.
4. Stockez la clé dans la variable d’environnement MISTRAL_API_KEY, où les SDK et les exemples la lisent :

export MISTRAL_API_KEY="your-api-key"

export MISTRAL_API_KEY="your-api-key"

Le SDK Agents et le SDK Workflows sont des packages Python, et tous deux nécessitent Python 3.12, 3.13 ou 3.14 (>=3.12,<3.15). Créez un projet avec uv et ajoutez-y les deux SDK :

uv init --python 3.12 my-project
cd my-project
uv add mistralai-agents mistralai-workflows

uv init --python 3.12 my-project
cd my-project
uv add mistralai-agents mistralai-workflows

import asyncio

from mistralai.agents import agents

agent = agents.Agent(
    name="hello-agent",
    model="mistral-medium-latest",
    instructions="You are a friendly assistant. Answer in one sentence.",
)

async def main() -> None:
    state = await agent.run("What can you help me with?")
    match state:
        case agents.Completed(output=answer):
            print(answer)
        case agents.Failed(error=error):
            print("The run failed:", error.message)

asyncio.run(main())

import asyncio

from mistralai.agents import agents

agent = agents.Agent(
    name="hello-agent",
    model="mistral-medium-latest",
    instructions="You are a friendly assistant. Answer in one sentence.",
)

async def main() -> None:
    state = await agent.run("What can you help me with?")
    match state:
        case agents.Completed(output=answer):
            print(answer)
        case agents.Failed(error=error):
            print("The run failed:", error.message)

asyncio.run(main())

I can help you with a wide range of tasks, including writing code, analyzing data, managing files, automating workflows, searching for information, and integrating with external tools or services.

I can help you with a wide range of tasks, including writing code, analyzing data, managing files, automating workflows, searching for information, and integrating with external tools or services.

Studio permet de construire trois types de systèmes. Choisissez selon la forme du processus :

Un processus peut combiner les trois. Les utilisateurs peuvent aussi se servir de vos agents et workflows dans Vibe avant que vous ne construisiez une app pour eux. Pour comparer les trois en détail, consultez Choisir ce que vous voulez construire.

Les experts métier peuvent décrire un processus en langage courant et obtenir une première version du workflow, que les développeurs affinent ensuite dans le code : consultez Construire dans Vibe.

Chaque système que vous construisez a besoin des mêmes services de production. Studio les fournit une fois, et chaque projet les réutilise :

• Exécution : les déploiements exécutent les agents et les workflows sur votre machine pendant que vous construisez, sur votre propre infrastructure ou en mode géré par Mistral. Les apps s’exécutent sur Mistral Cloud.
• Contexte de l’entreprise : les connecteurs accèdent à vos outils et à vos données, les bibliothèques et Agentic Search fournissent vos documents, et les prompts et skills conservent des instructions versionnées et un savoir-faire que les agents et les workflows réutilisent.
• Contrôles : Secrets Manager stocke les identifiants, la gouvernance définit qui peut utiliser quelles données, quels outils et quels modèles, et la modération et les garde-fous vérifient ce qui entre dans un modèle et ce qui en sort.
• Traces et évaluations : l’observabilité affiche dans une même vue les appels de modèles, les appels d’outils, l’activité des agents et les exécutions de workflows, et les évaluations comparent les versions sur des cas réels avant une mise en production. Les deux sont réservées aux organisations de niveau Enterprise.

Dès qu’un administrateur connecte une application pour l’Organisation ou partage un connecteur avec l’espace de travail, le projet suivant peut le réutiliser : un agent, un workflow et une app peuvent appeler le même connecteur sans reconstruire l’intégration.

Studio est l’une des parties de la plateforme Mistral. Pour un autre besoin, partez de la section correspondante :

La console Studio montre ce qui s’exécute, comme les exécutions, les traces et les évaluations, et permet de créer certaines ressources sans code. Vous pouvez construire dans la console, dans le code ou avec un agent de codage, et passer de l’un à l’autre.

Studio s’organise autour d’une boucle recommandée : construire un système, lui donner du contexte, le tester, le déployer, l’observer en production et l’améliorer, puis repartir de l’étape Construire pour la version suivante.

Lisez la boucle dans le sens des aiguilles d’une montre, à partir de Construire. Gouverner s’applique à chaque étape.

Chaque composant est facultatif : utilisez ceux dont votre système a besoin à chaque étape. Un workflow encore sans évaluation peut quand même être déployé, et vous pourrez ajouter des évaluations plus tard. Les étapes Tester, Observer et Améliorer s’appuient sur l’observabilité et les évaluations, réservées aux organisations de niveau Enterprise.

Avant de concevoir un système, découvrez ce qui se passe à chaque étape de la boucle, quels composants la servent et comment choisir entre un agent, un workflow et une app.

Choisissez le système le plus proche de votre projet et suivez son guide de démarrage. Tous les guides de démarrage Studio sont aussi listés dans Guides de démarrage, sur la page d’accueil.

Chaque composant a son propre guide de démarrage, classé par étape de la boucle :

• Configurer : créer votre première clé API, installer la CLI Mistral et créer un projet.
• Construire : construire votre premier workflow, construire votre première app.
• Contexte : ajouter un connecteur, créer une bibliothèque et lui poser une question, créer et interroger un index, construire un pipeline RAG, créer et utiliser un prompt.
• Tester et évaluer : exécuter votre première évaluation.
• Déployer : déployer un workflow sur Mistral.
• Observer et améliorer : envoyer votre première trace, attribuer un score à votre premier span avec les évaluations en ligne.
• Gouverner : modérer une entrée.
• Voix : transcrire un fichier audio, transcrire la parole en temps réel, générer de la parole, construire un agent vocal.

Un agent de codage, comme Vibe, Claude Code ou Codex, peut construire des systèmes Studio pour vous. La CLI Mistral lui donne des commandes pour se connecter, choisir l’espace de travail, générer et exécuter des apps et des workflows, et le serveur Mistral MCP expose votre espace de travail sous forme d’outils.