> ## Documentation Index
> Fetch the complete documentation index at: https://docs.wandb.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# タグ を使って runs にラベルを追加する

> Python SDK、Public API、または W&B App UI を使用して、W&B runs の タグ を追加、更新、削除し、整理のために活用します。

ログされたメトリクスや artifact データだけでは分かりにくい特定の features を示すために、runs に タグ を追加します。

たとえば、run のモデルが `in_production` であること、その run が `preemptible` であること、その run が `baseline` を表していることなどを示す タグ を追加できます。

<div id="add-tags-to-one-or-more-runs">
  ## 1 つ以上の run にタグを追加する
</div>

プログラムから、またはインタラクティブに run にタグを追加できます。

ユースケースに応じて、ニーズに最も適した以下のタブを選択してください。

<Tabs>
  <Tab title="W&B Python SDK">
    run の初期化時にタグを追加するには、`wandb.init()` を使用します。run にタグを追加するには、`wandb.init()` の `tags` パラメーターに文字列のリストを渡します。例:

    ```python theme={null}
    import wandb

    with wandb.init(
      entity="<entity>",
      project="<project>",
      tags=["<tag1>", "<tag2>"]
    ) as run:
        # ここにトレーニングコードを記述します
    ```

    アクティブな run の実行中に、既存のタグを追加または更新するには、run オブジェクトの `tags` 属性 (`wandb.Run.tags`) を更新することもできます。`tags` 属性は文字列のタプルを受け入れます。run の初期化後に新しいタグを追加するには、既存の run のタグ プロパティに 1 つ以上のタグを連結します。

    ```python theme={null}
    import wandb

    with wandb.init(entity="<entity>", project="<project>", tags=["<tag1>"]) as run:
      # ここにトレーニングループのロジックを記述します

      # run オブジェクトに新しいタグを追加します
      run.tags += ("<new_tag>",)
    ```
  </Tab>

  <Tab title="Public API">
    以前に保存した run にタグを追加または更新するには、[W\&B Public API](/ja/models/ref/python/public-api) を使用します。

    既存の run のタグを更新するには、`wandb.Run.tags` プロパティにアクセスします。`wandb.Run.tags` プロパティは文字列のリストで構成されます。新しいタグを既存のタグに連結し、その後 `wandb.Run.update()` を呼び出して、新しいタグで run を更新します。例:

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

  <Tab title="Project ページ">
    この方法は、多数の run に同じタグを付ける場合に最適です。

    1. project のワークスペースにアクセスします。
    2. プロジェクトのサイドバーから **Runs** を選択します。
    3. 表から 1 つ以上の run を選択します。
    4. 1 つ以上の run を選択したら、表の上にある **Tag** ボタンを選択します。
    5. 追加するタグを入力し、**Create new tag** チェックボックスを選択してタグを追加します。
  </Tab>

  <Tab title="Run ページ">
    この方法は、単一の run に手動でタグを付ける場合に最適です。

    1. project のワークスペースにアクセスします。
    2. run をクリックして開きます。run ページが開き、既定では **Overview** タブが表示されます。
    3. **Tags** の横にある灰色のプラス アイコン (**+**) ボタンを選択します。
    4. 追加するタグを入力し、テキスト ボックスの下にある **Add** を選択して新しいタグを追加します。
  </Tab>
</Tabs>

<div id="remove-tags-from-one-or-more-runs">
  ## 1 つ以上の run からタグを削除する
</div>

W\&B App で run からタグを削除するには、次の step に従います。

<Tabs>
  <Tab title="Project ページ">
    この method は、多数の Runs からタグを削除する場合に最適です。

    1. project の Run サイドバーで、右上の表アイコンを選択します。サイドバーが展開され、Runs 表 全体が表示されます。
    2. 表内の run にカーソルを合わせると、左側にチェックボックスが表示されます。すべての Runs を選択するには、ヘッダー行のチェックボックスを使用します。
    3. チェックボックスを選択して、一括 action を有効にします。
    4. タグを削除する Runs を選択します。
    5. Runs の行の上にある **Tag** ボタンを選択します。
    6. タグの横にあるチェックボックスを選択して、そのタグを run から削除します。
  </Tab>

  <Tab title="Run ページ">
    1. Run ページの左サイドバーで、一番上の **Overview** タブを選択します。ここに run のタグが表示されます。
    2. タグにカーソルを合わせて "x" を選択し、そのタグを run から削除します。
  </Tab>
</Tabs>