> ## Documentation Index
> Fetch the complete documentation index at: https://wb-21fd5541-mintlify-8476678c.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# 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.

<div id="add-tags-to-one-or-more-runs">
  ## Ajouter des tags à un ou plusieurs runs
</div>

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 :

<Tabs>
  <Tab title="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 :

    ```python theme={null}
    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 :

    ```python theme={null}
    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>",)
    ```
  </Tab>

  <Tab title="API publique">
    Utilisez la [W\&B Public API](/fr/models/ref/python/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 :

    ```python theme={null}
    with wandb.Api().run("{entity}/{project}/{run-id}") as run:
      run.tags.append("<tag1>")
      run.update()
    ```
  </Tab>

  <Tab title="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.
  </Tab>

  <Tab title="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.
  </Tab>
</Tabs>

<div id="remove-tags-from-one-or-more-runs">
  ## Supprimer des tags d’un ou de plusieurs runs
</div>

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

<Tabs>
  <Tab title="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.
  </Tab>

  <Tab title="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.
  </Tab>
</Tabs>