- W&B Python SDK (
wandb.sdk) : pour enregistrer et surveiller les expériences pendant l’entraînement. - API publique W&B (
wandb.apis.public) : pour interroger et analyser les données d’expérience enregistrées. - API W&B Reports and Workspaces (
wandb.wandb-workspaces) : pour créer un rapport afin de résumer les résultats.
Inscrivez-vous et créez une clé API
Pour authentifier votre machine auprès de W&B, vous devez d’abord générer une clé API sur wandb.ai/settings. Copiez la clé API et conservez-la en lieu sûr.Installer et importer des packages
Installez la bibliothèque W&B ainsi que quelques autres packages dont vous aurez besoin pour ce guide pas à pas.Entraîner un modèle
Le code suivant simule un flux de travail de machine learning de base : entraîner un modèle, consigner des métriques et enregistrer le modèle en tant qu’artifact. Utilisez le SDK Python W&B (wandb.sdk) pour interagir avec W&B pendant l’entraînement. Consignez la perte à l’aide de wandb.Run.log(), puis enregistrez le modèle entraîné en tant qu’artifact avec wandb.Artifact, avant d’ajouter le fichier du modèle avec Artifact.add_file.
- Utilisez
wandb.Run.log()pour consigner des métriques pendant l’entraînement. - Utilisez
wandb.Artifactpour enregistrer des modèles (jeux de données, etc.) en tant qu’artifact dans votre projet W&B.
wandb.Run.use_artifact() pour récupérer l’artifact de votre projet et le préparer à être publié dans le registre de modèles. wandb.Run.use_artifact() remplit deux fonctions clés :
- Récupérer l’objet artifact depuis votre projet.
- Marquer l’artifact comme entrée du run, ce qui garantit la reproductibilité et la traçabilité. Voir Créer et afficher la carte de traçabilité pour plus de détails.
Voir les données d’entraînement dans le tableau de bord
Connectez-vous à votre compte à https://wandb.ai/login Sous Projects, vous devriez voirmy-awesome-project (ou le nom de projet que vous avez utilisé plus haut). Cliquez dessus pour accéder au Workspace de votre projet.
Vous pouvez ensuite voir les détails de chaque run que vous avez effectué. Dans cette capture d’écran, le code a été relancé plusieurs fois, ce qui a généré plusieurs runs, chacun portant un nom généré aléatoirement.

Publier le modèle dans le registre W&B
Pour partager le modèle avec d’autres personnes de votre organisation, publiez-le dans une collection à l’aide dewandb.Run.link_artifact(). Le code suivant associe l’artifact à un registre, ce qui le rend accessible à votre équipe.
wandb.Run.link_artifact(), l’artifact de modèle se trouvera dans la collection DemoModels de votre registre. Vous pouvez ensuite consulter des informations telles que l’historique des versions, la carte de traçabilité et d’autres métadonnées.
Pour en savoir plus sur la façon de lier des artifacts à un registre, consultez Lier des artifacts à un registre.
Récupérer un artifact de modèle du registre pour l’inférence
Pour utiliser un modèle pour l’inférence, utilisezwandb.Run.use_artifact() afin de récupérer l’artifact publié dans le registre. Cette méthode renvoie un objet artifact, que vous pouvez ensuite télécharger dans un fichier local à l’aide de wandb.Artifact.download().
Partagez vos résultats avec un rapport
L’API W&B Report and Workspace est en préversion publique.