객체 추적 및 버전 관리

이 페이지는 W&B Weave에서 버전이 지정된 객체를 게시, 검색, 삭제 및 참조하는 방법을 설명합니다. run과 시간에 걸쳐 데이터셋, 모델 또는 프롬프트와 같은 구조화된 데이터를 추적해야 할 때 사용하세요.

객체

객체는 버전이 관리되는 직렬화 가능한 데이터입니다. Weave는 객체가 변경되면 자동으로 버전을 관리하고 변경 불가능한 이력을 생성합니다. 객체에는 다음이 포함됩니다:

데이터셋: 평가를 위한 예시 컬렉션
모델: LLM 로직을 위한 설정 및 매개변수
프롬프트: 버전이 관리되는 프롬프트 템플릿

dataset = weave.Dataset(
    name="test-cases",
    rows=[
        {"input": "What is 2+2?", "expected": "4"},
        {"input": "What is the capital of France?", "expected": "Paris"},
    ]
)
weave.publish(dataset)

객체 게시

Weave의 직렬화 계층은 객체를 저장하고 버전 관리합니다.

Python
TypeScript

import weave
weave.init("your-team-name/your-project-name")
# 목록을 저장하고 'cat-names'라는 이름을 지정합니다
weave.publish(['felix', 'jimbo', 'billie'], 'cat-names')

TypeScript 게시 지원은 제한적입니다. 모든 객체가 지원되지는 않습니다.

import * as weave from 'weave'

const client = await weave.init("your-team-name/your-project-name")

// 배열을 저장하고 'cat-names'라는 이름을 지정합니다
client.publish(['felix', 'jimbo', 'billie'], 'cat-names')

이름을 지정하여 객체를 저장하면, Weave는 해당 객체가 존재하지 않는 경우 첫 번째 버전을 생성합니다.

객체 다시 조회하기

객체를 게시한 후에는 레퍼런스를 사용하여 저장된 객체를 가져올 수 있습니다.

Python
TypeScript

weave.publish()는 Ref를 반환합니다. 모든 Ref에서 .get()을 호출하여 객체를 다시 가져올 수 있습니다.ref를 직접 생성한 다음 객체를 가져올 수도 있습니다.

weave.init("your-team-name/your-project-name")
cat_names = weave.ref('cat-names').get()

This feature isn't available in TypeScript yet.

객체 삭제

더 이상 특정 객체 버전이 필요하지 않다면 ref를 사용하여 제거할 수 있습니다.

Python
TypeScript

객체의 버전을 삭제하려면 객체의 ref에서 .delete()를 호출하세요.

weave.init("your-team-name/your-project-name")
cat_names_ref = weave.ref('cat-names:v1')
cat_names_ref.delete()

삭제된 객체에 액세스하면 오류가 반환됩니다. 삭제된 객체를 참조하는 객체를 해결하면 삭제된 객체 대신 DeletedRef가 반환됩니다.

이 기능은 아직 TypeScript에서 사용할 수 없습니다.

객체 ref 구성

Ref는 저장된 객체와 버전을 고유하게 파악하는 데 사용됩니다. 다음 섹션에서는 URI 구조와 ref를 구성하는 방법을 설명합니다. Weave에서 완전 수식된 객체 ref URI는 다음과 같습니다:

weave:///[YOUR-TEAM-NAME]/[YOUR-PROJECT-NAME]/object/[OBJECT-NAME]:[OBJECT-VERSION]

[YOUR-TEAM-NAME]: W&B entity (사용자 이름 또는 팀 이름)
[YOUR-PROJECT-NAME]: Weights & Biases 프로젝트
[OBJECT-NAME]: 객체 이름
[OBJECT-VERSION]: 버전 해시, v0 또는 v1과 같은 문자열, 또는 :latest와 같은 별칭입니다. 모든 객체에는 :latest 별칭이 있습니다. 직접 별칭을 만들려면 태그와 별칭으로 객체 버전 정리하기를 참조하세요.

다음과 같은 몇 가지 방식으로 ref를 구성할 수 있습니다:

weave.ref([NAME]): 객체의 :latest 버전을 가져옵니다. weave.init(...) 호출이 필요합니다.
weave.ref([NAME]:[VERSION]): 객체의 지정된 버전을 가져옵니다. weave.init(...) 호출이 필요합니다.
weave.ref([FULLY-QUALIFIED-REF-URI]): 지정된 완전 수식된 객체 ref URI에 있는 객체를 가져옵니다. weave.init() 호출이 필요하지 않습니다.

태그와 별칭으로 객체 버전 정리하기

태그와 별칭을 사용하면 Dataset, Model, Prompt를 비롯해 weave.publish로 게시한 모든 Weave 객체의 특정 버전에 레이블을 지정할 수 있습니다. 이러한 레이블은 모든 ObjectRef에서 작동하므로 객체 유형에 관계없이 동일한 API를 사용할 수 있습니다.

별칭: 단일 버전을 가리키는 고유한 이름입니다. 별칭은 언제든지 다른 버전으로 옮길 수 있으므로 production이나 staging처럼 고정된 이름으로 참조할 때 유용합니다. 모든 객체에는 최신 버전을 가리키는 :latest 별칭이 자동으로 부여됩니다.
태그: 버전에 연결되는 설명용 레이블입니다. 하나의 버전에 여러 태그를 지정할 수 있고, 동일한 태그를 여러 버전에 지정할 수도 있습니다. reviewed, passed-eval처럼 버전을 분류하고 필터링할 때 태그를 사용하세요.

ref에서 객체 이름 뒤에 별칭 또는 특정 버전을 붙이면 해당 버전을 가져올 수 있습니다. 다음 예시는 데이터셋의 두 버전을 게시한 다음, 각 버전에 태그와 별칭을 부여하고 업데이트합니다.

import weave

client = weave.init("[YOUR-TEAM-NAME]/[YOUR-PROJECT-NAME]")

# 객체의 두 버전을 게시합니다.
dataset_v0 = weave.publish(
    weave.Dataset(name="test-cases", rows=[{"input": "ping", "expected": "pong"}]),
)
dataset_v1 = weave.publish(
    weave.Dataset(name="test-cases", rows=[{"input": "ping", "expected": "pong!"}]),
)

# 버전에 별칭을 설정합니다.
client.set_aliases(dataset_v0, "staging")
client.set_aliases(dataset_v1, "production")

# 별칭을 사용해 객체를 조회합니다.
dataset = weave.ref("test-cases:production").get()

# 프로젝트의 모든 별칭 목록을 조회합니다.
client.list_aliases()

# --- 태그: 특정 버전에 지정하는 레이블 ---

# 버전에 태그를 추가합니다.
client.add_tags(dataset_v0, ["reviewed", "passed-eval"])
client.add_tags(dataset_v1, ["reviewed", "needs-improvement"])

# 버전의 태그를 조회합니다.
client.get_tags(dataset_v0)  # ["passed-eval", "reviewed"]

# 프로젝트의 모든 고유 태그 목록을 조회합니다.
client.list_tags()

이 기능은 아직 TypeScript SDK에서 사용할 수 없습니다.

​객체

​객체 게시

​객체 다시 조회하기

​객체 삭제

​객체 ref 구성

​태그와 별칭으로 객체 버전 정리하기

객체

객체 게시

객체 다시 조회하기

객체 삭제

객체 ref 구성

태그와 별칭으로 객체 버전 정리하기