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

データセット内で変わらない識別子です。アップサート時はこの識別子で照合します。デフォルトはメッセージとリクエストフィールドのダイジェストです。

Required string length: 1 - 512
group_id
string

1 つの会話の各ターンなど、同じ分割に属する必要がある行をまとめます。デフォルトは row_id です。

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

train を指定するか、評価用に行をトレーニングから除外する場合は 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日