Skip to main content
POST
데이터셋 항목 추가 또는 교체

인증

Authorization
string
header
필수

wandb API 키 또는 wandb JWT. 브라우저 세션은 Model Distillation 웹 앱 백엔드에서 교환하며, 작업 권한은 내부에서만 사용됩니다.

헤더

Wandb-Entity
string

액세스 가능한 개인 또는 팀 entity. 인증된 사용자의 기본 entity를 사용하려면 생략하세요.

경로 매개변수

alias
string
필수
Pattern: ^[a-z0-9-]{1,64}$
datasetId
string<uuid>
필수

쿼리 매개변수

mode
enum<string>
기본값:append

append는 row_id가 이미 존재하는 행을 거부하고, upsert는 해당 행을 대체합니다.

사용 가능한 옵션:
append,
upsert
dry_run
boolean
기본값:false

변경 사항을 검증하고 보고한 다음 롤백하세요.

본문

Required array length: 1 - 5000 elements
messages
object[]
필수
Required array length: 2 - 1000 elements
row_id
string

데이터셋 내에서 변하지 않는 ID. 업서트 시 이 ID로 일치하는 항목을 찾습니다. 기본값은 메시지와 요청 필드의 다이제스트입니다.

Required string length: 1 - 512
group_id
string

하나의 대화에 속한 턴처럼 동일한 분할에 속해야 하는 행. 기본값은 row_id입니다.

Required string length: 1 - 512
split
enum<string>

train 또는 val. 평가용으로 행을 트레이닝에서 제외하려면 val을 사용하세요. 새 행의 기본값은 train입니다.

사용 가능한 옵션:
train,
val
tools
object[]
Maximum array length: 128
tool_choice
any
response_format
any
metadata
object

사용자나 고객 세그먼트 등 필터링에 사용할 수 있는 속성.

provenance
object

원본 시스템이나 트레이스 ID 등 행의 출처 정보.

응답

항목이 기록되었습니다. 모의 실행인 경우 실제로 실행하면 기록될 항목입니다.

dry_run
boolean
필수
created
integer
필수

새 항목으로 추가된 행입니다.

updated
integer
필수

행이 대체한 기존 항목입니다.

revision
integer
필수

쓰기 후의 데이터셋 리비전입니다. 모의 실행에서는 변경되지 않습니다.

entry_counts
object
필수
group_conflicts
string[]
필수

둘 이상의 분할에 걸쳐 있는 그룹입니다. 충돌이 있으면 실제 쓰기는 거부됩니다.

마지막 수정일 2026년 10월 8일