Déployer votre agent

agents deploy déploie le projet du guide de démarrage avec Studio. Mistral le gère, vous n'avez donc aucun processus à maintenir en cours d'exécution. Mistral stocke chaque session, et tout programme disposant de votre clé API peut appeler l'agent par son nom. Vous poussez le projet, le déployez, discutez avec l'agent et l'appelez depuis votre application.

• Le projet hello-agent du guide de démarrage.
• Un dépôt GitHub pour le projet et le connecteur GitHub connecté à votre compte dans Mistral Studio. agents deploy utilise pour le build le commit que vous avez poussé, et non votre copie de travail.
• Une clé dont l'utilisateur possède un rôle dans l'espace de travail donnant accès à Workflows, comme Développeur ou Contributeur de l'espace de travail. Un administrateur de l'espace de travail attribue ce rôle dans la console d'administration : Organisation > espaces de travail > votre espace de travail > Membres. Consultez Déployer.

Créez un commit avec vos modifications du guide de démarrage et poussez le projet :

git add --all && git commit -m "Add get_forecast"
git remote add origin <repository-url>
git push -u origin HEAD

git add --all && git commit -m "Add get_forecast"
git remote add origin <repository-url>
git push -u origin HEAD

Ces commandes supposent que agents init a créé le dépôt. Si ce n'est pas le cas :

• Vous avez répondu non, passé --no-git, ou git n'était pas installé : exécutez d'abord git init. Le commit inclut alors tous les fichiers, y compris uv.lock.
• Le projet se trouve dans un dépôt existant, comme un monorepo : créez le commit et poussez-le dans ce dépôt, sans exécuter git remote add.

L'encadré Next steps, à la fin de la sortie de agents init, répertorie les commandes git adaptées à votre cas.

uv run --env-file .env agents deploy

uv run --env-file .env agents deploy

Un déploiement lance le build du Dockerfile créé par agents init. Il utilise la valeur name= de votre Agent, soit hello-agent. --name permet de la remplacer. Le nom est unique au sein de l'espace de travail : un déploiement ultérieur avec le même nom remplace l'agent. Le déploiement attend que l'agent soit en cours d'exécution, puis affiche Agent hello-agent is live after et la durée de l'opération. Sous Try the agent:, il affiche un lien pour discuter avec l'agent dans Vibe Code Web et un autre vers la documentation de l'API Session.

agents deploy déploie le commit poussé. Créez donc un commit avec vos modifications et poussez-le d'abord : la commande refuse les commits non poussés ou une branche sans branche de suivi distante. Pour utiliser un autre Dockerfile lors du build, consultez Utiliser votre propre Dockerfile.

Discutez avec l'agent déployé en utilisant son nom. La session s'exécute chez Mistral, et non dans le processus agents chat :

uv run --env-file .env agents chat hello-agent

uv run --env-file .env agents chat hello-agent

Consultez les logs de l'agent déployé avec agents logs ; --follow affiche les nouvelles lignes au fur et à mesure :

uv run --env-file .env agents logs hello-agent --follow

uv run --env-file .env agents logs hello-agent --follow

agents list affiche les agents de votre espace de travail et indique si chacun est en cours d'exécution. Consultez Cycle de vie de l'agent pour connaître toutes les possibilités de agents chat, agents list et agents logs.

Dans votre application, chargez l'agent déployé par son nom avec Agent.load_from. Le reste du code ne change pas :

import asyncio

from mistralai import agents


async def main() -> None:
    agent = agents.Agent.load_from(agent_name="hello-agent")
    result = await agent.run("What's the weather in Lyon?")
    print(result.text)


if __name__ == "__main__":
    asyncio.run(main())

import asyncio

from mistralai import agents


async def main() -> None:
    agent = agents.Agent.load_from(agent_name="hello-agent")
    result = await agent.run("What's the weather in Lyon?")
    print(result.text)


if __name__ == "__main__":
    asyncio.run(main())

uv run --env-file .env python app.py

uv run --env-file .env python app.py

Le tour s'exécute chez Mistral, et non dans votre application. Pour permettre à votre application de se fermer pendant l'exécution d'un tour, lancez-le avec start_session et send_message, puis conservez les identifiants de la session et du tour. Votre application peut récupérer le résultat ultérieurement à partir de ces identifiants. Consultez Exécuter en arrière-plan et Ouvrir une session par son identifiant.

agents serve exécute le même projet sur votre propre machine ou vos serveurs, en auto-hébergement. C'est utile, par exemple, lorsque les outils de l'agent doivent s'exécuter au sein de votre réseau. Mistral continue de stocker les sessions :

uv run --env-file .env agents serve

uv run --env-file .env agents serve

Pendant son exécution, agents chat hello-agent et Agent.load_from(agent_name="hello-agent") accèdent à l'agent comme à un agent déployé. Consultez Auto-hébergés (agents serve).

• Choisir où l'agent s'exécute : Modes d'exécution.
• Transmettre des secrets et tracer l'agent déployé : Déployer.
• Remplacer l'agent ou l'arrêter : Cycle de vie de l'agent.
• Répondre à ses demandes d'approbation, puis laisser le tour se poursuivre : Parcourir une session pas à pas.
• Observer ses tours et les orienter : Construire une application de session.