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

# Weave 프롬프트를 컬렉션에 연결하기

Weave 프롬프트 객체를 컬렉션에 연결하면 레지스트리에서 AI 프롬프트를 추적하고 버전별로 관리할 수 있습니다. 프롬프트 객체를 [컬렉션](/ko/products/registry/create_collection)에 *연결*하면 프롬프트 버전의 범위가 [비공개 프로젝트 수준에서 공유 조직 수준으로](/ko/products/registry/create_registry#visibility-types) 이동합니다.

<Note>
  시작하기 전에 다음 사항을 확인하세요.

  * 컬렉션에서 허용하는 객체 유형. 컬렉션 유형에 대한 자세한 내용은 [컬렉션 생성](/ko/products/registry/create_collection)의 "컬렉션 유형"을 참조하세요.
  * 컬렉션이 속한 레지스트리가 이미 존재하는지 여부. 레지스트리가 존재하는지 확인하려면 [Registry App으로 이동하여](/ko/products/registry/search_registry) 레지스트리 이름을 검색하세요.
</Note>

AI 프롬프트를 추적하고 관리하려면 Weave Python SDK를 사용하세요. Weave Python SDK로 프롬프트 객체를 생성하고 게시한 뒤 레지스트리의 컬렉션에 연결할 수 있습니다.

프롬프트를 레지스트리의 컬렉션에 연결하는 단계는 다음과 같습니다.

1. `weave.init()`으로 Weave 클라이언트를 초기화합니다.
2. [`weave.StringPrompt()`](/ko/products/wandb/weave/reference/python-sdk#class-stringprompt) 등의 기본 제공 프롬프트 클래스로 Weave 프롬프트 객체를 생성합니다.
   <Tip>
     `weave.StringPrompt`는 system 프롬프트, 사용자 프롬프트, 재사용 가능한 텍스트 템플릿처럼 단일 문자열로 된 프롬프트를 위한 기본 제공 프롬프트 클래스입니다. Weave에서 프롬프트 객체를 생성하는 방법과 지원되는 프롬프트 유형에 대한 자세한 내용은 [프롬프트 객체 생성](/ko/products/wandb/weave/guides/core-types/prompts)을 참조하세요.
   </Tip>
3. [`weave.publish()`](/ko/products/wandb/weave/reference/python-sdk#method-publish)로 프롬프트를 Weave에 게시합니다.
4. [`weave_client.link_prompt_to_registry()`](/ko/products/wandb/weave/reference/python-sdk/trace/weave_client#method-link_prompt_to_registry)로 게시된 프롬프트 버전을 레지스트리의 컬렉션에 연결합니다. 이때 대상 컬렉션 경로를 `target_path` 매개변수에 전달합니다. 경로는 `wandb-registry-` 접두사, 레지스트리 이름, 컬렉션 이름으로 구성됩니다.
   ```text theme={"system"}
   wandb-registry-{REGISTRY_NAME}/{COLLECTION_NAME}
   ```

다음 코드 스니펫을 복사하여 Python 스크립트에 붙여 넣고, `<>`로 묶인 자리 표시자 값을 실제 값으로 바꾸세요.

```python theme={"system"}
import weave

# Weave 클라이언트 초기화
weave_client = weave.init(project="<project>")

prompt = "<You are a helpful assistant...>"

# 프롬프트 객체를 Weave에 게시
weave_prompt_ref = weave.publish(
    obj=weave.StringPrompt(prompt),
    name="<prompt_name>",
)

# 프롬프트 버전을 연결할 컬렉션과 레지스트리 지정
REGISTRY_NAME = "<registry_name>"
COLLECTION_NAME = "<collection_name>"
registry_target = f"wandb-registry-{REGISTRY_NAME}/{COLLECTION_NAME}"

# 게시한 프롬프트 버전을 지정한 레지스트리의 컬렉션에 연결
weave_client.link_prompt_to_registry(
    prompt=weave_prompt_ref,
    target_path=registry_target,
)
```

<h2 id="view-linked-prompts-in-a-registry">
  레지스트리에 연결된 프롬프트 보기
</h2>

1. [https://forge.coreweave.com/registry/](https://forge.coreweave.com/registry/) 에서 레지스트리로 이동하세요.
2. 프롬프트를 연결한 레지스트리의 이름을 선택하세요.
3. 컬렉션 이름을 선택하세요.
4. 프롬프트 버전 목록에서 액세스할 버전을 선택하세요. 연결된 각 프롬프트 버전에는 `v0`부터 순차적으로 버전 번호가 부여됩니다.
5. 프롬프트 버전의 세부 정보를 보려면 해당 버전을 클릭하세요. 이 페이지의 탭에서 해당 버전의 개요, 프롬프트, 사용법을 확인할 수 있습니다.

<h2 id="use-a-prompt-linked-to-a-registry">
  레지스트리에 연결된 프롬프트 사용하기
</h2>

레지스트리에 연결된 프롬프트 객체를 가져오려면 `weave.get()` 방법을 사용하세요. 프롬프트는 별칭이나 버전 번호로 가져올 수 있습니다. 다음 코드 스니펫은 별칭과 버전 번호로 프롬프트를 가져오는 방법을 보여 줍니다.

별칭으로 프롬프트 객체를 가져오려면 다음 URI 경로를 사용하세요.

```text theme={"system"}
registry:///{ORG}/{REGISTRY_NAME}/{COLLECTION_NAME}:{VERSION-OR-ALIAS}
```

`<>`로 묶인 자리 표시자 값을 실제 값으로 바꾸세요.

<Tabs>
  <Tab title="별칭으로 가져오기">
    ```python theme={"system"}
    # 별칭으로 가져오기
    URI_path = f"registry:///{ORG}/{REGISTRY_NAME}/{COLLECTION_NAME}:{ALIAS}"

    # 별칭으로 가져오기
    prompt = weave.get(URI_path)

    # 프롬프트 사용
    print(prompt.content)
    ```
  </Tab>

  <Tab title="버전으로 가져오기">
    ```python theme={"system"}
    # 버전으로 가져오기
    URI_path = f"registry:///{ORG}/{REGISTRY_NAME}/{COLLECTION_NAME}:{VERSION}"

    # 버전으로 가져오기
    prompt = weave.get(URI_path)

    # 프롬프트 사용
    print(prompt.content)
    ```
  </Tab>
</Tabs>

W\&B는 프롬프트 객체를 가져오는 데 필요한 URI 경로와 샘플 코드를 자동으로 생성합니다. 샘플 코드를 확인하려면 다음 단계를 따르세요.

1. [https://forge.coreweave.com/registry/](https://forge.coreweave.com/registry/) 에서 레지스트리로 이동하세요.
2. 프롬프트를 연결한 레지스트리의 이름을 선택하세요.
3. 컬렉션 이름을 선택하세요.
4. 프롬프트 버전 목록에서 액세스할 버전을 선택하세요.
5. **Use** 탭을 선택하면 별칭 또는 버전 번호로 프롬프트를 가져오는 샘플 코드를 확인할 수 있습니다.


## Related topics

- [아티팩트 버전을 컬렉션에 연결하기](/ko/products/registry/link_version.md)