객체 추적 및 버전 관리

​

객체

• 데이터셋: 평가를 위한 예시 컬렉션
• 모델: 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)

​

객체 게시

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

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.init("your-team-name/your-project-name")
cat_names = weave.ref('cat-names').get()

This feature isn't available in TypeScript yet.

​

객체 삭제

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

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

​

객체 ref 구성

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

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

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

​

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

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

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에서 사용할 수 없습니다.

​

이름 지정 규칙

1. 문자, 숫자, 밑줄, 마침표 이외의 문자가 연속된 부분을 각각 하이픈 하나로 바꿉니다.
2. 마침표, 밑줄, 하이픈이 두 개 이상 연속된 부분을 각각 하이픈 하나로 바꿉니다.
3. 이름의 앞뒤에 있는 하이픈과 밑줄을 제거합니다.
4. 그래도 이름이 128자를 초과하면 앞의 128자만 남기고 경고를 로깅합니다.