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

# Reports 및 Workspaces API 개요

> W&B Reports 및 Workspaces API를 사용하여 리포트와 워크스페이스를 프로그래밍 방식으로 생성하고 관리하세요

`wandb_workspaces`로 액세스할 수 있는 W\&B Reports 및 Workspaces API를 사용하면 [리포트](/ko/products/wandb/reports)를 생성하여 웹에 게시하고 발견 사항을 공유할 수 있으며, 트레이닝 및 파인튜닝 작업을 진행한 [워크스페이스](/ko/products/wandb/app/features/cascade-settings)를 사용자 지정할 수도 있습니다.

<Card title="소스 코드 보기" href="https://github.com/wandb/wandb-workspaces/blob/main/wandb_workspaces/" icon="code" />

<Note>
  W\&B Report and Workspace API는 현재 공개 프리뷰 단계입니다.
</Note>

<h2 id="installation-and-setup">
  설치 및 설정
</h2>

<h3 id="sign-up-and-create-an-api-key">
  가입 및 API 키 생성
</h3>

W\&B에서 머신을 인증하려면 먼저 [User Settings](https://forge.coreweave.com/settings)에서 API 키를 생성해야 합니다.

<h3 id="install-and-import-packages">
  패키지 설치 및 임포트
</h3>

W\&B Report and Workspaces 라이브러리를 설치하세요.

```python theme={"system"}
pip install wandb-workspaces
```

<h3 id="create-a-report">
  리포트 만들기
</h3>

리포트를 만들려면 팀의 entity를 지정하고 리포트 이름을 입력하세요. 괄호로 묶인 텍스트를 실제 값으로 바꾸세요.

```python theme={"system"}
import wandb_workspaces.reports.v2 as wr 
# 리포트 생성
report = wr.Report(
    entity="<team_entity>",
    project="<project_name>",
    title='Quickstart Report',
    description="That was easy!"
)

# 리포트 저장
report.save()
```

다음으로 리포트에 블록과 패널을 추가하세요. 예를 들어 다음 코드는 목차, 헤더, 단락으로 구성된 리포트를 생성합니다.

```python theme={"system"}
report.blocks = [
    wr.TableOfContents(),
    wr.H1("Text and images example"),
    wr.P("Lorem ipsum dolor sit amet."),
]
report.save()
```

전체 과정을 보여 주는 예시는 [Reports API 퀵스타트](https://colab.research.google.com/github/wandb/examples/blob/master/colabs/intro/Report_API_Quickstart.ipynb) Google Colab 노트북을 참조하세요.

<h3 id="create-a-workspace">
  워크스페이스 만들기
</h3>

다음 코드는 선형 플롯, 막대 플롯, 스칼라 차트 등 세 개의 패널이 포함된 섹션으로 워크스페이스를 만드는 방법을 보여줍니다. 묶여 있는 텍스트를 사용자의 값으로 바꾸세요.

```python theme={"system"}
# 임포트 방법
import wandb_workspaces.workspaces as ws

# 워크스페이스 생성
ws.Workspace(
     entity="<team_entity>", # 워크스페이스를 소유한 entity
     project="<project_name>", # 워크스페이스와 연결된 프로젝트
     sections=[
         ws.Section(
             name="<Validation Metrics>",
             panels=[
                 wr.LinePlot(x="Step", y=["<val_loss>"]),
                 wr.BarPlot(metrics=["<val_accuracy>"]),
                 wr.ScalarChart(metric="<f1_score>", groupby_aggfunc="<mean>"),
             ],
             is_open=True,
         ),
     ],
)
workspace.save()
```

전체 과정을 보여 주는 엔드 투 엔드 예시는 [Workspace API 퀵스타트](https://colab.research.google.com/github/wandb/wandb-workspaces/blob/Update-wandb-workspaces-tuturial/Workspace_tutorial.ipynb#scrollTo=MmxL0wjvrNtQ) Google Colab 노트북을 참조하세요.