Skip to main content
머신러닝 워크플로에서 W&B를 언제, 어떻게 사용해 모델 아티팩트를 추적, 공유, 관리하는지 알아보세요. 이 페이지에서는 실험 로깅과 리포트 생성, 그리고 작업별로 적합한 W&B API를 사용해 로깅된 데이터에 액세스하는 방법을 다룹니다. 이 튜토리얼에서는 다음을 사용합니다.
  • W&B Python SDK (wandb.sdk): 트레이닝 중에 실험을 로깅하고 모니터링합니다.
  • W&B Public API (wandb.apis.public): 로깅된 실험 데이터를 쿼리하고 분석합니다.
  • W&B Reports and Workspaces API (wandb.wandb-workspaces): 발견 사항을 요약한 리포트를 생성합니다.

가입 및 API 키 생성

W&B에서 머신을 인증하려면 먼저 forge.coreweave.com/settings에서 API 키를 생성해야 합니다. 생성한 API 키는 복사하여 안전한 곳에 보관하세요.

패키지 설치 및 임포트

W&B 라이브러리와 이 워크스루에 필요한 기타 패키지를 설치하세요.
W&B Python SDK를 임포트하세요.
다음 코드 블록에 팀의 entity를 지정하세요.

모델 트레이닝하기

다음 코드는 모델 트레이닝, 메트릭 로깅, 모델의 아티팩트 저장으로 이루어진 기본 머신러닝 워크플로를 시뮬레이션합니다. 트레이닝 중에 W&B와 상호작용하려면 W&B Python SDK(wandb.sdk)를 사용하세요. wandb.Run.log()로 손실을 로깅한 다음, wandb.Artifact로 트레이닝된 모델을 아티팩트로 저장하고, 마지막으로 Artifact.add_file로 모델 파일을 추가합니다.
이전 코드 블록의 핵심 내용은 다음과 같습니다.
  • 트레이닝 중에 메트릭을 로깅하려면 wandb.Run.log()를 사용하세요.
  • 모델(데이터셋 등)을 W&B 프로젝트에 아티팩트로 저장하려면 wandb.Artifact를 사용하세요.
모델을 트레이닝하고 아티팩트로 저장했으니 이제 W&B의 레지스트리에 게시할 수 있습니다. wandb.Run.use_artifact()를 사용하여 프로젝트에서 아티팩트를 가져오고 모델 레지스트리에 게시할 준비를 하세요. wandb.Run.use_artifact()의 주요 역할은 다음 두 가지입니다.
  • 프로젝트에서 아티팩트 객체를 가져옵니다.
  • 아티팩트를 run의 입력으로 표시하여 재현성과 추적성을 보장합니다. 자세한 내용은 Lineage 맵 생성 및 보기를 참조하세요.

대시보드에서 트레이닝 데이터 보기

W&B 대시보드로 이동하세요. Projects 탭을 선택하고 my-awesome-project(또는 위에서 프로젝트 이름으로 지정한 값)를 검색하세요. 검색된 프로젝트를 클릭하면 해당 프로젝트의 워크스페이스로 이동합니다. 여기에서 지금까지 실행한 모든 run의 세부 정보를 확인할 수 있습니다. 이 스크린샷에서는 코드를 여러 번 다시 실행해 여러 개의 run이 생성되었으며, 각 run에는 무작위로 생성된 이름이 부여되어 있습니다.
run 이름, 메트릭, 상태 정보와 함께 여러 run이 table 뷰로 표시된 W&B 프로젝트 페이지

모델을 레지스트리에 게시하기

조직 내 다른 구성원과 모델을 공유하려면 wandb.Run.link_artifact()를 사용하여 모델을 컬렉션에 게시하세요. 다음 코드는 아티팩트를 레지스트리에 연결하여 팀원들이 액세스할 수 있게 합니다.
wandb.Run.link_artifact()를 실행하면 모델 아티팩트가 레지스트리의 DemoModels 컬렉션에 추가됩니다. 여기에서 버전 이력, Lineage 맵, 기타 메타데이터 등의 세부 정보를 확인할 수 있습니다. 아티팩트를 레지스트리에 연결하는 방법에 대한 자세한 내용은 레지스트리에 아티팩트 연결하기를 참조하세요.

추론을 위해 레지스트리에서 모델 아티팩트 가져오기

모델을 추론에 사용하려면 wandb.Run.use_artifact()로 레지스트리에 게시된 아티팩트를 가져오세요. 이 메서드는 아티팩트 객체를 반환하며, 이 객체에서 wandb.Artifact.download()를 호출하면 아티팩트를 로컬 파일로 다운로드할 수 있습니다.
레지스트리에서 아티팩트를 가져오는 방법에 대한 자세한 내용은 레지스트리에서 아티팩트 다운로드하기를 참조하세요. 사용하는 머신러닝 프레임워크에 따라 가중치를 로드하기 전에 모델 아키텍처를 다시 구성해야 할 수 있습니다. 구체적인 방법은 사용하는 프레임워크와 모델에 따라 다르므로 여기서는 다루지 않습니다.

리포트로 발견 사항 공유하기

W&B Report and Workspace API는 공개 프리뷰 단계입니다.
리포트를 만들고 공유하여 작업 내용을 요약하세요. 리포트를 프로그래밍 방식으로 만들려면 W&B Report and Workspace API를 사용하세요. 먼저 W&B Reports API를 설치하세요.
다음 코드 블록은 Markdown, 패널 그리드 등 여러 블록으로 구성된 리포트를 생성합니다. 블록을 더 추가하거나 기존 블록의 내용을 변경하여 리포트를 사용자 지정할 수 있습니다. 코드 블록을 실행하면 생성된 리포트의 URL 링크가 출력됩니다. 브라우저에서 이 링크를 열어 리포트를 확인하세요.
프로그래밍 방식으로 리포트를 만드는 방법이나 W&B App에서 대화형으로 리포트를 만드는 방법에 대한 자세한 내용은 W&B Docs 개발자 가이드의 리포트 만들기를 참조하세요.

레지스트리 쿼리하기

W&B Public APIs를 사용하면 W&B의 과거 데이터를 쿼리, 분석, 관리할 수 있습니다. 이를 활용하면 아티팩트의 리니지를 추적하거나, 여러 버전을 비교하거나, 시간에 따른 모델 성능을 분석하는 데 유용합니다. 다음 코드 블록은 모델 레지스트리에서 특정 컬렉션에 속한 모든 아티팩트를 쿼리하는 방법을 보여줍니다. 이 코드는 컬렉션을 가져온 뒤 해당 버전을 순회하면서 각 아티팩트의 이름과 버전을 출력합니다.
레지스트리를 쿼리하는 방법에 대한 자세한 내용은 레지스트리 항목 쿼리를 참조하세요.
마지막 수정일 2026년 9월 30일