API 概要

`クラス` `AggregationType`

フィードバックおよび Call の統計メトリクスでサポートされる集約関数です。

`クラス` `AliasesListReq`

Pydantic のフィールド:

project_id: <class 'str'>
wb_user_id: str | None

`クラス` `AliasesListRes`

Pydantic のフィールド:

aliases: list[str]

`クラス` `AnnotationQueueAddCallsReq`

アノテーションキューに Call をバッチで追加するリクエストです。内部 API での使用のために queue_id を追加して AnnotationQueueAddCallsBody を拡張します。 Pydantic のフィールド:

project_id: <class 'str'>
call_ids: list[str]
display_fields: list[str]
queue_id: <class 'str'>
wb_user_id: str | None

`クラス` `AnnotationQueueAddCallsRes`

キューに Call を追加した際の応答です。 Pydantic のフィールド:

added_count: <class 'int'>
duplicates: <class 'int'>

`クラス` `AnnotationQueueCreateReq`

新しいアノテーションキューを作成するためのリクエストです。 Pydantic のフィールド:

project_id: <class 'str'>
name: <class 'str'>
description: <class 'str'>
scorer_refs: list[str]
wb_user_id: str | None

`クラス` `AnnotationQueueCreateRes`

アノテーションキューの作成時に返される応答です。 Pydantic のフィールド:

id: <class 'str'>

`クラス` `AnnotationQueueDeleteReq`

アノテーションキューを削除 (論理削除) するためのリクエストです。 Pydantic のフィールド:

project_id: <class 'str'>
queue_id: <class 'str'>
wb_user_id: str | None

`クラス` `AnnotationQueueDeleteRes`

アノテーションキューの削除に対する応答です。 Pydantic のフィールド:

queue: <class 'AnnotationQueueSchema'>

`クラス` `AnnotationQueueItemSchema`

アノテーションキュー項目の応答用スキーマです。 Pydantic のフィールド:

id: <class 'str'>
project_id: <class 'str'>
queue_id: <class 'str'>
call_id: <class 'str'>
call_started_at: <class 'datetime.datetime'>
call_ended_at: datetime.datetime | None
call_op_name: <class 'str'>
call_trace_id: <class 'str'>
display_fields: list[str]
added_by: str | None
annotation_state: typing.Literal['unstarted', 'in_progress', 'completed', 'skipped']
annotator_user_id: str | None
created_at: <class 'datetime.datetime'>
created_by: <class 'str'>
updated_at: <class 'datetime.datetime'>
deleted_at: datetime.datetime | None
position_in_queue: int | None

`クラス` `AnnotationQueueItemsQueryReq`

アノテーションキュー内の項目をクエリするリクエストです。内部 API で使用する queue_id を追加して AnnotationQueueItemsQueryBody を拡張します。 Pydantic のフィールド:

project_id: <class 'str'>
filter: weave.trace_server.common_interface.AnnotationQueueItemsFilter | None
sort_by: list[weave.trace_server.common_interface.SortBy] | None
limit: int | None
offset: int | None
include_position: <class 'bool'>
queue_id: <class 'str'>

`クラス` `AnnotationQueueItemsQueryRes`

アノテーションキューのアイテムをクエリした際の応答です。 Pydantic のフィールド:

items: list[AnnotationQueueItemSchema]

`クラス` `AnnotationQueueReadReq`

特定のアノテーションキューを取得するためのリクエストです。 Pydantic のフィールド:

project_id: <class 'str'>
queue_id: <class 'str'>

`クラス` `AnnotationQueueReadRes`

アノテーションキューの読み取りに対する応答です。 Pydantic のフィールド:

queue: <class 'AnnotationQueueSchema'>

`クラス` `AnnotationQueueSchema`

アノテーションキューの応答のスキーマです。 Pydantic のフィールド:

id: <class 'str'>
project_id: <class 'str'>
name: <class 'str'>
description: <class 'str'>
scorer_refs: list[str]
created_at: <class 'datetime.datetime'>
created_by: <class 'str'>
updated_at: <class 'datetime.datetime'>
deleted_at: datetime.datetime | None

`クラス` `AnnotationQueueStatsSchema`

単一のアノテーションキューの統計です。 Pydantic のフィールド:

queue_id: <class 'str'>
total_items: <class 'int'>
completed_items: <class 'int'>

`クラス` `AnnotationQueueUpdateReq`

アノテーションキューを更新するためのリクエストです。 project_id と queue_id を除くすべてのフィールドはオプションです。指定したフィールドのみが更新されます。 Pydantic のフィールド:

project_id: <class 'str'>
queue_id: <class 'str'>
name: str | None
description: str | None
scorer_refs: list[str] | None
wb_user_id: str | None

`クラス` `AnnotationQueueUpdateRes`

アノテーションキューの更新時に返される応答です。 Pydantic のフィールド:

queue: <class 'AnnotationQueueSchema'>

`クラス` `AnnotationQueuesQueryReq`

project のアノテーションキューをクエリするリクエストです。 Pydantic のフィールド:

project_id: <class 'str'>
name: str | None
sort_by: list[weave.trace_server.common_interface.SortBy] | None
limit: int | None
offset: int | None

`クラス` `AnnotationQueuesQueryRes`

アノテーションキューをクエリした際の応答です。 Pydantic のフィールド:

queues: list[AnnotationQueueSchema]

`クラス` `AnnotationQueuesStatsReq`

複数のアノテーションキューの統計を取得するためのリクエストです。 Pydantic のフィールド:

project_id: <class 'str'>
queue_ids: list[str]

`クラス` `AnnotationQueuesStatsRes`

複数のアノテーションキューの統計を含む応答です。 Pydantic のフィールド:

stats: list[AnnotationQueueStatsSchema]

`クラス` `AnnotatorQueueItemsProgressUpdateReq`

現在のアノテーターについて、キューアイテムのアノテーション状態を更新するリクエストです。有効な状態遷移:

(なし) -> ‘in_progress’: アイテムを進行中としてマークします (レコードが存在しない場合のみ)
(なし) -> ‘completed’ または ‘skipped’: アイテムを直接完了またはスキップします
‘in_progress’ または ‘unstarted’ -> ‘completed’ または ‘skipped’: 開始済みのアイテムを完了またはスキップします
same_state -> same_state: 冪等な no-op (既存のアイテムを変更せずにそのまま返します)

Pydantic のフィールド:

project_id: <class 'str'>
queue_id: <class 'str'>
item_id: <class 'str'>
annotation_state: <class 'str'>
wb_user_id: str | None

`クラス` `AnnotatorQueueItemsProgressUpdateRes`

アノテーションの状態を更新した際の応答。 Pydantic のフィールド:

item: <class 'AnnotationQueueItemSchema'>

`クラス` `CallBatchEndMode`

Pydantic のフィールド:

mode: <class 'str'>
req: <class 'CallEndReq'>

`クラス` `CallBatchStartMode`

Pydantic のフィールド:

mode: <class 'str'>
req: <class 'CallStartReq'>

`クラス` `CallCreateBatchReq`

Pydantic のフィールド:

batch: list[CallBatchStartMode | CallBatchEndMode]

`クラス` `CallCreateBatchRes`

Pydantic のフィールド:

res: list[CallStartRes | CallEndRes]

`クラス` `CallEndReq`

Pydantic のフィールド:

end: <class 'EndedCallSchemaForInsert'>

`クラス` `CallEndRes`

`クラス` `CallEndV2Req`

v2 API 経由で単一の Call を終了するためのリクエスト。 Pydantic のフィールド:

end: <class 'EndedCallSchemaForInsertWithStartedAt'>

`クラス` `CallEndV2Res`

v2 API 経由で単一の Call を終了する際の応答です。

`クラス` `CallMetricSpec`

集約する Call レベルのメトリクスの仕様です (モデル別にはグループ化しません) 。 Pydantic のフィールド:

metric: typing.Literal['latency_ms', 'call_count', 'error_count']
aggregations: list[AggregationType]
percentiles: list[float]

`クラス` `CallReadReq`

Pydantic のフィールド:

project_id: <class 'str'>
id: <class 'str'>
include_costs: bool | None
include_storage_size: bool | None
include_total_storage_size: bool | None

`クラス` `CallReadRes`

Pydantic のフィールド:

call: CallSchema | None

`クラス` `CallSchema`

Pydantic のフィールド:

id: <class 'str'>
project_id: <class 'str'>
op_name: <class 'str'>
display_name: str | None
trace_id: <class 'str'>
parent_id: str | None
thread_id: str | None
turn_id: str | None
started_at: <class 'datetime.datetime'>
attributes: dict[str, typing.Any]
inputs: dict[str, typing.Any]
ended_at: datetime.datetime | None
exception: str | None
output: typing.Any | None
summary: SummaryMap | None
wb_user_id: str | None
wb_username: str | None
wb_run_id: str | None
wb_run_step: int | None
wb_run_step_end: int | None
deleted_at: datetime.datetime | None
expire_at: datetime.datetime | None
storage_size_bytes: int | None
total_storage_size_bytes: int | None

`メソッド` `serialize_typed_dicts`

serialize_typed_dicts(v: dict[str, Any]) → dict[str, Any]

`クラス` `CallStartReq`

Pydantic のフィールド:

start: <class 'StartedCallSchemaForInsert'>

`クラス` `CallStartRes`

Pydantic のフィールド:

id: <class 'str'>
trace_id: <class 'str'>

`クラス` `CallStartV2Req`

v2 API 経由で単一の Call を開始するためのリクエストです。 Pydantic のフィールド:

start: <class 'StartedCallSchemaForInsert'>

`クラス` `CallStartV2Res`

v2 API 経由で単一の Call を開始する際の応答です。 Pydantic のフィールド:

id: <class 'str'>
trace_id: <class 'str'>

`クラス` `CallStatsReq`

指定した期間の Call の集計統計を取得するリクエストです。 Pydantic のフィールド:

project_id: <class 'str'>
start: <class 'datetime.datetime'>
end: datetime.datetime | None
granularity: int | None
usage_metrics: list[UsageMetricSpec] | None
call_metrics: list[CallMetricSpec] | None
filter: CallsFilter | None
timezone: <class 'str'>

`メソッド` `validate_date_range`

validate_date_range() → CallStatsReq

Call統計のリクエストが安全な日付範囲内に収まるようにします。

`クラス` `CallStatsRes`

Call の時系列統計を含む応答です。 Pydantic のフィールド:

start: <class 'datetime.datetime'>
end: <class 'datetime.datetime'>
granularity: <class 'int'>
timezone: <class 'str'>
usage_buckets: list[dict[str, typing.Any]]
call_buckets: list[dict[str, typing.Any]]

`クラス` `CallUpdateReq`

Pydantic のフィールド:

project_id: <class 'str'>
call_id: <class 'str'>
display_name: str | None
wb_user_id: str | None

`クラス` `CallUpdateRes`

`クラス` `CallsDeleteReq`

Pydantic のフィールド:

project_id: <class 'str'>
call_ids: list[str]
wb_user_id: str | None

`クラス` `CallsDeleteRes`

Pydantic のフィールド:

num_deleted: <class 'int'>

`クラス` `CallsFilter`

Pydantic のフィールド:

op_names: list[str] | None
input_refs: list[str] | None
output_refs: list[str] | None
parent_ids: list[str] | None
trace_ids: list[str] | None
call_ids: list[str] | None
thread_ids: list[str] | None
turn_ids: list[str] | None
trace_roots_only: bool | None
wb_user_ids: list[str] | None
wb_run_ids: list[str] | None

`クラス` `CallsQueryReq`

Pydantic のフィールド:

project_id: <class 'str'>
filter: CallsFilter | None
limit: int | None
offset: int | None
sort_by: list[weave.trace_server.common_interface.SortBy] | None
query: weave.trace_server.interface.query.Query | None
include_costs: bool | None
include_feedback: bool | None
include_storage_size: bool | None
include_total_storage_size: bool | None
include_usernames: bool | None
columns: list[str] | None
expand_columns: list[str] | None
return_expanded_column_values: bool | None

`クラス` `CallsQueryRes`

Pydantic のフィールド:

calls: list[CallSchema]

`クラス` `CallsQueryStatsReq`

Pydantic のフィールド:

project_id: <class 'str'>
filter: CallsFilter | None
query: weave.trace_server.interface.query.Query | None
limit: int | None
include_total_storage_size: bool | None
expand_columns: list[str] | None

`クラス` `CallsQueryStatsRes`

Pydantic のフィールド:

count: <class 'int'>
has_more: <class 'bool'>
total_storage_size_bytes: int | None

`クラス` `CallsScoreReq`

