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

# 태그로 run에 레이블 추가

> Python SDK, Public API 또는 조직용 W&B App UI를 사용해 W&B run의 태그를 추가, 업데이트, 제거하세요.

로깅된 메트릭이나 아티팩트 데이터만으로는 바로 드러나지 않을 수 있는 특정 특성으로 run에 레이블을 지정하려면 태그를 추가하세요.

예를 들어, run의 모델이 `in_production` 상태이거나, 해당 run이 `preemptible`이거나, 이 run이 `baseline`임을 나타내도록 run에 태그를 추가할 수 있습니다.

<div id="add-tags-to-one-or-more-runs">
  ## 하나 이상의 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의 태그 속성에 하나 이상의 태그를 이어 붙이세요:

    ```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](/ko/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="프로젝트 페이지">
    이 방법은 많은 수의 run에 동일한 태그 하나 또는 여러 개를 지정할 때 가장 적합합니다.

    1. 프로젝트 Workspace로 이동하세요.
    2. 프로젝트 사이드바에서 **Runs**를 선택하세요.
    3. 테이블에서 하나 이상의 run을 선택하세요.
    4. 하나 이상의 run을 선택한 후 테이블 위의 **Tag** 버튼을 선택하세요.
    5. 추가할 태그를 입력한 다음 **Create new tag** 체크박스를 선택해 태그를 추가하세요.
  </Tab>

  <Tab title="Run 페이지">
    이 방법은 단일 run에 태그 하나 또는 여러 개를 수동으로 적용할 때 가장 적합합니다.

    1. 프로젝트 Workspace로 이동하세요.
    2. run을 클릭해 여세요. run 페이지가 열리면 기본적으로 **Overview** 탭이 표시됩니다.
    3. **Tags** 옆의 회색 더하기 아이콘(**+**) 버튼을 선택하세요.
    4. 추가할 태그를 입력한 다음 텍스트 상자 아래의 **Add**를 선택해 새 태그를 추가하세요.
  </Tab>
</Tabs>

<div id="remove-tags-from-one-or-more-runs">
  ## 하나 이상의 run에서 태그 제거
</div>

W\&B App에서 run의 태그를 제거하려면 다음 단계를 따르세요.

<Tabs>
  <Tab title="프로젝트 페이지">
    이 방법은 많은 수의 run에서 태그를 제거할 때 가장 적합합니다.

    1. 프로젝트의 Run 사이드바에서 오른쪽 상단의 테이블 아이콘을 선택하세요. 그러면 사이드바가 전체 Runs 테이블로 확장됩니다.
    2. 테이블에서 run 위에 마우스를 올리면 왼쪽에 체크박스가 표시됩니다. 모든 run을 선택하려면 헤더 행의 체크박스를 사용하세요.
    3. 체크박스를 선택하여 일괄 액션을 사용 설정하세요.
    4. 태그를 제거할 run을 선택하세요.
    5. run 행 위에 있는 **Tag** 버튼을 선택하세요.
    6. 태그 옆의 체크박스를 선택하여 run에서 해당 태그를 제거하세요.
  </Tab>

  <Tab title="Run 페이지">
    1. Run 페이지의 왼쪽 사이드바에서 맨 위의 **Overview** 탭을 선택하세요. 여기에서 run의 태그를 확인할 수 있습니다.
    2. 태그 위에 마우스를 올린 다음 "x"를 선택하여 run에서 제거하세요.
  </Tab>
</Tabs>
