Agents
Un agent utilise un modèle, des instructions et des outils pour décider de l'action suivante. Utilisez le SDK Agents pour définir un agent en Python, lui donner accès à vos systèmes et l'exécuter localement ou sur un worker.
Pour une requête unique au modèle sans boucle d'agent, utilisez Chat completions. Pour un processus aux étapes, tentatives et branches explicites, consultez Workflows.
Démarrer avec le SDK Agents
- Suivez le guide de démarrage pour créer un projet avec
agents init, l'exécuter localement et discuter avec lui. - Ajoutez des outils, des skills et des approbations selon les besoins de votre tâche.
- Déployer votre agent permet de l'appeler par son nom depuis votre application. Vous pouvez aussi choisir l'option Auto-hébergés avec un worker.
Un agent associe le modèle au système d'exécution qui gère sa boucle. Configurez les outils, les connecteurs, les skills, les hooks et un environnement directement sur agents.Agent(...). Une session enregistre la conversation, et un tour correspond au travail effectué pour répondre à un message. Consultez L'agent et Sessions.
Ajouter des fonctionnalités
Le SDK expose les fonctionnalités via le harness, plutôt que par la configuration d'outils intégrés de l'API Agents :
| Tâche | Guide du SDK |
|---|---|
| Appeler vos propres fonctions Python | Outils |
| Connecter des systèmes externes via HTTP ou MCP | Connecteurs & MCP |
| Exécuter des commandes et manipuler des fichiers | Sandbox |
| Réutiliser des instructions et des ressources | Skills |
| Demander une approbation avant les appels d'outils | Permissions |
Renvoyer un résultat typé avec output_type | Sortie structurée |
| Répartir le travail entre des agents enfants | Sous-agents |
| Déclarer les identifiants et appliquer les politiques | Secrets et Les mécanismes de contrôle |
| Personnaliser la boucle de l'agent | Hooks personnalisés |
Ces fonctionnalités du SDK ne garantissent pas une compatibilité directe avec les outils ou handoffs de l'ancienne API. Consultez chaque guide pour vérifier sa configuration et ses limites.
Exécuter en production
Commencez dans votre processus pendant le développement. Pour une exécution durable, le SDK prend en charge les workers auto-hébergés et ceux gérés par Mistral. Le guide des modes d'exécution explique l'enregistrement, le déploiement, les sessions, le traçage et le code compatible avec le replay.
- Agents managés : Mistral héberge le worker.
- Agents auto-hébergés : vous exécutez le worker ; Mistral assure l'orchestration.