Call のリストに対するスコアリングジョブをキューに追加するリクエストです。スコアリングは call_scoring_worker によって非同期で実行されます。このワーカーは Kafka からメッセージを取得し、各 scorer_ref を各 call_id に適用します。 Pydantic のフィールド:

project_id: <class 'str'>
call_ids: list[str]
scorer_refs: list[str]
wb_user_id: str | None

`クラス` `CallsScoreRes`

calls_score の空の応答です。このインターフェース全体で使用されている規約に従い、破壊的変更なしで後からフィールドを追加できるように、None を返すのではなくモデルとして定義されています。

`クラス` `CallsUpsertCompleteReq`

完了済みの Call のバッチをアップサートするためのリクエスト。 Pydantic のフィールド:

batch: list[CompletedCallSchemaForInsert]

`クラス` `CallsUpsertCompleteRes`

完了済みの Call のバッチをアップサートする際の応答です。

`クラス` `CallsUsageReq`

複数のルート Call の使用量を集計するリクエストです。このエンドポイントは、リクエストされた各ルート Call の使用状況メトリクスを返します。各ルートのメトリクスには、自身の使用量とすべての子孫の使用量の合計が含まれます。注: 集約のため、一致するすべての Call がメモリに読み込まれます。結果セットが非常に大きい場合 (Call が 1 万件を超える場合) は、ルート Call ID をバッチに分割するか、アプリケーション層でフィルターの条件を絞ることを検討してください。 Pydantic のフィールド:

project_id: <class 'str'>
call_ids: list[str]
include_costs: <class 'bool'>
limit: <class 'int'>

`クラス` `CallsUsageRes`

ルート Call ごとに集計した使用状況メトリクスを含む応答です。 Pydantic のフィールド:

call_usage: dict[str, dict[str, LLMAggregatedUsage]]
unfinished_call_ids: list[str]

`クラス` `CompletedCallSchemaForInsert`

完了した Call を直接挿入するためのスキーマです。挿入時点ですでに完了している Call を表し、開始情報と終了情報をまとめて提供します。calls_complete エンドポイントで使用されます。 Pydantic のフィールド:

project_id: <class 'str'>
id: <class 'str'>
trace_id: <class 'str'>
op_name: <class 'str'>
started_at: <class 'datetime.datetime'>
ended_at: <class 'datetime.datetime'>
display_name: str | None
parent_id: str | None
thread_id: str | None
turn_id: str | None
attributes: dict[str, typing.Any]
inputs: dict[str, typing.Any]
output: typing.Any | None
summary: <class 'SummaryInsertMap'>
otel_dump: dict[str, typing.Any] | None
exception: str | None
wb_user_id: str | None
wb_run_id: str | None
wb_run_step: int | None
wb_run_step_end: int | None

`メソッド` `serialize_typed_dicts`

serialize_typed_dicts(v: dict[str, Any]) → dict[str, Any]

`クラス` `CompletionsCreateReq`

Pydantic のフィールド:

project_id: <class 'str'>
inputs: <class 'CompletionsCreateRequestInputs'>
wb_user_id: str | None
track_llm_call: bool | None
trace_id: str | None
parent_id: str | None
conversation_id: str | None
conversation_name: str | None
source: str | None

`クラス` `CompletionsCreateRequestInputs`

Pydantic のフィールド:

model: <class 'str'>
messages: <class 'list'>
timeout: float | str | None
temperature: float | None
top_p: float | None
n: int | None
stop: str | list | None
max_completion_tokens: int | None
max_tokens: int | None
modalities: list | None
presence_penalty: float | None
frequency_penalty: float | None
stream: bool | None
logit_bias: dict | None
user: str | None
response_format: dict | type[pydantic.main.BaseModel] | None
seed: int | None
tools: list | None
tool_choice: str | dict | None
logprobs: bool | None
top_logprobs: int | None
parallel_tool_calls: bool | None
extra_headers: dict | None
functions: list | None
function_call: str | None
api_version: str | None
prompt: str | None
template_vars: dict[str, typing.Any] | None
vertex_credentials: str | None

`クラス` `CompletionsCreateRes`

Pydantic のフィールド:

response: dict[str, typing.Any]
weave_call_id: str | None
span_id: str | None
trace_id: str | None
conversation_id: str | None

`クラス` `CostCreateInput`

Pydantic のフィールド:

prompt_token_cost: <class 'float'>
completion_token_cost: <class 'float'>
cache_read_input_token_cost: <class 'float'>
cache_creation_input_token_cost: <class 'float'>
prompt_token_cost_unit: str | None
completion_token_cost_unit: str | None
effective_date: datetime.datetime | None
provider_id: str | None

`クラス` `CostCreateReq`

Pydantic のフィールド:

project_id: <class 'str'>
costs: dict[str, CostCreateInput]
wb_user_id: str | None

`クラス` `CostCreateRes`

Pydantic のフィールド:

ids: list[tuple[str, str]]

`クラス` `CostPurgeReq`

Pydantic のフィールド:

project_id: <class 'str'>
query: <class 'weave.trace_server.interface.query.Query'>

`クラス` `CostPurgeRes`

`クラス` `CostQueryOutput`

Pydantic のフィールド:

id: str | None
llm_id: str | None
prompt_token_cost: float | None
completion_token_cost: float | None
prompt_token_cost_unit: str | None
completion_token_cost_unit: str | None
effective_date: datetime.datetime | None
provider_id: str | None

`クラス` `CostQueryReq`

Pydantic のフィールド:

project_id: <class 'str'>
fields: list[str] | None
query: weave.trace_server.interface.query.Query | None
sort_by: list[weave.trace_server.common_interface.SortBy] | None
limit: int | None
offset: int | None

`クラス` `CostQueryRes`

Pydantic のフィールド:

results: list[CostQueryOutput]

`クラス` `DatasetCreateBody`

Pydantic のフィールド:

name: str | None
description: str | None
rows: list[dict[str, typing.Any]]

`クラス` `DatasetCreateReq`

Pydantic のフィールド:

name: str | None
description: str | None
rows: list[dict[str, typing.Any]]
project_id: <class 'str'>
wb_user_id: str | None

`クラス` `DatasetCreateRes`

Pydantic のフィールド:

digest: <class 'str'>
object_id: <class 'str'>
version_index: <class 'int'>

`クラス` `DatasetDeleteReq`

Pydantic のフィールド:

project_id: <class 'str'>
object_id: <class 'str'>
digests: list[str] | None
wb_user_id: str | None

`クラス` `DatasetDeleteRes`

Pydantic のフィールド:

num_deleted: <class 'int'>

`クラス` `DatasetListReq`

Pydantic のフィールド:

project_id: <class 'str'>
limit: int | None
offset: int | None
wb_user_id: str | None

`クラス` `DatasetReadReq`

Pydantic のフィールド:

project_id: <class 'str'>
object_id: <class 'str'>
digest: <class 'str'>
wb_user_id: str | None

`クラス` `DatasetReadRes`

Pydantic のフィールド:

object_id: <class 'str'>
digest: <class 'str'>
version_index: <class 'int'>
created_at: <class 'datetime.datetime'>
name: <class 'str'>
description: str | None
rows: <class 'str'>

`クラス` `DatasetSourceLinkPayload`

単一のデータセット行と、それにリンクするソース。 Pydantic のフィールド:

row_digest: <class 'str'>
sources: list[SourceRef]
link_metadata: dict[str, typing.Any] | None

`クラス` `DatasetSourceLinkSchema`

単一のデータセットソースリンク行のスキーマ。 Pydantic のフィールド:

id: <class 'str'>
row_digest: <class 'str'>
source_kind: <enum 'SourceKind'>
source_id: <class 'str'>
source_trace_id: <class 'str'>
source_started_at: <class 'datetime.datetime'>
source_display_name: <class 'str'>
link_metadata: dict[str, typing.Any] | None
added_by: str | None
created_at: <class 'datetime.datetime'>
updated_at: <class 'datetime.datetime'>
deleted_at: datetime.datetime | None

`クラス` `DatasetSourcesLinkDeleteReq`

ID を指定してデータセットのソースリンクを論理削除するリクエストです。 Pydantic のフィールド:

project_id: <class 'str'>
link_ids: list[str]
wb_user_id: str | None

`クラス` `DatasetSourcesLinkDeleteRes`

データセットのソースリンクを削除した際の応答です。 Pydantic のフィールド:

entries: list[DatasetSourcesLinkDeleteResEntry]

`クラス` `DatasetSourcesLinkDeleteResEntry`

1 件のリンク削除の結果です。 Pydantic のフィールド:

link_id: <class 'str'>
deleted: <class 'bool'>

`クラス` `DatasetSourcesLinkReq`

データセットの行を、その来歴を示すソースにリンクするためのリクエストです。 Pydantic のフィールド:

project_id: <class 'str'>
dataset_object_id: <class 'str'>
dataset_digest: <class 'str'>
links: list[DatasetSourceLinkPayload]
include_created_status: <class 'bool'>
wb_user_id: str | None

`クラス` `DatasetSourcesLinkRes`

データセットの行をソースにリンクした際の応答です。フラット化された (row_digest, source) タプルごとに 1 つのエントリが、入力順に格納されます。 Pydantic のフィールド:

entries: list[DatasetSourcesLinkResEntry]

`クラス` `DatasetSourcesLinkResEntry`

フラット化された単一の (row_digest, source) リンクの結果です。 Pydantic のフィールド:

link_id: <class 'str'>
created: bool | None

`クラス` `DatasetSourcesQueryReq`

順方向クエリ: データセット -> ソース。 Pydantic のフィールド:

project_id: <class 'str'>
dataset_object_id: <class 'str'>
row_digests: list[str] | None
source_kinds: list[SourceKind] | None
include_deleted: <class 'bool'>
limit: int | None
offset: int | None
wb_user_id: str | None

`クラス` `DatasetSourcesQueryRes`

データセット -> ソースの順方向クエリの応答です。 Pydantic のフィールド:

links: list[DatasetSourceLinkSchema]

`クラス` `EndedCallSchemaForInsert`

Pydantic のフィールド:

project_id: <class 'str'>
id: <class 'str'>
trace_id: str | None
is_eval: bool | None
ended_at: <class 'datetime.datetime'>
started_at: datetime.datetime | None
exception: str | None
output: typing.Any | None
summary: <class 'SummaryInsertMap'>
wb_run_step_end: int | None

`method` `serialize_typed_dicts`

serialize_typed_dicts(v: dict[str, Any]) → dict[str, Any]

`クラス` `EndedCallSchemaForInsertWithStartedAt`

非推奨のエイリアスです。started_at は現在、親クラスの EndedCallSchemaForInsert に含まれているため、そちらを使用してください。WithStartedAt という名前に固定している外部 SDK が引き続きインポートできるように残されています。ツリー内のすべての呼び出し元の移行が完了した時点で削除されます。 Pydantic のフィールド:

project_id: <class 'str'>
id: <class 'str'>
trace_id: str | None
is_eval: bool | None
ended_at: <class 'datetime.datetime'>
started_at: datetime.datetime | None
exception: str | None
output: typing.Any | None
summary: <class 'SummaryInsertMap'>
wb_run_step_end: int | None

`method` `serialize_typed_dicts`

serialize_typed_dicts(v: dict[str, Any]) → dict[str, Any]

`クラス` `EvalResultsEvaluationSummary`

Pydantic のフィールド:

evaluation_call_id: <class 'str'>
trial_count: <class 'int'>
scorer_stats: list[EvalResultsScorerStats]
predict_total_tokens: int | None
predict_total_cost: float | None
evaluation_ref: str | None
model_ref: str | None
display_name: str | None
trace_id: str | None
started_at: str | None

`クラス` `EvalResultsFilter`

特定の評価 (任意) に範囲を限定したフィルターです。 Pydantic のフィールド:

evaluation_call_id: str | None
query: <class 'weave.trace_server.interface.query.Query'>

`クラス` `EvalResultsQueryBody`

Pydantic のフィールド:

evaluation_call_ids: list[str] | None
evaluation_run_ids: list[str] | None
require_intersection: <class 'bool'>
include_raw_data_rows: <class 'bool'>
resolve_row_refs: <class 'bool'>
include_rows: <class 'bool'>
include_summary: <class 'bool'>
summary_require_intersection: bool | None
include_predict_and_score_children: <class 'bool'>
include_costs: <class 'bool'>
sort_by: list[EvalResultsSortBy] | None
filters: list[EvalResultsFilter] | None
filter_logic_operator: typing.Literal['and', 'or']
limit: int | None
offset: <class 'int'>

`method` `validate_identifiers`

