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

# launch_add

<Card title="소스 코드 보기" href="https://www.github.com/wandb/wandb/tree/v0.20.1/wandb/sdk/launch/_launch_add.py#L34-L131" icon="code" />

소스 URI, 작업 또는 docker\_image를 사용하여 W\&B Launch 실험을 큐에 추가합니다.

```python theme={"system"}
launch_add(
    uri: Optional[str] = None,
    job: Optional[str] = None,
    config: Optional[Dict[str, Any]] = None,
    template_variables: Optional[Dict[str, Union[float, int, str]]] = None,
    project: Optional[str] = None,
    entity: Optional[str] = None,
    queue_name: Optional[str] = None,
    resource: Optional[str] = None,
    entry_point: Optional[List[str]] = None,
    name: Optional[str] = None,
    version: Optional[str] = None,
    docker_image: Optional[str] = None,
    project_queue: Optional[str] = None,
    resource_args: Optional[Dict[str, Any]] = None,
    run_id: Optional[str] = None,
    build: Optional[bool] = (False),
    repository: Optional[str] = None,
    sweep_id: Optional[str] = None,
    author: Optional[str] = None,
    priority: Optional[int] = None
) -> "public.QueuedRun"
```

| 인수 | 설명 |
| :- | :- |
| `uri` | 실행할 실험의 URI입니다. wandb run URI 또는 Git 저장소 URI입니다. |
| `job` | wandb.Job에 대한 string 레퍼런스입니다. 예: wandb/test/my-job:latest |
| `config` | run의 설정을 담은 딕셔너리입니다. "resource\_args" 키 아래에 리소스별 인수를 포함할 수도 있습니다. |
| `template_variables` | run 큐의 템플릿 변수 값을 담은 딕셔너리입니다. 예상 형식은 `{"VAR_NAME": VAR_VALUE}`입니다. |
| `project` | 시작된 run을 보낼 대상 프로젝트입니다. |
| `entity` | 시작된 run을 보낼 대상 entity입니다. |
| `queue` | run을 추가할 큐의 이름입니다. |
| `priority` | 작업의 우선순위 수준입니다. 1이 가장 높은 우선순위입니다. |
| `resource` | run의 실행 백엔드입니다. W\&B는 "local-container" 백엔드를 기본으로 지원합니다. |
| `entry_point` | 프로젝트 내에서 실행할 진입점입니다. 기본값은 wandb URI의 경우 원본 run에서 사용한 진입점이고, Git 저장소 URI의 경우 main.py입니다. |
| `name` | run을 시작할 때 사용할 run 이름입니다. |
| `version` | Git 기반 프로젝트의 경우 커밋 해시 또는 브랜치 이름입니다. |
| `docker_image` | run에 사용할 도커 이미지의 이름입니다. |
| `resource_args` | 원격 백엔드에서 run을 시작하기 위한 리소스 관련 인수입니다. 생성된 launch 설정의 `resource_args` 아래에 저장됩니다. |
| `run_id` | 시작된 run의 ID를 나타내는 선택적 string입니다. |
| `build` | 기본값이 false인 선택적 플래그입니다. build를 사용하려면 queue를 설정해야 하며, 이미지를 생성하고 작업 아티팩트를 만든 뒤 해당 작업 아티팩트에 대한 레퍼런스를 큐에 푸시합니다. |
| `repository` | 이미지를 레지스트리에 푸시할 때 사용하는 원격 저장소의 이름을 지정하는 선택적 string입니다. |
| `project_queue` | 큐의 프로젝트 이름을 지정하는 선택적 string입니다. 주로 프로젝트 범위 큐와의 하위 호환성을 위해 사용합니다. |

<h4 id="example">
  예시:
</h4>

```python theme={"system"}
from wandb.sdk.launch import launch_add

project_uri = "https://github.com/wandb/examples"
params = {"alpha": 0.5, "l1_ratio": 0.01}
# 로컬 호스트에서 W&B 프로젝트를 실행하고
# 재현 가능한 도커 환경을 생성합니다
api = wandb.apis.internal.Api()
launch_add(uri=project_uri, parameters=params)
```

| 반환값 | 설명 |
| :- | :- |
| 큐에 추가된 run에 대한 정보를 제공하거나, `wait_until_started` 또는 `wait_until_finished`가 호출되면 내부 run 정보에 대한 액세스를 제공하는 `wandb.api.public.QueuedRun`의 인스턴스입니다. | |

| 예외 | 설명 |
| :- | :- |
| 실패한 경우 `wandb.exceptions.LaunchError` | |