Skip to main content
Découvrez quand et comment utiliser W&B pour suivre, partager et gérer des artifacts de modèle dans vos flux de travail de machine learning. Cette page explique comment journaliser des expériences, générer des rapports et accéder aux données journalisées à l’aide de l’API W&B adaptée à chaque tâche. Ce tutoriel utilise les éléments suivants :
  • SDK Python W&B (wandb.sdk) : pour journaliser et surveiller les expériences pendant l’entraînement.
  • API publique de W&B (wandb.apis.public) : pour interroger et analyser les données d’expérience journalisées.
  • API W&B Reports and Workspaces (wandb.wandb-workspaces) : pour créer un rapport qui synthétise vos constats.

S’inscrire et créer une clé API

Pour authentifier votre machine auprès de W&B, vous devez d’abord générer une clé API sur forge.coreweave.com/settings. Copiez la clé API et conservez-la en lieu sûr.

Installer et importer les paquets

Installez la bibliothèque W&B ainsi que les autres paquets nécessaires à ce guide pas à pas.
Importez le SDK Python W&B :
Indiquez l’entity de votre équipe dans le bloc de code suivant :

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. Journalisez la perte avec wandb.Run.log(), puis enregistrez le modèle entraîné en tant qu’artifact avec wandb.Artifact, et ajoutez enfin le fichier du modèle avec Artifact.add_file.
Voici les points essentiels à retenir du bloc de code précédent :
  • Utilisez wandb.Run.log() pour consigner des métriques pendant l’entraînement.
  • Utilisez wandb.Artifact pour enregistrer des modèles (ou des jeux de données, etc.) en tant qu’artifact dans votre projet W&B.
Maintenant que vous avez entraîné un modèle et que vous l’avez enregistré en tant qu’artifact, vous pouvez le publier dans un registre W&B. Utilisez wandb.Run.use_artifact() pour récupérer l’artifact depuis votre projet et le préparer à sa publication dans le registre de modèles. wandb.Run.use_artifact() remplit deux fonctions essentielles :
  • Il récupère l’objet artifact depuis votre projet.
  • Il marque l’artifact comme entrée du run, ce qui garantit la reproductibilité et la traçabilité. Pour plus de détails, consultez Créer et afficher une carte de traçabilité.

Afficher les données d’entraînement dans le tableau de bord

Accédez à votre tableau de bord W&B. Sélectionnez l’onglet Projects et recherchez my-awesome-project (ou le nom de projet que vous avez choisi ci-dessus). Cliquez dessus pour ouvrir le workspace de votre projet. Vous y trouverez les détails de chacun de vos runs. Dans cette capture d’écran, le code a été exécuté à plusieurs reprises, ce qui a produit plusieurs runs, chacun doté d’un nom généré aléatoirement.
Page d’un projet W&B présentant plusieurs runs dans une vue en tableau, avec les noms des runs, les métriques et les informations de statut

Publier le modèle dans le registre

Pour partager le modèle avec d’autres membres de votre organisation, publiez-le dans une collection à l’aide de wandb.Run.link_artifact(). Le code suivant associe l’artifact à un registre afin de le rendre accessible à votre équipe.
Après l’exécution de wandb.Run.link_artifact(), l’artifact de modèle figure dans la collection DemoModels de votre registre. Vous pouvez alors consulter des informations détaillées, comme l’historique des versions, la carte de traçabilité et d’autres métadonnées. Pour en savoir plus sur la liaison d’artifacts à un registre, consultez Lier des artifacts à un registre.

Récupérer un artifact de modèle depuis le registre pour l’inférence

Pour utiliser un modèle à des fins d’inférence, récupérez l’artifact publié depuis le registre à l’aide de wandb.Run.use_artifact(). Cette méthode renvoie un objet artifact sur lequel vous pouvez ensuite appeler wandb.Artifact.download() pour télécharger l’artifact dans un fichier local.
Pour plus d’informations sur la façon de récupérer des artifacts depuis un registre, voir Télécharger un artifact depuis un registre. Selon votre framework de machine learning, vous devrez peut-être recréer l’architecture du modèle avant de charger les poids. Cette étape n’est pas détaillée ici, car elle dépend du framework et du modèle que vous utilisez.

Partager vos résultats dans un rapport

L’API W&B Report and Workspace est en préversion publique.
Créez et partagez un rapport pour synthétiser votre travail. Pour créer un rapport par programmation, utilisez l’API W&B Report and Workspace. Commencez par installer l’API W&B Reports :
Le bloc de code suivant crée un rapport comportant plusieurs blocs, notamment du markdown, des grilles de panneaux, etc. Vous pouvez personnaliser le rapport en ajoutant d’autres blocs ou en modifiant le contenu des blocs existants. Le bloc de code affiche en sortie un lien vers l’URL du rapport créé. Ouvrez ce lien dans votre navigateur pour consulter le rapport.
Pour plus d’informations sur la création d’un rapport par programmation ou de manière interactive dans l’application W&B, consultez Créer un rapport dans le guide du développeur de la documentation W&B.

Interroger le registre

Utilisez les API publiques W&B pour interroger, analyser et gérer les données historiques de W&B. Elles vous permettent notamment de suivre la traçabilité des artifacts, de comparer différentes versions et d’analyser l’évolution des performances des modèles. Le bloc de code suivant montre comment interroger le registre de modèles pour obtenir tous les artifacts d’une collection donnée. Il récupère la collection, puis parcourt ses versions en affichant le nom et la version de chaque artifact.
Pour plus d’informations sur l’interrogation du registre, consultez la section Interroger les éléments du registre.
Dernière modification le 30 septembre 2026