validate_identifiers() → EvalResultsQueryBody

少なくとも 1 つの評価識別子が指定されていることを検証します。

`クラス` `EvalResultsQueryReq`

Pydantic のフィールド:

evaluation_call_ids: list[str] | None
evaluation_run_ids: list[str] | None
require_intersection: <class 'bool'>
include_raw_data_rows: <class 'bool'>
resolve_row_refs: <class 'bool'>
include_rows: <class 'bool'>
include_summary: <class 'bool'>
summary_require_intersection: bool | None
include_predict_and_score_children: <class 'bool'>
include_costs: <class 'bool'>
sort_by: list[EvalResultsSortBy] | None
filters: list[EvalResultsFilter] | None
filter_logic_operator: typing.Literal['and', 'or']
limit: int | None
offset: <class 'int'>
project_id: <class 'str'>

`method` `validate_identifiers`

validate_identifiers() → EvalResultsQueryBody

評価識別子が少なくとも 1 つ指定されていることを検証します。

`クラス` `EvalResultsQueryRes`

Pydantic のフィールド:

rows: list[EvalResultsRow]
total_rows: <class 'int'>
summary: ForwardRef('EvalResultsSummaryRes | None')
warnings: list[str]

`クラス` `EvalResultsRow`

Pydantic のフィールド:

row_digest: <class 'str'>
raw_data_row: typing.Any | None
evaluations: list[EvalResultsRowEvaluation]

`クラス` `EvalResultsRowEvaluation`

Pydantic のフィールド:

evaluation_call_id: <class 'str'>
trials: list[EvalResultsTrial]

`クラス` `EvalResultsScorerStats`

フラット化された単一のスコア次元 (scorer_key または scorer_key.path.to.leaf) の統計です。 Pydantic のフィールド:

scorer_key: <class 'str'>
path: str | None
value_type: typing.Optional[typing.Literal['binary', 'continuous', 'text']]
trial_count: <class 'int'>
numeric_count: <class 'int'>
numeric_mean: float | None
pass_true_count: <class 'int'>
pass_known_count: <class 'int'>
pass_rate: float | None
pass_signal_coverage: float | None

`クラス` `EvalResultsSortBy`

評価結果のソート仕様です。SortBy を拡張したものです。 Pydantic のフィールド:

field: <class 'str'>
direction: typing.Literal['asc', 'desc']
evaluation_call_id: str | None
mode: typing.Literal['value', 'difference']

`クラス` `EvalResultsSummaryRes`

Pydantic のフィールド:

row_count: <class 'int'>
evaluations: list[EvalResultsEvaluationSummary]

`クラス` `EvalResultsTrial`

Pydantic のフィールド:

predict_and_score_call_id: <class 'str'>
predict_call_id: str | None
model_output: typing.Any | None
scores: dict[str, typing.Any]
model_latency_seconds: float | None
total_tokens: int | None
total_cost: float | None
scorer_call_ids: dict[str, str]
genai_span_ref: list[GenAISpanRef] | None

`クラス` `EvaluateModelArgs`

完全な evaluate-model ジョブ (モデルの読み込み、予測の実行、スコアリングを行う) の引数です。 EvalWorkerJob の判別共用体で両方のジョブタイプ (EvaluateModelArgs と RescoringArgs) を同じモジュール内に配置できるよう、workers/evaluate_model_worker/evaluate_model_worker.py から移動されました。 Pydantic のフィールド:

job_type: typing.Literal['evaluate_model']
project_id: <class 'str'>
evaluation_ref: <class 'str'>
model_ref: <class 'str'>
wb_user_id: <class 'str'>
evaluation_call_id: <class 'str'>

`クラス` `EvaluateModelReq`

Pydantic のフィールド:

project_id: <class 'str'>
evaluation_ref: <class 'str'>
model_ref: <class 'str'>
wb_user_id: str | None

`クラス` `EvaluateModelRes`

Pydantic のフィールド:

call_id: <class 'str'>

`クラス` `EvaluationCreateBody`

Pydantic のフィールド:

name: <class 'str'>
description: str | None
dataset: <class 'str'>
scorers: list[str] | None
trials: <class 'int'>
evaluation_name: str | None
eval_attributes: dict[str, typing.Any] | None

`クラス` `EvaluationCreateReq`

Pydantic のフィールド:

name: <class 'str'>
description: str | None
dataset: <class 'str'>
scorers: list[str] | None
trials: <class 'int'>
evaluation_name: str | None
eval_attributes: dict[str, typing.Any] | None
project_id: <class 'str'>
wb_user_id: str | None

`クラス` `EvaluationCreateRes`

Pydantic のフィールド:

digest: <class 'str'>
object_id: <class 'str'>
version_index: <class 'int'>
evaluation_ref: <class 'str'>

`クラス` `EvaluationDeleteReq`

Pydantic のフィールド:

project_id: <class 'str'>
object_id: <class 'str'>
digests: list[str] | None
wb_user_id: str | None

`クラス` `EvaluationDeleteRes`

Pydantic のフィールド:

num_deleted: <class 'int'>

`クラス` `EvaluationListReq`

Pydantic のフィールド:

project_id: <class 'str'>
limit: int | None
offset: int | None
wb_user_id: str | None

`クラス` `EvaluationReadReq`

Pydantic のフィールド:

project_id: <class 'str'>
object_id: <class 'str'>
digest: <class 'str'>
wb_user_id: str | None

`クラス` `EvaluationReadRes`

Pydantic のフィールド:

object_id: <class 'str'>
digest: <class 'str'>
version_index: <class 'int'>
created_at: <class 'datetime.datetime'>
name: <class 'str'>
description: str | None
dataset: <class 'str'>
scorers: list[str]
trials: <class 'int'>
evaluation_name: str | None
evaluate_op: str | None
predict_and_score_op: str | None
summarize_op: str | None

`クラス` `EvaluationRunCreateBody`

Pydantic のフィールド:

evaluation: <class 'str'>
model: <class 'str'>
source_evaluation_run_id: str | None

`クラス` `EvaluationRunCreateReq`

Pydantic のフィールド:

evaluation: <class 'str'>
model: <class 'str'>
source_evaluation_run_id: str | None
project_id: <class 'str'>
wb_user_id: str | None

`クラス` `EvaluationRunCreateRes`

Pydantic のフィールド:

evaluation_run_id: <class 'str'>

`クラス` `EvaluationRunDeleteReq`

Pydantic のフィールド:

project_id: <class 'str'>
evaluation_run_ids: list[str]
wb_user_id: str | None

`クラス` `EvaluationRunDeleteRes`

Pydantic のフィールド:

num_deleted: <class 'int'>

`クラス` `EvaluationRunFilter`

Pydantic のフィールド:

evaluations: list[str] | None
models: list[str] | None
evaluation_run_ids: list[str] | None

`クラス` `EvaluationRunFinishBody`

REST API を介して evaluation run を終了するためのリクエストボディです。 RESTful エンドポイントでは project_id と evaluation_run_id が URL パスから取得されるため、このモデルにはこれらが含まれていません。 Pydantic のフィールド:

summary: dict[str, typing.Any] | None

`クラス` `EvaluationRunFinishReq`

Pydantic のフィールド:

summary: dict[str, typing.Any] | None
project_id: <class 'str'>
evaluation_run_id: <class 'str'>
wb_user_id: str | None

`クラス` `EvaluationRunFinishRes`

Pydantic のフィールド:

success: <class 'bool'>

`クラス` `EvaluationRunListReq`

Pydantic のフィールド:

project_id: <class 'str'>
filter: EvaluationRunFilter | None
limit: int | None
offset: int | None

`クラス` `EvaluationRunReadReq`

Pydantic のフィールド:

project_id: <class 'str'>
evaluation_run_id: <class 'str'>

`クラス` `EvaluationRunReadRes`

Pydantic のフィールド:

evaluation_run_id: <class 'str'>
evaluation: <class 'str'>
model: <class 'str'>
status: str | None
started_at: datetime.datetime | None
finished_at: datetime.datetime | None
summary: dict[str, typing.Any] | None
source_evaluation_run_id: str | None

`クラス` `EvaluationStatusComplete`

Pydantic のフィールド:

code: typing.Literal['complete']
output: dict[str, typing.Any]

`クラス` `EvaluationStatusFailed`

Pydantic のフィールド:

code: typing.Literal['failed']
error: str | None

`クラス` `EvaluationStatusNotFound`

Pydantic のフィールド:

code: typing.Literal['not_found']

`クラス` `EvaluationStatusReq`

Pydantic のフィールド:

project_id: <class 'str'>
call_id: <class 'str'>

`クラス` `EvaluationStatusRes`

Pydantic のフィールド:

status: EvaluationStatusNotFound | EvaluationStatusRunning | EvaluationStatusFailed | EvaluationStatusComplete

`クラス` `EvaluationStatusRunning`

Pydantic のフィールド:

code: typing.Literal['running']
completed_rows: <class 'int'>
total_rows: <class 'int'>

`クラス` `ExportTracePartialSuccess`

Pydantic のフィールド:

rejected_spans: <class 'int'>
error_message: <class 'str'>

`クラス` `ExtraKeysTypedDict`

`クラス` `Feedback`

Pydantic のフィールド:

id: <class 'str'>
project_id: <class 'str'>
weave_ref: <class 'str'>
creator: str | None
feedback_type: <class 'str'>
payload: dict[str, typing.Any]
annotation_ref: str | None
runnable_ref: str | None
call_ref: str | None
trigger_ref: str | None
queue_id: str | None
scorer_tags: list[str]
scorer_tag_reasons: dict[str, str]
scorer_tag_confidences: dict[str, float]
scorer_ratings: dict[str, float]
scorer_rating_reasons: dict[str, str]
scorer_rating_confidences: dict[str, float]
span_agent_name: <class 'str'>
span_agent_version: <class 'str'>
span_status_code: <class 'str'>
wb_user_id: str | None
created_at: <class 'datetime.datetime'>

`クラス` `FeedbackAggregateBucket`

集計した Scorer のフィードバックの 1 行 (時間バケット、group) を表します。 Pydantic のフィールド:

time_bucket_start_ms: int | None
group: dict[str, str]
total_count: <class 'int'>
scored_count: <class 'int'>
tag_counts: dict[str, int]
rating_counts: dict[str, int]
rating_sums: dict[str, float]

`クラス` `FeedbackAggregateReq`

時間バケットとディメンションごとに集計したスコアをクエリします。 Pydantic のフィールド:

project_id: <class 'str'>
after_ms: <class 'int'>
before_ms: <class 'int'>
time_bucket_seconds: int | None
feedback_types: list[str]
tags: list[str]
rating_min: float | None
rating_max: float | None
monitor_ids: list[str]
scorer_ids: list[str]
span_agent_names: list[str]
span_types: list[typing.Literal['agent_turn', 'agent_conversation']]
group_by: list[typing.Literal['scorer_id', 'span_agent_name', 'span_agent_version', 'span_status_code']]

`クラス` `FeedbackAggregateRes`

集計した Scorer のフィードバックのスパースな時系列データです (空のバケットは省略されます)。 Pydantic のフィールド:

time_bucket_seconds: int | None
after_ms: <class 'int'>
before_ms: <class 'int'>
buckets: list[FeedbackAggregateBucket]

`クラス` `FeedbackCreateBatchReq`

Pydantic のフィールド:

batch: list[FeedbackCreateReq]

`クラス` `FeedbackCreateBatchRes`

Pydantic のフィールド:

res: list[FeedbackCreateRes]

`クラス` `FeedbackCreateReq`

Pydantic のフィールド:

id: str | None
project_id: <class 'str'>
weave_ref: <class 'str'>
creator: str | None
feedback_type: <class 'str'>
payload: dict[str, typing.Any]
annotation_ref: str | None
runnable_ref: str | None
call_ref: str | None
trigger_ref: str | None
queue_id: str | None
scorer_tags: list[str]
scorer_tag_reasons: dict[str, str]
scorer_tag_confidences: dict[str, float]
scorer_ratings: dict[str, float]
scorer_rating_reasons: dict[str, str]
scorer_rating_confidences: dict[str, float]
span_agent_name: <class 'str'>
span_agent_version: <class 'str'>
span_status_code: <class 'str'>
wb_user_id: str | None

`クラス` `FeedbackCreateRes`

Pydantic のフィールド:

id: <class 'str'>
created_at: <class 'datetime.datetime'>
wb_user_id: <class 'str'>
payload: dict[str, typing.Any]

`クラス` `FeedbackDict`

`クラス` `FeedbackMetricSpec`

集約対象となるフィードバックのペイロードメトリクスの仕様です。 Pydantic のフィールド:

