Ajouter des tags aux runs

Ajoutez, mettez à jour et supprimez des tags sur les runs W&B à l’aide du SDK Python, de l’API publique ou de l’interface de l’application W&B pour les organiser.

Ajoutez des tags pour identifier des runs à l’aide de caractéristiques particulières qui ne ressortent pas forcément des métriques enregistrées ni des données d’artefact.

Par exemple, vous pouvez ajouter un tag à un run pour indiquer que le modèle de ce run est in_production, que ce run est preemptible, qu’il correspond à la baseline, etc.

​

Ajouter des tags à un ou plusieurs runs

Ajoutez des tags à vos runs par programmation ou de manière interactive.

Selon votre cas d’utilisation, sélectionnez ci-dessous l’onglet qui correspond le mieux à vos besoins :

SDK Python W&B

Utilisez wandb.init() pour ajouter des tags lorsque vous initialisez un run. Passez une liste de chaînes au paramètre tags dans wandb.init() pour ajouter des tags à un run. Par exemple :

import wandb

with wandb.init(
  entity="<entity>",
  project="<project>",
  tags=["<tag1>", "<tag2>"]
) as run:
    # Votre code d'entraînement ici

Vous pouvez également ajouter ou mettre à jour un tag existant pendant un run actif en mettant à jour l’attribut tags de l’objet run (wandb.Run.tags). L’attribut tags accepte un tuple de chaînes. Concaténez un ou plusieurs tags à la propriété de tags existante du run pour ajouter de nouveaux tags après l’initialisation du run :

import wandb

with wandb.init(entity="<entity>", project="<project>", tags=["<tag1>"]) as run:
  # Logique de la boucle d'entraînement ici

  # Ajouter un nouveau tag à l'objet run
  run.tags += ("<new_tag>",)

API publique

Utilisez la W&B Public API pour ajouter ou mettre à jour des tags sur un run précédemment enregistré.

Pour mettre à jour les tags d’un run existant, accédez à la propriété wandb.Run.tags. La propriété wandb.Run.tags contient une liste de chaînes. Concaténez le ou les nouveaux tags aux tags existants, puis appelez wandb.Run.update() pour mettre à jour le run avec les nouveaux tags. Par exemple :

with wandb.Api().run("{entity}/{project}/{run-id}") as run:
  run.tags.append("<tag1>")
  run.update()

Page du projet

Cette méthode convient le mieux pour ajouter le même tag ou les mêmes tags à un grand nombre de runs.

1. Accédez à l’espace de travail de votre projet.
2. Sélectionnez Runs dans la barre latérale du projet.
3. Sélectionnez un ou plusieurs runs dans le tableau.
4. Une fois un ou plusieurs runs sélectionnés, cliquez sur le bouton Tag au-dessus du tableau.
5. Saisissez le tag à ajouter, puis cochez la case Create new tag pour l’ajouter.

Page du run

Cette méthode convient le mieux pour appliquer manuellement un ou plusieurs tags à un seul run.

1. Accédez à l’espace de travail de votre projet.
2. Cliquez sur un run pour l’ouvrir. La page du run s’ouvre avec l’onglet Overview affiché par défaut.
3. Sélectionnez le bouton avec l’icône plus grise (+) à côté de Tags.
4. Saisissez le tag à ajouter, puis sélectionnez Add sous la zone de texte pour ajouter un nouveau tag.

​

Supprimer des tags d’un ou de plusieurs runs

Suivez ces étapes pour supprimer des tags d’un run dans la W&B App.

Page du projet

Cette méthode est particulièrement adaptée pour supprimer des tags d’un grand nombre de runs.

1. Dans la barre latérale du run du projet, sélectionnez l’icône de tableau en haut à droite. Cela développe la barre latérale en tableau complet des runs.
2. Survolez un run dans le tableau pour faire apparaître une case à cocher à gauche, ou repérez dans la ligne d’en-tête une case à cocher permettant de sélectionner tous les runs.
3. Sélectionnez la case à cocher pour activer les actions groupées.
4. Sélectionnez les runs dont vous souhaitez supprimer les tags.
5. Sélectionnez le bouton Tag au-dessus des lignes de runs.
6. Sélectionnez la case à cocher à côté d’un tag pour le supprimer du run.

Page du run

1. Dans la barre latérale gauche de la page du run, sélectionnez l’onglet Overview en haut. Les tags du run y sont visibles.
2. Survolez un tag et sélectionnez le « x » pour le supprimer du run.