json_path: <class 'str'>
value_type: typing.Literal['numeric', 'boolean', 'categorical']
aggregations: list[AggregationType]
percentiles: list[float]

`クラス` `FeedbackPayloadPath`

フィードバックのペイロード内で検出されたパスと、その推論されたタイプです。 Pydantic のフィールド:

json_path: <class 'str'>
value_type: typing.Literal['numeric', 'boolean', 'categorical']

`クラス` `FeedbackPayloadSchemaReq`

フィードバックのペイロードスキーマをディスカバリーするためのリクエストです。 Pydantic のフィールド:

project_id: <class 'str'>
start: <class 'datetime.datetime'>
end: datetime.datetime | None
feedback_type: str | None
trigger_ref: str | None
sample_limit: <class 'int'>

`メソッド` `validate_date_range`

validate_date_range() → _FeedbackFilterBase

フィードバックのリクエストが安全な日付範囲内に収まるようにします。

`クラス` `FeedbackPayloadSchemaRes`

検出されたフィードバックのペイロードパスとタイプを含む応答です。 Pydantic のフィールド:

paths: list[FeedbackPayloadPath]

`クラス` `FeedbackPurgeReq`

Pydantic のフィールド:

project_id: <class 'str'>
query: <class 'weave.trace_server.interface.query.Query'>

`クラス` `FeedbackPurgeRes`

`クラス` `FeedbackQueryReq`

Pydantic のフィールド:

project_id: <class 'str'>
fields: list[str] | None
query: weave.trace_server.interface.query.Query | None
sort_by: list[weave.trace_server.common_interface.SortBy] | None
limit: int | None
offset: int | None

`クラス` `FeedbackQueryRes`

Pydantic のフィールド:

result: list[dict[str, typing.Any]]

`クラス` `FeedbackReplaceReq`

Pydantic のフィールド:

id: str | None
project_id: <class 'str'>
weave_ref: <class 'str'>
creator: str | None
feedback_type: <class 'str'>
payload: dict[str, typing.Any]
annotation_ref: str | None
runnable_ref: str | None
call_ref: str | None
trigger_ref: str | None
queue_id: str | None
scorer_tags: list[str]
scorer_tag_reasons: dict[str, str]
scorer_tag_confidences: dict[str, float]
scorer_ratings: dict[str, float]
scorer_rating_reasons: dict[str, str]
scorer_rating_confidences: dict[str, float]
span_agent_name: <class 'str'>
span_agent_version: <class 'str'>
span_status_code: <class 'str'>
wb_user_id: str | None
feedback_id: <class 'str'>

`クラス` `FeedbackReplaceRes`

Pydantic のフィールド:

id: <class 'str'>
created_at: <class 'datetime.datetime'>
wb_user_id: <class 'str'>
payload: dict[str, typing.Any]

`クラス` `FeedbackStatsReq`

時間バケットごとに集計されたフィードバック統計を取得するためのリクエストです。 Pydantic のフィールド:

project_id: <class 'str'>
start: <class 'datetime.datetime'>
end: datetime.datetime | None
feedback_type: str | None
trigger_ref: str | None
granularity: int | None
timezone: <class 'str'>
metrics: list[FeedbackMetricSpec]

`メソッド` `validate_date_range`

validate_date_range() → _FeedbackFilterBase

フィードバックのリクエストが安全な日付範囲内に収まるようにします。

`クラス` `FeedbackStatsRes`

時系列のフィードバック統計を含む応答です。 Pydantic のフィールド:

start: <class 'datetime.datetime'>
end: <class 'datetime.datetime'>
granularity: <class 'int'>
timezone: <class 'str'>
buckets: list[dict[str, typing.Any]]
window_stats: dict[str, dict[str, float | None]] | None

`クラス` `FileContentReadReq`

Pydantic のフィールド:

project_id: <class 'str'>
digest: <class 'str'>

`クラス` `FileContentReadRes`

Pydantic のフィールド:

content: <class 'bytes'>

`クラス` `FileCreateReq`

Pydantic のフィールド:

project_id: <class 'str'>
name: <class 'str'>
content: <class 'bytes'>
expected_digest: str | None

`クラス` `FileCreateRes`

Pydantic のフィールド:

digest: <class 'str'>

`クラス` `FilesStatsReq`

Pydantic のフィールド:

project_id: <class 'str'>

`クラス` `FilesStatsRes`

Pydantic のフィールド:

total_size_bytes: <class 'int'>

`クラス` `FullTraceServerInterface`

V1 API と Object API の両方をサポートする、完全なトレースサーバーインターフェースです。このプロトコルは、従来の V1 エンドポイントと新しい Object エンドポイントの両方を含む、すべての API をサポートするトレースサーバー実装を表します。両方の API バージョンをサポートする必要がある実装では、このタイプを使用してください。

`メソッド` `agent_agents_query`

agent_agents_query(req: AgentsQueryReq) → AgentsQueryRes

`メソッド` `agent_conversation_chat`

agent_conversation_chat(
    req: AgentConversationChatReq
) → AgentConversationChatRes

`メソッド` `agent_conversation_spans`

agent_conversation_spans(
    req: AgentConversationSpansReq
) → AgentConversationSpansRes

`メソッド` `agent_custom_attrs_schema`

agent_custom_attrs_schema(
    req: AgentCustomAttrsSchemaReq
) → AgentCustomAttrsSchemaRes

`メソッド` `agent_search`

agent_search(req: AgentSearchReq) → AgentSearchRes

`メソッド` `agent_spans_query`

agent_spans_query(req: AgentSpansQueryReq) → AgentSpansQueryRes

`メソッド` `agent_spans_stats`

agent_spans_stats(req: AgentSpanStatsReq) → AgentSpanStatsRes

`メソッド` `agent_traces_chat`

agent_traces_chat(req: AgentTraceChatReq) → AgentTraceChatRes

`メソッド` `agent_versions_query`

agent_versions_query(req: AgentVersionsQueryReq) → AgentVersionsQueryRes

`メソッド` `aliases_list`

aliases_list(req: AliasesListReq) → AliasesListRes

`メソッド` `annotation_queue_add_calls`

annotation_queue_add_calls(
    req: AnnotationQueueAddCallsReq
) → AnnotationQueueAddCallsRes

`メソッド` `annotation_queue_create`

annotation_queue_create(
    req: AnnotationQueueCreateReq
) → AnnotationQueueCreateRes

`メソッド` `annotation_queue_delete`

annotation_queue_delete(
    req: AnnotationQueueDeleteReq
) → AnnotationQueueDeleteRes

`メソッド` `annotation_queue_items_query`

annotation_queue_items_query(
    req: AnnotationQueueItemsQueryReq
) → AnnotationQueueItemsQueryRes

`メソッド` `annotation_queue_read`

annotation_queue_read(req: AnnotationQueueReadReq) → AnnotationQueueReadRes

`メソッド` `annotation_queue_update`

annotation_queue_update(
    req: AnnotationQueueUpdateReq
) → AnnotationQueueUpdateRes

`メソッド` `annotation_queues_query_stream`

annotation_queues_query_stream(
    req: AnnotationQueuesQueryReq
) → Iterator[AnnotationQueueSchema]

`メソッド` `annotation_queues_stats`

annotation_queues_stats(
    req: AnnotationQueuesStatsReq
) → AnnotationQueuesStatsRes

`メソッド` `annotator_queue_items_progress_update`

annotator_queue_items_progress_update(
    req: AnnotatorQueueItemsProgressUpdateReq
) → AnnotatorQueueItemsProgressUpdateRes

`メソッド` `call_end`

call_end(req: CallEndReq) → CallEndRes

`メソッド` `call_end_v2`

call_end_v2(req: CallEndV2Req) → CallEndV2Res

`メソッド` `call_read`

call_read(req: CallReadReq) → CallReadRes

`メソッド` `call_start`

call_start(req: CallStartReq) → CallStartRes

`メソッド` `call_start_batch`

call_start_batch(req: CallCreateBatchReq) → CallCreateBatchRes

`メソッド` `call_start_v2`

call_start_v2(req: CallStartV2Req) → CallStartV2Res

`メソッド` `call_stats`

call_stats(req: 'CallStatsReq') → CallStatsRes

`メソッド` `call_update`

call_update(req: CallUpdateReq) → CallUpdateRes

`メソッド` `calls_complete`

calls_complete(req: CallsUpsertCompleteReq) → CallsUpsertCompleteRes

`メソッド` `calls_delete`

calls_delete(req: CallsDeleteReq) → CallsDeleteRes

`メソッド` `calls_query`

calls_query(req: CallsQueryReq) → CallsQueryRes

`メソッド` `calls_query_stats`

calls_query_stats(req: CallsQueryStatsReq) → CallsQueryStatsRes

`メソッド` `calls_query_stream`

calls_query_stream(req: CallsQueryReq) → Iterator[CallSchema]

`メソッド` `calls_score`

calls_score(req: CallsScoreReq) → CallsScoreRes

`メソッド` `calls_usage`

calls_usage(req: 'CallsUsageReq') → CallsUsageRes

`メソッド` `completions_create`

completions_create(req: CompletionsCreateReq) → CompletionsCreateRes

`メソッド` `completions_create_stream`

completions_create_stream(req: CompletionsCreateReq) → Iterator[dict[str, Any]]

`メソッド` `cost_create`

cost_create(req: CostCreateReq) → CostCreateRes

`メソッド` `cost_purge`

cost_purge(req: CostPurgeReq) → CostPurgeRes

`メソッド` `cost_query`

cost_query(req: CostQueryReq) → CostQueryRes

`メソッド` `dataset_create`

dataset_create(req: DatasetCreateReq) → DatasetCreateRes

`メソッド` `dataset_delete`

dataset_delete(req: DatasetDeleteReq) → DatasetDeleteRes

`メソッド` `dataset_list`

dataset_list(req: DatasetListReq) → Iterator[DatasetReadRes]

`メソッド` `dataset_read`

dataset_read(req: DatasetReadReq) → DatasetReadRes

`メソッド` `dataset_sources_link`

dataset_sources_link(req: DatasetSourcesLinkReq) → DatasetSourcesLinkRes

`メソッド` `dataset_sources_link_delete`

dataset_sources_link_delete(
    req: DatasetSourcesLinkDeleteReq
) → DatasetSourcesLinkDeleteRes

`メソッド` `dataset_sources_query`

dataset_sources_query(req: DatasetSourcesQueryReq) → DatasetSourcesQueryRes

`メソッド` `eval_results_query`

eval_results_query(req: EvalResultsQueryReq) → EvalResultsQueryRes

`メソッド` `evaluate_model`

evaluate_model(req: EvaluateModelReq) → EvaluateModelRes

`メソッド` `evaluation_create`

evaluation_create(req: EvaluationCreateReq) → EvaluationCreateRes

`メソッド` `evaluation_delete`

evaluation_delete(req: EvaluationDeleteReq) → EvaluationDeleteRes

`メソッド` `evaluation_list`

evaluation_list(req: EvaluationListReq) → Iterator[EvaluationReadRes]

`メソッド` `evaluation_read`

evaluation_read(req: EvaluationReadReq) → EvaluationReadRes

`メソッド` `evaluation_run_create`

evaluation_run_create(req: EvaluationRunCreateReq) → EvaluationRunCreateRes

`メソッド` `evaluation_run_delete`

evaluation_run_delete(req: EvaluationRunDeleteReq) → EvaluationRunDeleteRes

`メソッド` `evaluation_run_finish`

evaluation_run_finish(req: EvaluationRunFinishReq) → EvaluationRunFinishRes

`メソッド` `evaluation_run_list`

evaluation_run_list(req: EvaluationRunListReq) → Iterator[EvaluationRunReadRes]

`メソッド` `evaluation_run_read`

evaluation_run_read(req: EvaluationRunReadReq) → EvaluationRunReadRes

`メソッド` `evaluation_status`

evaluation_status(req: EvaluationStatusReq) → EvaluationStatusRes

`メソッド` `feedback_aggregate`

feedback_aggregate(req: FeedbackAggregateReq) → FeedbackAggregateRes

`メソッド` `feedback_create`

feedback_create(req: FeedbackCreateReq) → FeedbackCreateRes

`メソッド` `feedback_create_batch`

feedback_create_batch(req: FeedbackCreateBatchReq) → FeedbackCreateBatchRes

`メソッド` `feedback_payload_schema`

feedback_payload_schema(
    req: FeedbackPayloadSchemaReq
) → FeedbackPayloadSchemaRes

`メソッド` `feedback_purge`

feedback_purge(req: FeedbackPurgeReq) → FeedbackPurgeRes

`メソッド` `feedback_query`

feedback_query(req: FeedbackQueryReq) → FeedbackQueryRes

`メソッド` `feedback_replace`

feedback_replace(req: FeedbackReplaceReq) → FeedbackReplaceRes

`メソッド` `feedback_stats`

feedback_stats(req: FeedbackStatsReq) → FeedbackStatsRes

`メソッド` `file_content_read`

file_content_read(req: FileContentReadReq) → FileContentReadRes

`メソッド` `file_create`

file_create(req: FileCreateReq) → FileCreateRes

`メソッド` `files_stats`

files_stats(req: FilesStatsReq) → FilesStatsRes

`メソッド` `genai_otel_export`

genai_otel_export(req: GenAIOTelExportReq) → GenAIOTelExportRes

`メソッド` `image_create`

image_create(req: ImageGenerationCreateReq) → ImageGenerationCreateRes

`メソッド` `model_create`

model_create(req: ModelCreateReq) → ModelCreateRes

`メソッド` `model_delete`

model_delete(req: ModelDeleteReq) → ModelDeleteRes

`メソッド` `model_list`

model_list(req: ModelListReq) → Iterator[ModelReadRes]

`メソッド` `model_read`

model_read(req: ModelReadReq) → ModelReadRes

`メソッド` `obj_add_tags`

obj_add_tags(req: ObjAddTagsReq) → ObjAddTagsRes

`メソッド` `obj_create`

obj_create(req: ObjCreateReq) → ObjCreateRes

`メソッド` `obj_delete`

obj_delete(req: ObjDeleteReq) → ObjDeleteRes

`メソッド` `obj_read`

obj_read(req: ObjReadReq) → ObjReadRes

`メソッド` `obj_remove_aliases`

obj_remove_aliases(req: ObjRemoveAliasesReq) → ObjRemoveAliasesRes

`メソッド` `obj_remove_tags`

obj_remove_tags(req: ObjRemoveTagsReq) → ObjRemoveTagsRes

`メソッド` `obj_set_aliases`

obj_set_aliases(req: ObjSetAliasesReq) → ObjSetAliasesRes

`メソッド` `objs_query`

objs_query(req: ObjQueryReq) → ObjQueryRes

`メソッド` `op_create`

op_create(req: OpCreateReq) → OpCreateRes

`メソッド` `op_delete`

op_delete(req: OpDeleteReq) → OpDeleteRes

`メソッド` `op_list`

op_list(req: OpListReq) → Iterator[OpReadRes]

`メソッド` `op_read`

op_read(req: OpReadReq) → OpReadRes

`メソッド` `otel_export`

otel_export(req: OTelExportReq) → OTelExportRes

`メソッド` `prediction_create`

prediction_create(req: PredictionCreateReq) → PredictionCreateRes

`メソッド` `prediction_delete`

prediction_delete(req: PredictionDeleteReq) → PredictionDeleteRes

`メソッド` `prediction_finish`

prediction_finish(req: PredictionFinishReq) → PredictionFinishRes

`メソッド` `prediction_list`

prediction_list(req: PredictionListReq) → Iterator[PredictionReadRes]

`メソッド` `prediction_read`

prediction_read(req: PredictionReadReq) → PredictionReadRes

`メソッド` `project_stats`

project_stats(req: ProjectStatsReq) → ProjectStatsRes

`メソッド` `project_ttl_settings_read`

project_ttl_settings_read(
    req: ProjectTTLSettingsReadReq
) → ProjectTTLSettingsReadRes

`メソッド` `project_ttl_settings_update`

project_ttl_settings_update(
    req: ProjectTTLSettingsUpdateReq
) → ProjectTTLSettingsUpdateRes

`メソッド` `refs_read_batch`

refs_read_batch(req: RefsReadBatchReq) → RefsReadBatchRes

`メソッド` `rescore`

rescore(req: RescoreReq) → RescoreRes

`メソッド` `score_create`

score_create(req: ScoreCreateReq) → ScoreCreateRes

`メソッド` `score_delete`

score_delete(req: ScoreDeleteReq) → ScoreDeleteRes

`メソッド` `score_list`

score_list(req: ScoreListReq) → Iterator[ScoreReadRes]

`メソッド` `score_read`

score_read(req: ScoreReadReq) → ScoreReadRes

`メソッド` `scorer_create`

scorer_create(req: ScorerCreateReq) → ScorerCreateRes

`メソッド` `scorer_delete`

scorer_delete(req: ScorerDeleteReq) → ScorerDeleteRes

`メソッド` `scorer_list`

scorer_list(req: ScorerListReq) → Iterator[ScorerReadRes]

`メソッド` `scorer_read`

scorer_read(req: ScorerReadReq) → ScorerReadRes

`メソッド` `source_datasets_query`

source_datasets_query(req: SourceDatasetsQueryReq) → SourceDatasetsQueryRes

`メソッド` `table_create`

table_create(req: TableCreateReq) → TableCreateRes

`メソッド` `table_create_from_digests`

table_create_from_digests(
    req: TableCreateFromDigestsReq
) → TableCreateFromDigestsRes

`メソッド` `table_query`

table_query(req: TableQueryReq) → TableQueryRes

`メソッド` `table_query_stats`

table_query_stats(req: TableQueryStatsReq) → TableQueryStatsRes

`メソッド` `table_query_stats_batch`

table_query_stats_batch(req: TableQueryStatsBatchReq) → TableQueryStatsBatchRes

`メソッド` `table_query_stream`

table_query_stream(req: TableQueryReq) → Iterator[TableRowSchema]

`メソッド` `table_update`

table_update(req: TableUpdateReq) → TableUpdateRes

`メソッド` `tags_list`

tags_list(req: TagsListReq) → TagsListRes

`メソッド` `threads_query_stream`

threads_query_stream(req: ThreadsQueryReq) → Iterator[ThreadSchema]

`メソッド` `trace_usage`

trace_usage(req: 'TraceUsageReq') → TraceUsageRes

`クラス` `GenAISpanRef`

Pydantic のフィールド:

trace_id: <class 'str'>
span_id: <class 'str'>

`クラス` `ImageGenerationCreateReq`

Pydantic のフィールド:

project_id: <class 'str'>
inputs: <class 'ImageGenerationRequestInputs'>
wb_user_id: str | None
track_llm_call: bool | None

`クラス` `ImageGenerationCreateRes`

Pydantic のフィールド:

response: dict[str, typing.Any]
weave_call_id: str | None

`クラス` `ImageGenerationRequestInputs`

Pydantic のフィールド:

model: <class 'str'>
prompt: <class 'str'>
n: int | None

`クラス` `LLMAggregatedUsage`

特定の LLM の集計された使用状況メトリクス。 Pydantic のフィールド:

requests: <class 'int'>
prompt_tokens: <class 'int'>
completion_tokens: <class 'int'>
total_tokens: <class 'int'>
cache_read_input_tokens: <class 'int'>
cache_creation_input_tokens: <class 'int'>
prompt_tokens_total_cost: float | None
completion_tokens_total_cost: float | None
cache_read_input_tokens_total_cost: float | None
cache_creation_input_tokens_total_cost: float | None

`クラス` `LLMCostSchema`

`クラス` `LLMUsageSchema`

`クラス` `ModelCreateBody`

Pydantic のフィールド:

name: <class 'str'>
description: str | None
source_code: <class 'str'>
attributes: dict[str, typing.Any] | None

`クラス` `ModelCreateReq`

Pydantic のフィールド:

name: <class 'str'>
description: str | None
source_code: <class 'str'>
attributes: dict[str, typing.Any] | None
project_id: <class 'str'>
wb_user_id: str | None

`クラス` `ModelCreateRes`

Pydantic のフィールド:

digest: <class 'str'>
object_id: <class 'str'>
version_index: <class 'int'>
model_ref: <class 'str'>

`クラス` `ModelDeleteReq`

Pydantic のフィールド:

project_id: <class 'str'>
object_id: <class 'str'>
digests: list[str] | None
wb_user_id: str | None

`クラス` `ModelDeleteRes`

Pydantic のフィールド:

num_deleted: <class 'int'>

`クラス` `ModelListReq`

Pydantic のフィールド:

project_id: <class 'str'>
limit: int | None
offset: int | None

`クラス` `ModelReadReq`

Pydantic のフィールド:

project_id: <class 'str'>
object_id: <class 'str'>
digest: <class 'str'>

`クラス` `ModelReadRes`

Pydantic のフィールド:

object_id: <class 'str'>
digest: <class 'str'>
version_index: <class 'int'>
created_at: <class 'datetime.datetime'>
name: <class 'str'>
description: str | None
source_code: <class 'str'>
attributes: dict[str, typing.Any] | None

`クラス` `OTelExportReq`

Pydantic のフィールド:

processed_spans: list[ProcessedResourceSpans]
project_id: <class 'str'>
wb_user_id: str | None

`クラス` `OTelExportRes`

Pydantic のフィールド:

partial_success: ExportTracePartialSuccess | None

`クラス` `ObjAddTagsReq`

Pydantic のフィールド:

project_id: <class 'str'>
object_id: <class 'str'>
digest: <class 'str'>
tags: list[str]
wb_user_id: str | None

`メソッド` `validate_tags`

validate_tags() → ObjAddTagsReq

`クラス` `ObjAddTagsRes`

`クラス` `ObjCreateReq`

Pydantic のフィールド:

obj: <class 'ObjSchemaForInsert'>

`クラス` `ObjCreateRes`

Pydantic のフィールド:

digest: <class 'str'>
object_id: str | None

`クラス` `ObjDeleteReq`

Pydantic のフィールド:

project_id: <class 'str'>
object_id: <class 'str'>
digests: list[str] | None

`クラス` `ObjDeleteRes`

Pydantic のフィールド:

num_deleted: <class 'int'>

`クラス` `ObjQueryReq`

Pydantic のフィールド:

project_id: <class 'str'>
filter: ObjectVersionFilter | None
limit: int | None
offset: int | None
sort_by: list[weave.trace_server.common_interface.SortBy] | None
metadata_only: bool | None
include_storage_size: bool | None
include_tags_and_aliases: bool | None

`クラス` `ObjQueryRes`

Pydantic のフィールド:

objs: list[ObjSchema]

`クラス` `ObjReadReq`

Pydantic のフィールド:

project_id: <class 'str'>
object_id: <class 'str'>
digest: <class 'str'>
metadata_only: bool | None
include_tags_and_aliases: bool | None

`クラス` `ObjReadRes`

Pydantic のフィールド:

obj: <class 'ObjSchema'>

`クラス` `ObjRemoveAliasesReq`

Pydantic のフィールド:

project_id: <class 'str'>
object_id: <class 'str'>
aliases: list[str]
wb_user_id: str | None

`メソッド` `validate_aliases`

validate_aliases() → ObjRemoveAliasesReq

`クラス` `ObjRemoveAliasesRes`

`クラス` `ObjRemoveTagsReq`

Pydantic のフィールド:

project_id: <class 'str'>
object_id: <class 'str'>
digest: <class 'str'>
tags: list[str]
wb_user_id: str | None

`クラス` `ObjRemoveTagsRes`

`クラス` `ObjSchema`

Pydantic のフィールド:

project_id: <class 'str'>
object_id: <class 'str'>
created_at: <class 'datetime.datetime'>
deleted_at: datetime.datetime | None
digest: <class 'str'>
version_index: <class 'int'>
is_latest: <class 'int'>
kind: <class 'str'>
base_object_class: str | None
leaf_object_class: str | None
val: typing.Any
wb_user_id: str | None
size_bytes: int | None
tags: list[str] | None
aliases: list[str] | None

`クラス` `ObjSchemaForInsert`

Pydantic のフィールド:

project_id: <class 'str'>
object_id: <class 'str'>
val: typing.Any
builtin_object_class: str | None
set_base_object_class: str | None
expected_digest: str | None
wb_user_id: str | None

`メソッド` `model_post_init`

model_post_init(context: Any) → None

`クラス` `ObjSetAliasesReq`

Pydantic のフィールド:

project_id: <class 'str'>
object_id: <class 'str'>
digest: <class 'str'>
aliases: list[str]
wb_user_id: str | None

`メソッド` `validate_aliases`

validate_aliases() → ObjSetAliasesReq

`クラス` `ObjSetAliasesRes`

`クラス` `ObjectInterface`

トレースサーバーのオブジェクト API エンドポイント。このプロトコルには、オブジェクト管理 API が含まれており、よりクリーンで RESTful なインターフェースを提供します。実装では、後方互換性を維持するために、このプロトコルと TraceServerInterface の両方をサポートする必要があります。

`メソッド` `call_end_v2`

call_end_v2(req: CallEndV2Req) → CallEndV2Res

`メソッド` `call_start_v2`

call_start_v2(req: CallStartV2Req) → CallStartV2Res

`メソッド` `calls_complete`

calls_complete(req: CallsUpsertCompleteReq) → CallsUpsertCompleteRes

`メソッド` `dataset_create`

dataset_create(req: DatasetCreateReq) → DatasetCreateRes

`メソッド` `dataset_delete`

dataset_delete(req: DatasetDeleteReq) → DatasetDeleteRes

`メソッド` `dataset_list`

dataset_list(req: DatasetListReq) → Iterator[DatasetReadRes]

`メソッド` `dataset_read`

dataset_read(req: DatasetReadReq) → DatasetReadRes

`メソッド` `eval_results_query`

eval_results_query(req: EvalResultsQueryReq) → EvalResultsQueryRes

`メソッド` `evaluation_create`

evaluation_create(req: EvaluationCreateReq) → EvaluationCreateRes

`メソッド` `evaluation_delete`

evaluation_delete(req: EvaluationDeleteReq) → EvaluationDeleteRes

`メソッド` `evaluation_list`

evaluation_list(req: EvaluationListReq) → Iterator[EvaluationReadRes]

`メソッド` `evaluation_read`

evaluation_read(req: EvaluationReadReq) → EvaluationReadRes

`メソッド` `evaluation_run_create`

evaluation_run_create(req: EvaluationRunCreateReq) → EvaluationRunCreateRes

`メソッド` `evaluation_run_delete`

evaluation_run_delete(req: EvaluationRunDeleteReq) → EvaluationRunDeleteRes

`メソッド` `evaluation_run_finish`

evaluation_run_finish(req: EvaluationRunFinishReq) → EvaluationRunFinishRes

`メソッド` `evaluation_run_list`

evaluation_run_list(req: EvaluationRunListReq) → Iterator[EvaluationRunReadRes]

`メソッド` `evaluation_run_read`

evaluation_run_read(req: EvaluationRunReadReq) → EvaluationRunReadRes

`メソッド` `model_create`

model_create(req: ModelCreateReq) → ModelCreateRes

`メソッド` `model_delete`

model_delete(req: ModelDeleteReq) → ModelDeleteRes

`メソッド` `model_list`

model_list(req: ModelListReq) → Iterator[ModelReadRes]

`メソッド` `model_read`

model_read(req: ModelReadReq) → ModelReadRes

`メソッド` `op_create`

op_create(req: OpCreateReq) → OpCreateRes

`メソッド` `op_delete`

op_delete(req: OpDeleteReq) → OpDeleteRes

`メソッド` `op_list`

op_list(req: OpListReq) → Iterator[OpReadRes]

`メソッド` `op_read`

op_read(req: OpReadReq) → OpReadRes

`メソッド` `prediction_create`

prediction_create(req: PredictionCreateReq) → PredictionCreateRes

`メソッド` `prediction_delete`

prediction_delete(req: PredictionDeleteReq) → PredictionDeleteRes

`メソッド` `prediction_finish`

prediction_finish(req: PredictionFinishReq) → PredictionFinishRes

`メソッド` `prediction_list`

prediction_list(req: PredictionListReq) → Iterator[PredictionReadRes]

`メソッド` `prediction_read`

prediction_read(req: PredictionReadReq) → PredictionReadRes

`メソッド` `score_create`

score_create(req: ScoreCreateReq) → ScoreCreateRes

`メソッド` `score_delete`

score_delete(req: ScoreDeleteReq) → ScoreDeleteRes

`メソッド` `score_list`

score_list(req: ScoreListReq) → Iterator[ScoreReadRes]

`メソッド` `score_read`

score_read(req: ScoreReadReq) → ScoreReadRes

`メソッド` `scorer_create`

scorer_create(req: ScorerCreateReq) → ScorerCreateRes

`メソッド` `scorer_delete`

scorer_delete(req: ScorerDeleteReq) → ScorerDeleteRes

`メソッド` `scorer_list`

scorer_list(req: ScorerListReq) → Iterator[ScorerReadRes]

`メソッド` `scorer_read`

scorer_read(req: ScorerReadReq) → ScorerReadRes

`クラス` `ObjectVersionFilter`

Pydantic のフィールド:

base_object_classes: list[str] | None
exclude_base_object_classes: list[str] | None
leaf_object_classes: list[str] | None
object_ids: list[str] | None
is_op: bool | None
latest_only: bool | None
tags: list[str] | None
aliases: list[str] | None

`クラス` `OpCreateBody`

REST API 経由で Op オブジェクトを作成するためのリクエストボディです。 RESTful エンドポイントでは project_id は URL パスから取得されるため、このモデルには含まれません。 Pydantic のフィールド:

name: str | None
source_code: str | None

`クラス` `OpCreateReq`

Op オブジェクトを作成するためのリクエストモデルです。内部 API で使用するために project_id を追加して OpCreateBody を拡張します。 Pydantic のフィールド:

name: str | None
source_code: str | None
project_id: <class 'str'>
wb_user_id: str | None

`クラス` `OpCreateRes`

Op オブジェクトを作成するための応答モデルです。 Pydantic のフィールド:

digest: <class 'str'>
object_id: <class 'str'>
version_index: <class 'int'>

`クラス` `OpDeleteReq`

Pydantic のフィールド:

project_id: <class 'str'>
object_id: <class 'str'>
digests: list[str] | None
wb_user_id: str | None

`クラス` `OpDeleteRes`

Pydantic のフィールド:

num_deleted: <class 'int'>

`クラス` `OpListReq`

Pydantic のフィールド:

project_id: <class 'str'>
limit: int | None
offset: int | None
wb_user_id: str | None

`クラス` `OpReadReq`

Pydantic のフィールド:

project_id: <class 'str'>
object_id: <class 'str'>
digest: <class 'str'>
wb_user_id: str | None

`クラス` `OpReadRes`

Op オブジェクトを読み取る際の応答モデルです。 code フィールドには、op の実際のソースコードが含まれます。 Pydantic のフィールド:

object_id: <class 'str'>
digest: <class 'str'>
version_index: <class 'int'>
created_at: <class 'datetime.datetime'>
code: <class 'str'>

`クラス` `PredictionCreateBody`

REST API 経由で予測を作成するためのリクエストボディです。 RESTful エンドポイントでは project_id は URL パスから取得されるため、このモデルには含まれません。 Pydantic のフィールド:

model: <class 'str'>
inputs: dict[str, typing.Any]
output: typing.Any
evaluation_run_id: str | None
genai_span_ref: list[GenAISpanRef] | None

`クラス` `PredictionCreateReq`

予測を作成するためのリクエストモデルです。内部 API で使用する project_id を追加して PredictionCreateBody を拡張します。 Pydantic のフィールド:

model: <class 'str'>
inputs: dict[str, typing.Any]
output: typing.Any
evaluation_run_id: str | None
genai_span_ref: list[GenAISpanRef] | None
project_id: <class 'str'>
wb_user_id: str | None

`クラス` `PredictionCreateRes`

Pydantic のフィールド:

prediction_id: <class 'str'>

`クラス` `PredictionDeleteReq`

Pydantic のフィールド:

project_id: <class 'str'>
prediction_ids: list[str]
wb_user_id: str | None

`クラス` `PredictionDeleteRes`

Pydantic のフィールド:

num_deleted: <class 'int'>

`クラス` `PredictionFinishReq`

Pydantic のフィールド:

project_id: <class 'str'>
prediction_id: <class 'str'>
wb_user_id: str | None

`クラス` `PredictionFinishRes`

Pydantic のフィールド:

success: <class 'bool'>

`クラス` `PredictionListReq`

Pydantic のフィールド:

project_id: <class 'str'>
evaluation_run_id: str | None
limit: int | None
offset: int | None
wb_user_id: str | None

`クラス` `PredictionListRes`

Pydantic のフィールド:

predictions: list[PredictionReadRes]

`クラス` `PredictionReadReq`

Pydantic のフィールド:

project_id: <class 'str'>
prediction_id: <class 'str'>
wb_user_id: str | None

`クラス` `PredictionReadRes`

Pydantic のフィールド:

prediction_id: <class 'str'>
model: <class 'str'>
inputs: dict[str, typing.Any]
output: typing.Any
evaluation_run_id: str | None
wb_user_id: str | None

`クラス` `ProcessedResourceSpans`

Pydantic のフィールド:

entity: <class 'str'>
project: <class 'str'>
run_id: str | None
resource_spans: <class 'opentelemetry.proto.trace.v1.trace_pb2.ResourceSpans'>

`クラス` `ProjectStatsReq`

Pydantic のフィールド:

project_id: <class 'str'>
include_trace_storage_size: bool | None
include_object_storage_size: bool | None
include_table_storage_size: bool | None
include_file_storage_size: bool | None

`クラス` `ProjectStatsRes`

Pydantic のフィールド:

trace_storage_size_bytes: <class 'int'>
objects_storage_size_bytes: <class 'int'>
tables_storage_size_bytes: <class 'int'>
files_storage_size_bytes: <class 'int'>

`クラス` `ProjectTTLSettingsReadReq`

Pydantic のフィールド:

project_id: <class 'str'>

`クラス` `ProjectTTLSettingsReadRes`

Pydantic のフィールド:

retention_days: int | None

`クラス` `ProjectTTLSettingsUpdateReq`

Pydantic のフィールド:

project_id: <class 'str'>
retention_days: int | None
wb_user_id: str | None

`クラス` `ProjectTTLSettingsUpdateRes`

Pydantic のフィールド:

retention_days: int | None

`クラス` `RefsReadBatchReq`

Pydantic のフィールド:

refs: list[str]

`クラス` `RefsReadBatchRes`

Pydantic のフィールド:

vals: list[typing.Any]

`クラス` `RescoreBody`

REST API を介した再評価のリクエストボディ (サーバー側で設定されるフィールドは除きます) 。 Pydantic のフィールド:

source_evaluation_run_id: <class 'str'>
scorer_refs: list[str]

`クラス` `RescoreReq`

サーバーが設定するフィールドを含む、完全な再評価リクエストです。 Pydantic のフィールド:

source_evaluation_run_id: <class 'str'>
scorer_refs: list[str]
project_id: <class 'str'>
wb_user_id: str | None

`クラス` `RescoreRes`

再評価リクエストに対する応答です。 Pydantic のフィールド:

call_id: <class 'str'>
evaluation_run_id: <class 'str'>

`クラス` `RescoringArgs`

evaluate-model ワーカーに送信される再評価ジョブの引数です。 EvaluateModelArgs とは異なり、モデルの読み込みや予測の実行は行いません。source_evaluation_run_id の既存の予測に scorer のみを適用します。 Pydantic のフィールド:

job_type: typing.Literal['rescore']
project_id: <class 'str'>
source_evaluation_run_id: <class 'str'>
scorer_refs: list[str]
wb_user_id: str | None
new_evaluation_run_id: <class 'str'>

`クラス` `ScoreCreateBody`

REST API を介してスコアを作成するためのリクエストボディです。 RESTful エンドポイントでは project_id は URL パスから取得されるため、このモデルには含まれません。 Pydantic のフィールド:

prediction_id: <class 'str'>
scorer: <class 'str'>
value: typing.Any
evaluation_run_id: str | None

`クラス` `ScoreCreateReq`

スコアを作成するためのリクエストモデルです。内部 API で使用するために project_id を追加して ScoreCreateBody を拡張します。 Pydantic のフィールド:

prediction_id: <class 'str'>
scorer: <class 'str'>
value: typing.Any
evaluation_run_id: str | None
project_id: <class 'str'>
wb_user_id: str | None

`クラス` `ScoreCreateRes`

Pydantic のフィールド:

score_id: <class 'str'>

`クラス` `ScoreDeleteReq`

Pydantic のフィールド:

project_id: <class 'str'>
score_ids: list[str]
wb_user_id: str | None

`クラス` `ScoreDeleteRes`

Pydantic のフィールド:

num_deleted: <class 'int'>

`クラス` `ScoreListReq`

Pydantic のフィールド:

project_id: <class 'str'>
evaluation_run_id: str | None
limit: int | None
offset: int | None
wb_user_id: str | None

`クラス` `ScoreReadReq`

Pydantic のフィールド:

project_id: <class 'str'>
score_id: <class 'str'>
wb_user_id: str | None

`クラス` `ScoreReadRes`

Pydantic のフィールド:

score_id: <class 'str'>
scorer: <class 'str'>
value: typing.Any
evaluation_run_id: str | None
wb_user_id: str | None

`クラス` `ScorerCreateBody`

Pydantic のフィールド:

name: <class 'str'>
description: str | None
op_source_code: <class 'str'>

`クラス` `ScorerCreateReq`

Pydantic のフィールド:

name: <class 'str'>
description: str | None
op_source_code: <class 'str'>
project_id: <class 'str'>
wb_user_id: str | None

`クラス` `ScorerCreateRes`

Pydantic のフィールド:

digest: <class 'str'>
object_id: <class 'str'>
version_index: <class 'int'>
scorer: <class 'str'>

`クラス` `ScorerDeleteReq`

Pydantic のフィールド:

project_id: <class 'str'>
object_id: <class 'str'>
digests: list[str] | None
wb_user_id: str | None

`クラス` `ScorerDeleteRes`

Pydantic のフィールド:

num_deleted: <class 'int'>

`クラス` `ScorerListReq`

Pydantic のフィールド:

project_id: <class 'str'>
limit: int | None
offset: int | None
wb_user_id: str | None

`クラス` `ScorerReadReq`

Pydantic のフィールド:

project_id: <class 'str'>
object_id: <class 'str'>
digest: <class 'str'>
wb_user_id: str | None

`クラス` `ScorerReadRes`

Pydantic のフィールド:

object_id: <class 'str'>
digest: <class 'str'>
version_index: <class 'int'>
created_at: <class 'datetime.datetime'>
name: <class 'str'>
description: str | None
score_op: <class 'str'>

`クラス` `SourceDatasetMembership`

逆引きクエリにおける単一の (ソース、データセット) ペアの所属情報です。 Pydantic のフィールド:

source_kind: <enum 'SourceKind'>
source_id: <class 'str'>
source_trace_id: <class 'str'>
dataset_object_id: <class 'str'>
row_digests: list[str]
row_digests_truncated: <class 'bool'>
row_digests_total_count: <class 'int'>
first_seen_at: <class 'datetime.datetime'>

`クラス` `SourceDatasetsQueryReq`

逆引きクエリ: ソース -> データセット。 Pydantic のフィールド:

project_id: <class 'str'>
sources: list[SourceRef]
include_deleted: <class 'bool'>
wb_user_id: str | None

`クラス` `SourceDatasetsQueryRes`

ソース -> データセットの逆引きクエリからの応答です。 Pydantic のフィールド:

memberships: list[SourceDatasetMembership]

`クラス` `SourceKind`

`クラス` `SourceRef`

来歴のソース (Call、エージェントのスパン、または会話) への参照です。 Pydantic のフィールド:

source_kind: <enum 'SourceKind'>
source_id: <class 'str'>
source_trace_id: <class 'str'>

`クラス` `StartedCallSchemaForInsert`

Pydantic のフィールド:

project_id: <class 'str'>
id: str | None
op_name: <class 'str'>
display_name: str | None
trace_id: str | None
parent_id: str | None
thread_id: str | None
turn_id: str | None
started_at: <class 'datetime.datetime'>
attributes: dict[str, typing.Any]
inputs: dict[str, typing.Any]
otel_dump: dict[str, typing.Any] | None
wb_user_id: str | None
wb_run_id: str | None
wb_run_step: int | None

`クラス` `SummaryInsertMap`

`クラス` `SummaryMap`

`クラス` `TableAppendSpec`

Pydantic のフィールド:

append: <class 'TableAppendSpecPayload'>

`クラス` `TableAppendSpecPayload`

Pydantic のフィールド:

row: dict[str, typing.Any]

`クラス` `TableCreateFromDigestsReq`

Pydantic のフィールド:

project_id: <class 'str'>
row_digests: list[str]
expected_digest: str | None

`クラス` `TableCreateFromDigestsRes`

Pydantic のフィールド:

digest: <class 'str'>

`クラス` `TableCreateReq`

Pydantic のフィールド:

table: <class 'TableSchemaForInsert'>

`クラス` `TableCreateRes`

Pydantic のフィールド:

digest: <class 'str'>
row_digests: list[str]

`クラス` `TableInsertSpec`

Pydantic のフィールド:

insert: <class 'TableInsertSpecPayload'>

`クラス` `TableInsertSpecPayload`

Pydantic のフィールド:

index: <class 'int'>
row: dict[str, typing.Any]

`クラス` `TablePopSpec`

Pydantic のフィールド:

pop: <class 'TablePopSpecPayload'>

`クラス` `TablePopSpecPayload`

Pydantic のフィールド:

index: <class 'int'>

`クラス` `TableQueryReq`

Pydantic のフィールド:

project_id: <class 'str'>
digest: <class 'str'>
filter: TableRowFilter | None
limit: int | None
offset: int | None
sort_by: list[weave.trace_server.common_interface.SortBy] | None

`クラス` `TableQueryRes`

Pydantic のフィールド:

rows: list[TableRowSchema]

`クラス` `TableQueryStatsBatchReq`

Pydantic のフィールド:

project_id: <class 'str'>
digests: list[str] | None
include_storage_size: bool | None

`クラス` `TableQueryStatsBatchRes`

Pydantic のフィールド:

tables: list[TableStatsRow]

`クラス` `TableQueryStatsReq`

Pydantic のフィールド:

project_id: <class 'str'>
digest: <class 'str'>

`クラス` `TableQueryStatsRes`

Pydantic のフィールド:

count: <class 'int'>

`クラス` `TableRowFilter`

Pydantic のフィールド:

row_digests: list[str] | None

`クラス` `TableRowSchema`

Pydantic のフィールド:

digest: <class 'str'>
val: typing.Any
original_index: int | None

`クラス` `TableSchemaForInsert`

Pydantic のフィールド:

project_id: <class 'str'>
rows: list[dict[str, typing.Any]]
expected_digest: str | None

`クラス` `TableStatsRow`

Pydantic のフィールド:

count: <class 'int'>
digest: <class 'str'>
storage_size_bytes: int | None

`クラス` `TableUpdateReq`

Pydantic のフィールド:

project_id: <class 'str'>
base_digest: <class 'str'>
updates: list[TableAppendSpec | TablePopSpec | TableInsertSpec]

`クラス` `TableUpdateRes`

Pydantic のフィールド:

digest: <class 'str'>
updated_row_digests: list[str]

`クラス` `TagsListReq`

Pydantic のフィールド:

project_id: <class 'str'>
wb_user_id: str | None

`クラス` `TagsListRes`

Pydantic のフィールド:

tags: list[str]

`クラス` `ThreadSchema`

Pydantic のフィールド:

thread_id: <class 'str'>
turn_count: <class 'int'>
start_time: <class 'datetime.datetime'>
last_updated: <class 'datetime.datetime'>
first_turn_id: str | None
last_turn_id: str | None
p50_turn_duration_ms: float | None
p99_turn_duration_ms: float | None

`クラス` `ThreadsQueryFilter`

Pydantic のフィールド:

after_datetime: datetime.datetime | None
before_datetime: datetime.datetime | None
thread_ids: list[str] | None

`クラス` `ThreadsQueryReq`

ターンの Call のみを基に集計した統計を使って、スレッドをクエリします。ターンの Call は、スレッドのコンテキストの直接の子です (call.id == turn_id) 。これにより、ネストされた実装の詳細をすべて含めるのではなく、会話単位の意味のある統計が得られます。 Pydantic のフィールド:

project_id: <class 'str'>
filter: ThreadsQueryFilter | None
limit: int | None
offset: int | None
sort_by: list[weave.trace_server.common_interface.SortBy] | None

`クラス` `TraceServerInterface`

`メソッド` `agent_agents_query`

agent_agents_query(req: AgentsQueryReq) → AgentsQueryRes

`メソッド` `agent_conversation_chat`

agent_conversation_chat(
    req: AgentConversationChatReq
) → AgentConversationChatRes

`メソッド` `agent_conversation_spans`

agent_conversation_spans(
    req: AgentConversationSpansReq
) → AgentConversationSpansRes

`メソッド` `agent_custom_attrs_schema`

agent_custom_attrs_schema(
    req: AgentCustomAttrsSchemaReq
) → AgentCustomAttrsSchemaRes

`メソッド` `agent_search`

agent_search(req: AgentSearchReq) → AgentSearchRes

`メソッド` `agent_spans_query`

agent_spans_query(req: AgentSpansQueryReq) → AgentSpansQueryRes

`メソッド` `agent_spans_stats`

agent_spans_stats(req: AgentSpanStatsReq) → AgentSpanStatsRes

`メソッド` `agent_traces_chat`

agent_traces_chat(req: AgentTraceChatReq) → AgentTraceChatRes

`メソッド` `agent_versions_query`

agent_versions_query(req: AgentVersionsQueryReq) → AgentVersionsQueryRes

`メソッド` `aliases_list`

aliases_list(req: AliasesListReq) → AliasesListRes

`メソッド` `annotation_queue_add_calls`

annotation_queue_add_calls(
    req: AnnotationQueueAddCallsReq
) → AnnotationQueueAddCallsRes

`メソッド` `annotation_queue_create`

annotation_queue_create(
    req: AnnotationQueueCreateReq
) → AnnotationQueueCreateRes

`メソッド` `annotation_queue_delete`

annotation_queue_delete(
    req: AnnotationQueueDeleteReq
) → AnnotationQueueDeleteRes

`メソッド` `annotation_queue_items_query`

annotation_queue_items_query(
    req: AnnotationQueueItemsQueryReq
) → AnnotationQueueItemsQueryRes

`メソッド` `annotation_queue_read`

annotation_queue_read(req: AnnotationQueueReadReq) → AnnotationQueueReadRes

`メソッド` `annotation_queue_update`

annotation_queue_update(
    req: AnnotationQueueUpdateReq
) → AnnotationQueueUpdateRes

`メソッド` `annotation_queues_query_stream`

annotation_queues_query_stream(
    req: AnnotationQueuesQueryReq
) → Iterator[AnnotationQueueSchema]

`メソッド` `annotation_queues_stats`

annotation_queues_stats(
    req: AnnotationQueuesStatsReq
) → AnnotationQueuesStatsRes

`メソッド` `annotator_queue_items_progress_update`

annotator_queue_items_progress_update(
    req: AnnotatorQueueItemsProgressUpdateReq
) → AnnotatorQueueItemsProgressUpdateRes

`メソッド` `call_end`

call_end(req: CallEndReq) → CallEndRes

`メソッド` `call_read`

call_read(req: CallReadReq) → CallReadRes

`メソッド` `call_start`

call_start(req: CallStartReq) → CallStartRes

`メソッド` `call_start_batch`

call_start_batch(req: CallCreateBatchReq) → CallCreateBatchRes

`メソッド` `call_stats`

call_stats(req: 'CallStatsReq') → CallStatsRes

`メソッド` `call_update`

call_update(req: CallUpdateReq) → CallUpdateRes

`メソッド` `calls_delete`

calls_delete(req: CallsDeleteReq) → CallsDeleteRes

`メソッド` `calls_query`

calls_query(req: CallsQueryReq) → CallsQueryRes

`メソッド` `calls_query_stats`

calls_query_stats(req: CallsQueryStatsReq) → CallsQueryStatsRes

`メソッド` `calls_query_stream`

calls_query_stream(req: CallsQueryReq) → Iterator[CallSchema]

`メソッド` `calls_score`

calls_score(req: CallsScoreReq) → CallsScoreRes

`メソッド` `calls_usage`

calls_usage(req: 'CallsUsageReq') → CallsUsageRes

`メソッド` `completions_create`

completions_create(req: CompletionsCreateReq) → CompletionsCreateRes

`メソッド` `completions_create_stream`

completions_create_stream(req: CompletionsCreateReq) → Iterator[dict[str, Any]]

`メソッド` `cost_create`

cost_create(req: CostCreateReq) → CostCreateRes

`メソッド` `cost_purge`

cost_purge(req: CostPurgeReq) → CostPurgeRes

`メソッド` `cost_query`

cost_query(req: CostQueryReq) → CostQueryRes

`メソッド` `dataset_sources_link`

dataset_sources_link(req: DatasetSourcesLinkReq) → DatasetSourcesLinkRes

`メソッド` `dataset_sources_link_delete`

dataset_sources_link_delete(
    req: DatasetSourcesLinkDeleteReq
) → DatasetSourcesLinkDeleteRes

`メソッド` `dataset_sources_query`

dataset_sources_query(req: DatasetSourcesQueryReq) → DatasetSourcesQueryRes

`メソッド` `evaluate_model`

evaluate_model(req: EvaluateModelReq) → EvaluateModelRes

`メソッド` `evaluation_status`

evaluation_status(req: EvaluationStatusReq) → EvaluationStatusRes

`メソッド` `feedback_aggregate`

feedback_aggregate(req: FeedbackAggregateReq) → FeedbackAggregateRes

`メソッド` `feedback_create`

feedback_create(req: FeedbackCreateReq) → FeedbackCreateRes

`メソッド` `feedback_create_batch`

feedback_create_batch(req: FeedbackCreateBatchReq) → FeedbackCreateBatchRes

`メソッド` `feedback_payload_schema`

feedback_payload_schema(
    req: FeedbackPayloadSchemaReq
) → FeedbackPayloadSchemaRes

`メソッド` `feedback_purge`

feedback_purge(req: FeedbackPurgeReq) → FeedbackPurgeRes

`メソッド` `feedback_query`

feedback_query(req: FeedbackQueryReq) → FeedbackQueryRes

`メソッド` `feedback_replace`

feedback_replace(req: FeedbackReplaceReq) → FeedbackReplaceRes

`メソッド` `feedback_stats`

feedback_stats(req: FeedbackStatsReq) → FeedbackStatsRes

`メソッド` `file_content_read`

file_content_read(req: FileContentReadReq) → FileContentReadRes

`メソッド` `file_create`

file_create(req: FileCreateReq) → FileCreateRes

`メソッド` `files_stats`

files_stats(req: FilesStatsReq) → FilesStatsRes

`メソッド` `genai_otel_export`

genai_otel_export(req: GenAIOTelExportReq) → GenAIOTelExportRes

`メソッド` `image_create`

image_create(req: ImageGenerationCreateReq) → ImageGenerationCreateRes

`メソッド` `obj_add_tags`

obj_add_tags(req: ObjAddTagsReq) → ObjAddTagsRes

`メソッド` `obj_create`

obj_create(req: ObjCreateReq) → ObjCreateRes

`メソッド` `obj_delete`

obj_delete(req: ObjDeleteReq) → ObjDeleteRes

`メソッド` `obj_read`

obj_read(req: ObjReadReq) → ObjReadRes

`メソッド` `obj_remove_aliases`

obj_remove_aliases(req: ObjRemoveAliasesReq) → ObjRemoveAliasesRes

`メソッド` `obj_remove_tags`

obj_remove_tags(req: ObjRemoveTagsReq) → ObjRemoveTagsRes

`メソッド` `obj_set_aliases`

obj_set_aliases(req: ObjSetAliasesReq) → ObjSetAliasesRes

`メソッド` `objs_query`

objs_query(req: ObjQueryReq) → ObjQueryRes

`メソッド` `otel_export`

otel_export(req: OTelExportReq) → OTelExportRes

`メソッド` `project_stats`

project_stats(req: ProjectStatsReq) → ProjectStatsRes

`メソッド` `project_ttl_settings_read`

project_ttl_settings_read(
    req: ProjectTTLSettingsReadReq
) → ProjectTTLSettingsReadRes

`メソッド` `project_ttl_settings_update`

project_ttl_settings_update(
    req: ProjectTTLSettingsUpdateReq
) → ProjectTTLSettingsUpdateRes

`メソッド` `refs_read_batch`

refs_read_batch(req: RefsReadBatchReq) → RefsReadBatchRes

`メソッド` `rescore`

rescore(req: RescoreReq) → RescoreRes

`メソッド` `source_datasets_query`

source_datasets_query(req: SourceDatasetsQueryReq) → SourceDatasetsQueryRes

`メソッド` `table_create`

table_create(req: TableCreateReq) → TableCreateRes

`メソッド` `table_create_from_digests`

table_create_from_digests(
    req: TableCreateFromDigestsReq
) → TableCreateFromDigestsRes

`メソッド` `table_query`

table_query(req: TableQueryReq) → TableQueryRes

`メソッド` `table_query_stats`

table_query_stats(req: TableQueryStatsReq) → TableQueryStatsRes

`メソッド` `table_query_stats_batch`

table_query_stats_batch(req: TableQueryStatsBatchReq) → TableQueryStatsBatchRes

`メソッド` `table_query_stream`

table_query_stream(req: TableQueryReq) → Iterator[TableRowSchema]

`メソッド` `table_update`

table_update(req: TableUpdateReq) → TableUpdateRes

`メソッド` `tags_list`

tags_list(req: TagsListReq) → TagsListRes

`メソッド` `threads_query_stream`

threads_query_stream(req: ThreadsQueryReq) → Iterator[ThreadSchema]

`メソッド` `trace_usage`

trace_usage(req: 'TraceUsageReq') → TraceUsageRes

`クラス` `TraceStatus`

`クラス` `TraceUsageReq`

トレース内の Call ごとの使用量を、子孫の使用量をロールアップして算出するためのリクエストです。このエンドポイントは、トレース内の各 Call の使用状況メトリクスを返します。各 Call のメトリクスには、その Call 自身の使用量とすべての子孫の使用量の合計が含まれます。Call ごとにロールアップされたメトリクスを確認したい場合に、トレースビューで使用してください。注: 一致するすべての Call は、集約のためにメモリに読み込まれます。結果セットが非常に大きい場合 (Call が 10,000 件を超える場合) は、より具体的なフィルターを使用するか、アプリケーション層でページネーションを行うことを検討してください。 Pydantic のフィールド:

project_id: <class 'str'>
filter: CallsFilter | None
query: weave.trace_server.interface.query.Query | None
include_costs: <class 'bool'>
limit: <class 'int'>

`クラス` `TraceUsageRes`

Call ごとの使用状況メトリクス (各値には子孫の寄与分が含まれます) を含む応答です。 Pydantic のフィールド:

call_usage: dict[str, dict[str, LLMAggregatedUsage]]
unfinished_call_ids: list[str]

`クラス` `UsageMetricSpec`

集約対象となる使用状況メトリクスの仕様です (モデルごとにグループ化されます) 。 Pydantic のフィールド:

metric: typing.Literal['input_tokens', 'output_tokens', 'total_tokens', 'cache_read_input_tokens', 'cache_creation_input_tokens', 'input_cost', 'output_cost', 'total_cost']
aggregations: list[AggregationType]
percentiles: list[float]

`クラス` `WeaveSummarySchema`

最終更新日 2026年9月30日

​API 概要

​クラス AggregationType

​クラス AliasesListReq

​クラス AliasesListRes

​クラス AnnotationQueueAddCallsReq

​クラス AnnotationQueueAddCallsRes

​クラス AnnotationQueueCreateReq

​クラス AnnotationQueueCreateRes

​クラス AnnotationQueueDeleteReq

​クラス AnnotationQueueDeleteRes

​クラス AnnotationQueueItemSchema

​クラス AnnotationQueueItemsQueryReq

​クラス AnnotationQueueItemsQueryRes

​クラス AnnotationQueueReadReq

​クラス AnnotationQueueReadRes

​クラス AnnotationQueueSchema

​クラス AnnotationQueueStatsSchema

​クラス AnnotationQueueUpdateReq

​クラス AnnotationQueueUpdateRes

​クラス AnnotationQueuesQueryReq

​クラス AnnotationQueuesQueryRes

​クラス AnnotationQueuesStatsReq

​クラス AnnotationQueuesStatsRes

​クラス AnnotatorQueueItemsProgressUpdateReq

​クラス AnnotatorQueueItemsProgressUpdateRes

​クラス CallBatchEndMode

​クラス CallBatchStartMode

​クラス CallCreateBatchReq

​クラス CallCreateBatchRes

​クラス CallEndReq

​クラス CallEndRes

​クラス CallEndV2Req

​クラス CallEndV2Res

​クラス CallMetricSpec

​クラス CallReadReq

​クラス CallReadRes

​クラス CallSchema

​メソッド serialize_typed_dicts

​クラス CallStartReq

​クラス CallStartRes

​クラス CallStartV2Req

​クラス CallStartV2Res

​クラス CallStatsReq

​メソッド validate_date_range

​クラス CallStatsRes

​クラス CallUpdateReq

​クラス CallUpdateRes

​クラス CallsDeleteReq

​クラス CallsDeleteRes

​クラス CallsFilter

​クラス CallsQueryReq

​クラス CallsQueryRes

​クラス CallsQueryStatsReq

​クラス CallsQueryStatsRes

​クラス CallsScoreReq

​クラス CallsScoreRes

​クラス CallsUpsertCompleteReq

​クラス CallsUpsertCompleteRes

​クラス CallsUsageReq

​クラス CallsUsageRes

​クラス CompletedCallSchemaForInsert

​メソッド serialize_typed_dicts

​クラス CompletionsCreateReq

​クラス CompletionsCreateRequestInputs

​クラス CompletionsCreateRes

​クラス CostCreateInput

​クラス CostCreateReq

​クラス CostCreateRes

​クラス CostPurgeReq

​クラス CostPurgeRes

​クラス CostQueryOutput

​クラス CostQueryReq

​クラス CostQueryRes

​クラス DatasetCreateBody

​クラス DatasetCreateReq

​クラス DatasetCreateRes

​クラス DatasetDeleteReq

​クラス DatasetDeleteRes

​クラス DatasetListReq

​クラス DatasetReadReq

API 概要

`クラス` `AggregationType`

`クラス` `AliasesListReq`

`クラス` `AliasesListRes`

`クラス` `AnnotationQueueAddCallsReq`

`クラス` `AnnotationQueueAddCallsRes`

`クラス` `AnnotationQueueCreateReq`

`クラス` `AnnotationQueueCreateRes`

`クラス` `AnnotationQueueDeleteReq`

`クラス` `AnnotationQueueDeleteRes`

`クラス` `AnnotationQueueItemSchema`

`クラス` `AnnotationQueueItemsQueryReq`

`クラス` `AnnotationQueueItemsQueryRes`

`クラス` `AnnotationQueueReadReq`

`クラス` `AnnotationQueueReadRes`

`クラス` `AnnotationQueueSchema`

`クラス` `AnnotationQueueStatsSchema`

`クラス` `AnnotationQueueUpdateReq`

`クラス` `AnnotationQueueUpdateRes`

`クラス` `AnnotationQueuesQueryReq`

`クラス` `AnnotationQueuesQueryRes`

`クラス` `AnnotationQueuesStatsReq`

`クラス` `AnnotationQueuesStatsRes`

`クラス` `AnnotatorQueueItemsProgressUpdateReq`

`クラス` `AnnotatorQueueItemsProgressUpdateRes`

`クラス` `CallBatchEndMode`

`クラス` `CallBatchStartMode`

`クラス` `CallCreateBatchReq`

`クラス` `CallCreateBatchRes`

`クラス` `CallEndReq`

`クラス` `CallEndRes`

`クラス` `CallEndV2Req`

`クラス` `CallEndV2Res`

`クラス` `CallMetricSpec`

`クラス` `CallReadReq`

`クラス` `CallReadRes`

`クラス` `CallSchema`

`メソッド` `serialize_typed_dicts`

`クラス` `CallStartReq`

`クラス` `CallStartRes`

`クラス` `CallStartV2Req`

`クラス` `CallStartV2Res`

`クラス` `CallStatsReq`

`メソッド` `validate_date_range`

`クラス` `CallStatsRes`

`クラス` `CallUpdateReq`

`クラス` `CallUpdateRes`

`クラス` `CallsDeleteReq`

`クラス` `CallsDeleteRes`

`クラス` `CallsFilter`

`クラス` `CallsQueryReq`

`クラス` `CallsQueryRes`

`クラス` `CallsQueryStatsReq`

`クラス` `CallsQueryStatsRes`

`クラス` `CallsScoreReq`

`クラス` `CallsScoreRes`

`クラス` `CallsUpsertCompleteReq`

`クラス` `CallsUpsertCompleteRes`

`クラス` `CallsUsageReq`

`クラス` `CallsUsageRes`

`クラス` `CompletedCallSchemaForInsert`

`メソッド` `serialize_typed_dicts`

`クラス` `CompletionsCreateReq`

`クラス` `CompletionsCreateRequestInputs`

`クラス` `CompletionsCreateRes`

`クラス` `CostCreateInput`

`クラス` `CostCreateReq`

`クラス` `CostCreateRes`

`クラス` `CostPurgeReq`

`クラス` `CostPurgeRes`

`クラス` `CostQueryOutput`

`クラス` `CostQueryReq`

`クラス` `CostQueryRes`

`クラス` `DatasetCreateBody`

`クラス` `DatasetCreateReq`

`クラス` `DatasetCreateRes`

`クラス` `DatasetDeleteReq`

`クラス` `DatasetDeleteRes`

`クラス` `DatasetListReq`

`クラス` `DatasetReadReq`