Aperçu de l’API
classe AggregationType
Fonctions d’agrégation prises en charge par les métriques des statistiques de feedback et d’appels.
classe AliasesListReq
Champs Pydantic :
project_id : <class 'str'>
wb_user_id : str | None
classe AliasesListRes
Champs Pydantic :
classe AnnotationQueueAddCallsReq
Requête permettant d’ajouter des appels par lot à une file d’annotation.
Étend AnnotationQueueAddCallsBody en ajoutant queue_id pour un usage interne de l’API.
Champs Pydantic :
project_id: <class 'str'>
call_ids: list[str]
display_fields: list[str]
queue_id: <class 'str'>
wb_user_id: str | None
classe AnnotationQueueAddCallsRes
Réponse à l’ajout d’appels à une file d’attente.
Champs Pydantic :
added_count: <class 'int'>
duplicates: <class 'int'>
classe AnnotationQueueCreateReq
Requête permettant de créer une nouvelle file d’annotation.
Champs Pydantic :
project_id: <class 'str'>
name: <class 'str'>
description: <class 'str'>
scorer_refs: list[str]
wb_user_id: str | None
classe AnnotationQueueCreateRes
Réponse à la création d’une file d’annotation.
Champs Pydantic :
classe AnnotationQueueDeleteReq
Requête permettant de supprimer (suppression logique) une file d’annotation.
Champs Pydantic :
project_id: <class 'str'>
queue_id: <class 'str'>
wb_user_id: str | None
classe AnnotationQueueDeleteRes
Réponse à la suppression d’une file d’annotation.
Champs Pydantic :
queue : <class 'AnnotationQueueSchema'>
classe AnnotationQueueItemSchema
Schéma des réponses relatives aux éléments d’une file d’annotation.
Champs 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
classe AnnotationQueueItemsQueryReq
Requête permettant d’interroger les éléments d’une file d’annotation.
Étend AnnotationQueueItemsQueryBody en ajoutant queue_id pour un usage interne de l’API.
Champs 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'>
classe AnnotationQueueItemsQueryRes
Réponse à une requête portant sur les éléments d’une file d’annotation.
Champs Pydantic :
items : list[AnnotationQueueItemSchema]
classe AnnotationQueueReadReq
Requête permettant de lire une file d’annotation spécifique.
Champs Pydantic :
project_id : <class 'str'>
queue_id : <class 'str'>
classe AnnotationQueueReadRes
Réponse à la lecture d’une file d’annotation.
Champs Pydantic :
queue : <class 'AnnotationQueueSchema'>
classe AnnotationQueueSchema
Schéma des réponses relatives aux files d’annotation.
Champs 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
classe AnnotationQueueStatsSchema
Statistiques d’une file d’annotation donnée.
Champs Pydantic :
queue_id : <class 'str'>
total_items : <class 'int'>
completed_items : <class 'int'>
classe AnnotationQueueUpdateReq
Requête permettant de mettre à jour une file d’annotation.
Tous les champs sont facultatifs, à l’exception de project_id et queue_id : seuls les champs fournis seront mis à jour.
Champs 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
classe AnnotationQueueUpdateRes
Réponse à la mise à jour d’une file d’annotation.
Champs Pydantic :
queue : <class 'AnnotationQueueSchema'>
classe AnnotationQueuesQueryReq
Requête permettant d’interroger les files d’annotation d’un projet.
Champs Pydantic :
project_id : <class 'str'>
name : str | None
sort_by : list[weave.trace_server.common_interface.SortBy] | None
limit : int | None
offset : int | None
classe AnnotationQueuesQueryRes
Réponse à une requête sur les files d’annotation.
Champs Pydantic :
queues: list[AnnotationQueueSchema]
classe AnnotationQueuesStatsReq
Requête permettant d’obtenir les statistiques de plusieurs files d’annotation.
Champs Pydantic :
project_id : <class 'str'>
queue_ids : list[str]
classe AnnotationQueuesStatsRes
Réponse contenant les statistiques de plusieurs files d’annotation.
Champs Pydantic :
stats : list[AnnotationQueueStatsSchema]
classe AnnotatorQueueItemsProgressUpdateReq
Requête permettant de mettre à jour l’état d’annotation d’un élément de la file d’attente pour l’annotateur actuel.
Transitions d’état valides :
- (absence) -> ‘in_progress’ : marquer l’élément comme en cours (uniquement si aucun enregistrement n’existe)
- (absence) -> ‘completed’ ou ‘skipped’ : terminer ou ignorer directement l’élément
- ‘in_progress’ ou ‘unstarted’ -> ‘completed’ ou ‘skipped’ : terminer ou ignorer un élément déjà commencé
- same_state -> same_state : no-op idempotent (renvoie l’élément existant sans modification)
Champs Pydantic :
project_id: <class 'str'>
queue_id: <class 'str'>
item_id: <class 'str'>
annotation_state: <class 'str'>
wb_user_id: str | None
classe AnnotatorQueueItemsProgressUpdateRes
Réponse à la mise à jour de l’état d’annotation.
Champs Pydantic :
item: <class 'AnnotationQueueItemSchema'>
classe CallBatchEndMode
Champs Pydantic :
mode : <class 'str'>
req : <class 'CallEndReq'>
classe CallBatchStartMode
Champs Pydantic :
mode : <class 'str'>
req : <class 'CallStartReq'>
classe CallCreateBatchReq
Champs Pydantic :
batch : list[CallBatchStartMode | CallBatchEndMode]
classe CallCreateBatchRes
Champs Pydantic :
res : list[CallStartRes | CallEndRes]
classe CallEndReq
Champs Pydantic :
end : <class 'EndedCallSchemaForInsert'>
classe CallEndRes
classe CallEndV2Req
Requête permettant de terminer un appel unique via l’API v2.
Champs Pydantic :
end : <class 'EndedCallSchemaForInsertWithStartedAt'>
classe CallEndV2Res
Réponse de l’opération de fin d’un appel unique via l’API v2.
classe CallMetricSpec
Spécification d’une métrique à agréger au niveau de l’appel (sans regroupement par modèle).
Champs Pydantic :
metric : typing.Literal['latency_ms', 'call_count', 'error_count']
aggregations : list[AggregationType]
percentiles : list[float]
classe CallReadReq
Champs Pydantic :
project_id : <class 'str'>
id : <class 'str'>
include_costs : bool | None
include_storage_size : bool | None
include_total_storage_size : bool | None
classe CallReadRes
Champs Pydantic :
classe CallSchema
Champs 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
méthode serialize_typed_dicts
classe CallStartReq
Champs Pydantic :
start : <class 'StartedCallSchemaForInsert'>
classe CallStartRes
Champs Pydantic :
id: <class 'str'>
trace_id: <class 'str'>
classe CallStartV2Req
Requête permettant de démarrer un appel unique via l’API v2.
Champs Pydantic :
start : <class 'StartedCallSchemaForInsert'>
classe CallStartV2Res
Réponse renvoyée lors du démarrage d’un appel unique via l’API v2.
Champs Pydantic :
id: <class 'str'>
trace_id: <class 'str'>
classe CallStatsReq
Requête de statistiques agrégées sur les appels pour une plage temporelle donnée.
Champs 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'>
méthode validate_date_range
Garantit que les requêtes de statistiques d’appels sont limitées à une plage de dates sûre.
classe CallStatsRes
Réponse contenant des statistiques d’appels sous forme de séries temporelles.
Champs 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]]
classe CallUpdateReq
Champs Pydantic :
project_id : <class 'str'>
call_id : <class 'str'>
display_name : str | None
wb_user_id : str | None
classe CallUpdateRes
classe CallsDeleteReq
Champs Pydantic :
project_id : <class 'str'>
call_ids : list[str]
wb_user_id : str | None
classe CallsDeleteRes
Champs Pydantic :
num_deleted : <class 'int'>
classe CallsFilter
Champs 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
classe CallsQueryReq
Champs 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
classe CallsQueryRes
Champs Pydantic :
classe CallsQueryStatsReq
Champs 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
classe CallsQueryStatsRes
Champs Pydantic :
count : <class 'int'>
has_more : <class 'bool'>
total_storage_size_bytes : int | None
classe CallsScoreReq
Requête permettant de mettre en file d’attente des jobs de scoring pour une liste d’appels.
Le scoring est effectué de manière asynchrone par le call_scoring_worker, qui consomme les messages provenant de Kafka et applique chaque scorer_ref à chaque call_id.
Champs Pydantic :
project_id: <class 'str'>
call_ids: list[str]
scorer_refs: list[str]
wb_user_id: str | None
classe CallsScoreRes
Réponse vide pour calls_score.
Définie comme un modèle (plutôt que de renvoyer None) afin de respecter la convention suivie dans l’ensemble de cette interface et de permettre d’ajouter ultérieurement des champs sans introduire de modification incompatible.
classe CallsUpsertCompleteReq
Requête permettant d’insérer ou de mettre à jour (upsert) un lot d’appels terminés.
Champs Pydantic :
batch : list[CompletedCallSchemaForInsert]
classe CallsUpsertCompleteRes
Réponse à l’insertion ou à la mise à jour (upsert) d’un lot d’appels terminés.
classe CallsUsageReq
Requête permettant de calculer l’utilisation agrégée de plusieurs appels racines.
Ce point de terminaison renvoie les métriques d’utilisation de chaque appel racine demandé, les métriques de chaque racine correspondant à la somme de sa propre utilisation et de celle de tous ses descendants.
Remarque : tous les appels correspondants sont chargés en mémoire pour l’agrégation. Pour les ensembles de résultats très volumineux (plus de 10 000 appels), envisagez de traiter les ID d’appels racines par lots ou d’appliquer des filtres plus restrictifs au niveau de la couche applicative.
Champs Pydantic :
project_id: <class 'str'>
call_ids: list[str]
include_costs: <class 'bool'>
limit: <class 'int'>
classe CallsUsageRes
Réponse contenant les métriques d’utilisation agrégées par appel racine.
Champs Pydantic :
call_usage : dict[str, dict[str, LLMAggregatedUsage]]
unfinished_call_ids : list[str]
classe CompletedCallSchemaForInsert
Schéma permettant d’insérer directement un appel terminé.
Représente un appel déjà terminé au moment de son insertion, dont les informations de début et de fin sont fournies ensemble. Utilisé par le point de terminaison calls_complete.
Champs 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
méthode serialize_typed_dicts
classe CompletionsCreateReq
Champs 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
Champs 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
classe CompletionsCreateRes
Champs Pydantic :
response : dict[str, typing.Any]
weave_call_id : str | None
span_id : str | None
trace_id : str | None
conversation_id : str | None
Champs 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
classe CostCreateReq
Champs Pydantic :
project_id : <class 'str'>
costs : dict[str, CostCreateInput]
wb_user_id : str | None
classe CostCreateRes
Champs Pydantic :
ids : list[tuple[str, str]]
classe CostPurgeReq
Champs Pydantic :
project_id : <class 'str'>
query : <class 'weave.trace_server.interface.query.Query'>
classe CostPurgeRes
classe CostQueryOutput
Champs 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
classe CostQueryReq
Champs 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
classe CostQueryRes
Champs Pydantic :
results : list[CostQueryOutput]
classe DatasetCreateBody
Champs Pydantic :
name: str | None
description: str | None
rows: list[dict[str, typing.Any]]
classe DatasetCreateReq
Champs Pydantic :
name: str | None
description: str | None
rows: list[dict[str, typing.Any]]
project_id: <class 'str'>
wb_user_id: str | None
classe DatasetCreateRes
Champs Pydantic :
digest : <class 'str'>
object_id : <class 'str'>
version_index : <class 'int'>
classe DatasetDeleteReq
Champs Pydantic :
project_id : <class 'str'>
object_id : <class 'str'>
digests : list[str] | None
wb_user_id : str | None
classe DatasetDeleteRes
Champs Pydantic :
num_deleted : <class 'int'>
classe DatasetListReq
Champs Pydantic :
project_id : <class 'str'>
limit : int | None
offset : int | None
wb_user_id : str | None
classe DatasetReadReq
Champs Pydantic :
project_id : <class 'str'>
object_id : <class 'str'>
digest : <class 'str'>
wb_user_id : str | None
classe DatasetReadRes
Champs 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'>
classe DatasetSourceLinkPayload
Une seule ligne de jeu de données et les sources à y lier.
Champs Pydantic :
row_digest : <class 'str'>
sources : list[SourceRef]
link_metadata : dict[str, typing.Any] | None
classe DatasetSourceLinkSchema
Schéma d’une ligne de lien vers une source de jeu de données.
Champs 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
classe DatasetSourcesLinkDeleteReq
Requête permettant de supprimer de manière réversible (soft-delete) des liens de sources de jeu de données par ID.
Champs Pydantic :
project_id: <class 'str'>
link_ids: list[str]
wb_user_id: str | None
classe DatasetSourcesLinkDeleteRes
Réponse à la suppression des liens de sources de jeu de données.
Champs Pydantic :
entries: list[DatasetSourcesLinkDeleteResEntry]
classe DatasetSourcesLinkDeleteResEntry
Résultat de la suppression d’un seul lien.
Champs Pydantic :
link_id : <class 'str'>
deleted : <class 'bool'>
classe DatasetSourcesLinkReq
Requête permettant de lier des lignes de jeu de données à leurs sources de provenance.
Champs 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
classe DatasetSourcesLinkRes
Réponse à la liaison de lignes de jeu de données à des sources.
Une entrée par tuple aplati (row_digest, source), dans l’ordre d’entrée.
Champs Pydantic :
entries : list[DatasetSourcesLinkResEntry]
classe DatasetSourcesLinkResEntry
Résultat pour un lien (row_digest, source) aplati unique.
Champs Pydantic :
link_id: <class 'str'>
created: bool | None
classe DatasetSourcesQueryReq
Requête directe : jeu de données -> sources.
Champs 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
classe DatasetSourcesQueryRes
Réponse à la requête directe jeu de données -> sources.
Champs Pydantic :
links: list[DatasetSourceLinkSchema]
classe EndedCallSchemaForInsert
Champs 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
méthode serialize_typed_dicts
classe EndedCallSchemaForInsertWithStartedAt
Alias obsolète. started_at se trouve désormais dans la classe parente EndedCallSchemaForInsert, à utiliser de préférence. Cet alias est conservé pour que les SDK externes épinglés sur le nom WithStartedAt puissent continuer à l’importer. À supprimer une fois que tous les appelants internes auront migré.
Champs 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
méthode serialize_typed_dicts
classe EvalResultsEvaluationSummary
Champs 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
classe EvalResultsFilter
Filtre limité à une évaluation facultative.
Champs Pydantic :
evaluation_call_id : str | None
query : <class 'weave.trace_server.interface.query.Query'>
classe EvalResultsQueryBody
Champs 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'>
méthode validate_identifiers
Vérifie qu’au moins un identifiant d’évaluation a été fourni.
classe EvalResultsQueryReq
Champs 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'>
méthode validate_identifiers
Vérifie qu’au moins un identifiant d’évaluation a été fourni.
classe EvalResultsQueryRes
Champs Pydantic :
rows : list[EvalResultsRow]
total_rows : <class 'int'>
summary : ForwardRef('EvalResultsSummaryRes | None')
warnings : list[str]
classe EvalResultsRow
Champs Pydantic :
row_digest : <class 'str'>
raw_data_row : typing.Any | None
evaluations : list[EvalResultsRowEvaluation]
classe EvalResultsRowEvaluation
Champs Pydantic :
evaluation_call_id : <class 'str'>
trials : list[EvalResultsTrial]
classe EvalResultsScorerStats
Statistiques d’une dimension de score aplatie unique (scorer_key ou scorer_key.path.to.leaf).
Champs 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
classe EvalResultsSortBy
Spécification de tri des résultats d’évaluation, qui étend SortBy
Champs Pydantic :
field: <class 'str'>
direction: typing.Literal['asc', 'desc']
evaluation_call_id: str | None
mode: typing.Literal['value', 'difference']
classe EvalResultsSummaryRes
Champs Pydantic :
row_count : <class 'int'>
evaluations : list[EvalResultsEvaluationSummary]
classe EvalResultsTrial
Champs 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
classe EvaluateModelArgs
Arguments d’un job complet d’évaluation de modèle (chargement du modèle, exécution des prédictions et calcul des scores).
Déplacé depuis workers/evaluate_model_worker/evaluate_model_worker.py afin que les deux types de jobs (EvaluateModelArgs et RescoringArgs) puissent être regroupés dans le même module pour l’union discriminée EvalWorkerJob.
Champs 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'>
classe EvaluateModelReq
Champs Pydantic :
project_id : <class 'str'>
evaluation_ref : <class 'str'>
model_ref : <class 'str'>
wb_user_id : str | None
classe EvaluateModelRes
Champs Pydantic :
classe EvaluationCreateBody
Champs 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
classe EvaluationCreateReq
Champs 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
classe EvaluationCreateRes
Champs Pydantic :
digest : <class 'str'>
object_id : <class 'str'>
version_index : <class 'int'>
evaluation_ref : <class 'str'>
classe EvaluationDeleteReq
Champs Pydantic :
project_id : <class 'str'>
object_id : <class 'str'>
digests : list[str] | None
wb_user_id : str | None
classe EvaluationDeleteRes
Champs Pydantic :
num_deleted : <class 'int'>
classe EvaluationListReq
Champs Pydantic :
project_id : <class 'str'>
limit : int | None
offset : int | None
wb_user_id : str | None
classe EvaluationReadReq
Champs Pydantic :
project_id : <class 'str'>
object_id : <class 'str'>
digest : <class 'str'>
wb_user_id : str | None
classe EvaluationReadRes
Champs 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
classe EvaluationRunCreateBody
Champs Pydantic :
evaluation: <class 'str'>
model: <class 'str'>
source_evaluation_run_id: str | None
classe EvaluationRunCreateReq
Champs Pydantic :
evaluation : <class 'str'>
model : <class 'str'>
source_evaluation_run_id : str | None
project_id : <class 'str'>
wb_user_id : str | None
classe EvaluationRunCreateRes
Champs Pydantic :
evaluation_run_id: <class 'str'>
classe EvaluationRunDeleteReq
Champs Pydantic :
project_id : <class 'str'>
evaluation_run_ids : list[str]
wb_user_id : str | None
classe EvaluationRunDeleteRes
Champs Pydantic :
num_deleted : <class 'int'>
classe EvaluationRunFilter
Champs Pydantic :
evaluations : list[str] | None
models : list[str] | None
evaluation_run_ids : list[str] | None
classe EvaluationRunFinishBody
Corps de requête permettant de terminer un run d’évaluation via l’API REST.
Ce modèle exclut project_id et evaluation_run_id, car ces valeurs sont fournies par le chemin de l’URL dans les points de terminaison RESTful.
Champs Pydantic :
summary : dict[str, typing.Any] | None
classe EvaluationRunFinishReq
Champs Pydantic :
summary : dict[str, typing.Any] | None
project_id : <class 'str'>
evaluation_run_id : <class 'str'>
wb_user_id : str | None
classe EvaluationRunFinishRes
Champs Pydantic :
classe EvaluationRunListReq
Champs Pydantic :
project_id: <class 'str'>
filter: EvaluationRunFilter | None
limit: int | None
offset: int | None
classe EvaluationRunReadReq
Champs Pydantic :
project_id : <class 'str'>
evaluation_run_id : <class 'str'>
classe EvaluationRunReadRes
Champs 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
classe EvaluationStatusComplete
Champs Pydantic :
code : typing.Literal['complete']
output : dict[str, typing.Any]
classe EvaluationStatusFailed
Champs Pydantic :
code : typing.Literal['failed']
error : str | None
classe EvaluationStatusNotFound
Champs Pydantic :
code: typing.Literal['not_found']
classe EvaluationStatusReq
Champs Pydantic :
project_id : <class 'str'>
call_id : <class 'str'>
classe EvaluationStatusRes
Champs Pydantic :
status : EvaluationStatusNotFound | EvaluationStatusRunning | EvaluationStatusFailed | EvaluationStatusComplete
classe EvaluationStatusRunning
Champs Pydantic :
code : typing.Literal['running']
completed_rows : <class 'int'>
total_rows : <class 'int'>
classe ExportTracePartialSuccess
Champs Pydantic :
rejected_spans : <class 'int'>
error_message : <class 'str'>
classe Feedback
Champs 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'>
classe FeedbackAggregateBucket
Une ligne (tranche temporelle, groupe) de feedback agrégé issu des scorers.
Champs 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]
classe FeedbackAggregateReq
Requête permettant d’obtenir des scores agrégés par tranche temporelle et par dimension.
Champs 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']]
classe FeedbackAggregateRes
Série temporelle creuse du feedback agrégé des scorers (les intervalles vides sont omis).
Champs Pydantic :
time_bucket_seconds: int | None
after_ms: <class 'int'>
before_ms: <class 'int'>
buckets: list[FeedbackAggregateBucket]
classe FeedbackCreateBatchReq
Champs Pydantic :
batch : list[FeedbackCreateReq]
classe FeedbackCreateBatchRes
Champs Pydantic :
res : list[FeedbackCreateRes]
classe FeedbackCreateReq
Champs 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
classe FeedbackCreateRes
Champs Pydantic :
id : <class 'str'>
created_at : <class 'datetime.datetime'>
wb_user_id : <class 'str'>
payload : dict[str, typing.Any]
classe FeedbackDict
classe FeedbackMetricSpec
Spécification d’une métrique de charge utile de feedback à agréger.
Champs Pydantic :
json_path: <class 'str'>
value_type: typing.Literal['numeric', 'boolean', 'categorical']
aggregations: list[AggregationType]
percentiles: list[float]
classe FeedbackPayloadPath
Chemin découvert dans la charge utile du feedback, avec son type déduit.
Champs Pydantic :
json_path : <class 'str'>
value_type : typing.Literal['numeric', 'boolean', 'categorical']
classe FeedbackPayloadSchemaReq
Requête de découverte du schéma de charge utile des feedbacks.
Champs 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'>
méthode validate_date_range
Garantit que les requêtes de feedback sont limitées à une plage de dates sûre.
classe FeedbackPayloadSchemaRes
Réponse contenant les chemins et les types découverts dans la charge utile des feedbacks.
Champs Pydantic :
paths: list[FeedbackPayloadPath]
classe FeedbackPurgeReq
Champs Pydantic :
project_id : <class 'str'>
query : <class 'weave.trace_server.interface.query.Query'>
classe FeedbackPurgeRes
classe FeedbackQueryReq
Champs 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
classe FeedbackQueryRes
Champs Pydantic :
result : list[dict[str, typing.Any]]
classe FeedbackReplaceReq
Champs 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'>
classe FeedbackReplaceRes
Champs Pydantic :
id : <class 'str'>
created_at : <class 'datetime.datetime'>
wb_user_id : <class 'str'>
payload : dict[str, typing.Any]
classe FeedbackStatsReq
Requête de statistiques de feedback agrégées par tranches temporelles.
Champs 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]
méthode validate_date_range
Garantit que les requêtes de feedback sont limitées à une plage de dates sûre.
classe FeedbackStatsRes
Réponse contenant des statistiques de feedback sous forme de séries temporelles.
Champs 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
classe FileContentReadReq
Champs Pydantic :
project_id : <class 'str'>
digest : <class 'str'>
classe FileContentReadRes
Champs Pydantic :
content : <class 'bytes'>
classe FileCreateReq
Champs Pydantic :
project_id : <class 'str'>
name : <class 'str'>
content : <class 'bytes'>
expected_digest : str | None
classe FileCreateRes
Champs Pydantic :
classe FilesStatsReq
Champs Pydantic :
project_id : <class 'str'>
classe FilesStatsRes
Champs Pydantic :
total_size_bytes : <class 'int'>
classe FullTraceServerInterface
Interface complète de trace server prenant en charge à la fois les API V1 et les API Object.
Ce protocole représente une implémentation de trace server qui prend en charge l’ensemble des API, à savoir les anciens points de terminaison V1 et les points de terminaison Object plus récents. Utilisez ce type pour les implémentations qui doivent prendre en charge les deux versions de l’API.
méthode agent_agents_query
méthode agent_conversation_chat
méthode agent_conversation_spans
méthode agent_custom_attrs_schema
méthode agent_search
méthode agent_spans_query
méthode agent_spans_stats
méthode agent_traces_chat
méthode agent_versions_query
méthode aliases_list
méthode annotation_queue_add_calls
méthode annotation_queue_create
méthode annotation_queue_delete
méthode annotation_queue_items_query
méthode annotation_queue_read
méthode annotation_queue_update
méthode annotation_queues_query_stream
méthode annotation_queues_stats
méthode annotator_queue_items_progress_update
méthode call_end
méthode call_end_v2
méthode call_read
méthode call_start
méthode call_start_batch
méthode call_start_v2
méthode call_stats
méthode call_update
méthode calls_complete
méthode calls_delete
méthode calls_query
méthode calls_query_stats
méthode calls_query_stream
méthode calls_score
méthode calls_usage
méthode completions_create
méthode completions_create_stream
méthode cost_create
méthode cost_purge
méthode cost_query
méthode dataset_create
méthode dataset_delete
méthode dataset_list
méthode dataset_read
méthode dataset_sources_link
méthode dataset_sources_link_delete
méthode dataset_sources_query
méthode eval_results_query
méthode evaluate_model
méthode evaluation_create
méthode evaluation_delete
méthode evaluation_list
méthode evaluation_read
méthode evaluation_run_create
méthode evaluation_run_delete
méthode evaluation_run_finish
méthode evaluation_run_list
méthode evaluation_run_read
méthode evaluation_status
méthode feedback_aggregate
méthode feedback_create
méthode feedback_create_batch
méthode feedback_payload_schema
méthode feedback_purge
méthode feedback_query
méthode feedback_replace
méthode feedback_stats
méthode file_content_read
méthode file_create
méthode files_stats
méthode genai_otel_export
méthode image_create
méthode model_create
méthode model_delete
méthode model_list
méthode model_read
méthode obj_create
méthode obj_delete
méthode obj_read
méthode obj_remove_aliases
méthode obj_set_aliases
méthode objs_query
méthode op_create
méthode op_delete
méthode op_list
méthode op_read
méthode otel_export
méthode prediction_create
méthode prediction_delete
méthode prediction_finish
méthode prediction_list
méthode prediction_read
méthode project_stats
méthode project_ttl_settings_read
méthode project_ttl_settings_update
méthode refs_read_batch
méthode rescore
méthode score_create
méthode score_delete
méthode score_list
méthode score_read
méthode scorer_create
méthode scorer_delete
méthode scorer_list
méthode scorer_read
méthode source_datasets_query
méthode table_create
méthode table_create_from_digests
méthode table_query
méthode table_query_stats
méthode table_query_stats_batch
méthode table_query_stream
méthode table_update
méthode threads_query_stream
méthode trace_usage
classe GenAISpanRef
Champs Pydantic :
trace_id : <class 'str'>
span_id : <class 'str'>
classe ImageGenerationCreateReq
Champs Pydantic :
project_id : <class 'str'>
inputs : <class 'ImageGenerationRequestInputs'>
wb_user_id : str | None
track_llm_call : bool | None
classe ImageGenerationCreateRes
Champs Pydantic :
response : dict[str, typing.Any]
weave_call_id : str | None
Champs Pydantic :
model : <class 'str'>
prompt : <class 'str'>
n : int | None
classe LLMAggregatedUsage
Métriques d’utilisation agrégées pour un LLM donné.
Champs 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
classe LLMCostSchema
classe LLMUsageSchema
classe ModelCreateBody
Champs Pydantic :
name : <class 'str'>
description : str | None
source_code : <class 'str'>
attributes : dict[str, typing.Any] | None
classe ModelCreateReq
Champs 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
classe ModelCreateRes
Champs Pydantic :
digest : <class 'str'>
object_id : <class 'str'>
version_index : <class 'int'>
model_ref : <class 'str'>
classe ModelDeleteReq
Champs Pydantic :
project_id : <class 'str'>
object_id : <class 'str'>
digests : list[str] | None
wb_user_id : str | None
classe ModelDeleteRes
Champs Pydantic :
num_deleted : <class 'int'>
classe ModelListReq
Champs Pydantic :
project_id : <class 'str'>
limit : int | None
offset : int | None
classe ModelReadReq
Champs Pydantic :
project_id : <class 'str'>
object_id : <class 'str'>
digest : <class 'str'>
classe ModelReadRes
Champs 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
classe OTelExportReq
Champs Pydantic :
processed_spans : list[ProcessedResourceSpans]
project_id : <class 'str'>
wb_user_id : str | None
classe OTelExportRes
Champs Pydantic :
partial_success : ExportTracePartialSuccess | None
Champs Pydantic :
project_id : <class 'str'>
object_id : <class 'str'>
digest : <class 'str'>
tags : list[str]
wb_user_id : str | None
classe ObjCreateReq
Champs Pydantic :
obj : <class 'ObjSchemaForInsert'>
classe ObjCreateRes
Champs Pydantic :
digest : <class 'str'>
object_id : str | None
classe ObjDeleteReq
Champs Pydantic :
project_id : <class 'str'>
object_id : <class 'str'>
digests : list[str] | None
classe ObjDeleteRes
Champs Pydantic :
num_deleted : <class 'int'>
classe ObjQueryReq
Champs 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
classe ObjQueryRes
Champs Pydantic :
classe ObjReadReq
Champs Pydantic :
project_id : <class 'str'>
object_id : <class 'str'>
digest : <class 'str'>
metadata_only : bool | None
include_tags_and_aliases : bool | None
classe ObjReadRes
Champs Pydantic :
classe ObjRemoveAliasesReq
Champs Pydantic :
project_id : <class 'str'>
object_id : <class 'str'>
aliases : list[str]
wb_user_id : str | None
méthode validate_aliases
classe ObjRemoveAliasesRes
Champs Pydantic :
project_id : <class 'str'>
object_id : <class 'str'>
digest : <class 'str'>
tags : list[str]
wb_user_id : str | None
classe ObjSchema
Champs 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
classe ObjSchemaForInsert
Champs 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
méthode model_post_init
classe ObjSetAliasesReq
Champs Pydantic :
project_id : <class 'str'>
object_id : <class 'str'>
digest : <class 'str'>
aliases : list[str]
wb_user_id : str | None
méthode validate_aliases
classe ObjSetAliasesRes
classe ObjectInterface
Points de terminaison d’API d’objets pour le Trace Server.
Ce protocole regroupe des API de gestion des objets qui fournissent des interfaces plus claires et plus conformes à REST. Les implémentations doivent prendre en charge à la fois ce protocole et TraceServerInterface afin de préserver la rétrocompatibilité.
méthode call_end_v2
méthode call_start_v2
méthode calls_complete
méthode dataset_create
méthode dataset_delete
méthode dataset_list
méthode dataset_read
méthode eval_results_query
méthode evaluation_create
méthode evaluation_delete
méthode evaluation_list
méthode evaluation_read
méthode evaluation_run_create
méthode evaluation_run_delete
méthode evaluation_run_finish
méthode evaluation_run_list
méthode evaluation_run_read
méthode model_create
méthode model_delete
méthode model_list
méthode model_read
méthode op_create
méthode op_delete
méthode op_list
méthode op_read
méthode prediction_create
méthode prediction_delete
méthode prediction_finish
méthode prediction_list
méthode prediction_read
méthode score_create
méthode score_delete
méthode score_list
méthode score_read
méthode scorer_create
méthode scorer_delete
méthode scorer_list
méthode scorer_read
classe ObjectVersionFilter
Champs 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
classe OpCreateBody
Corps de requête permettant de créer un objet Op via l’API REST.
Ce modèle exclut project_id, car cette valeur est fournie par le chemin de l’URL dans les points de terminaison RESTful.
Champs Pydantic :
name: str | None
source_code: str | None
classe OpCreateReq
Modèle de requête pour créer un objet Op.
Étend OpCreateBody en y ajoutant project_id pour l’utilisation interne de l’API.
Champs Pydantic :
name : str | None
source_code : str | None
project_id : <class 'str'>
wb_user_id : str | None
classe OpCreateRes
Modèle de réponse pour la création d’un objet op.
Champs Pydantic :
digest : <class 'str'>
object_id : <class 'str'>
version_index : <class 'int'>
classe OpDeleteReq
Champs Pydantic :
project_id : <class 'str'>
object_id : <class 'str'>
digests : list[str] | None
wb_user_id : str | None
classe OpDeleteRes
Champs Pydantic :
num_deleted : <class 'int'>
classe OpListReq
Champs Pydantic :
project_id : <class 'str'>
limit : int | None
offset : int | None
wb_user_id : str | None
classe OpReadReq
Champs Pydantic :
project_id : <class 'str'>
object_id : <class 'str'>
digest : <class 'str'>
wb_user_id : str | None
classe OpReadRes
Modèle de réponse pour la lecture d’un objet Op.
Le champ code contient le code source de l’op.
Champs Pydantic :
object_id: <class 'str'>
digest: <class 'str'>
version_index: <class 'int'>
created_at: <class 'datetime.datetime'>
code: <class 'str'>
classe PredictionCreateBody
Corps de requête permettant de créer une prédiction via l’API REST.
Ce modèle exclut project_id, car cette valeur provient du chemin de l’URL dans les points de terminaison RESTful.
Champs Pydantic :
model: <class 'str'>
inputs: dict[str, typing.Any]
output: typing.Any
evaluation_run_id: str | None
genai_span_ref: list[GenAISpanRef] | None
classe PredictionCreateReq
Modèle de requête permettant de créer une prédiction.
Étend PredictionCreateBody en ajoutant project_id pour un usage interne de l’API.
Champs 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
classe PredictionCreateRes
Champs Pydantic :
prediction_id : <class 'str'>
classe PredictionDeleteReq
Champs Pydantic :
project_id : <class 'str'>
prediction_ids : list[str]
wb_user_id : str | None
classe PredictionDeleteRes
Champs Pydantic :
num_deleted: <class 'int'>
classe PredictionFinishReq
Champs Pydantic :
project_id : <class 'str'>
prediction_id : <class 'str'>
wb_user_id : str | None
classe PredictionFinishRes
Champs Pydantic :
classe PredictionListReq
Champs Pydantic :
project_id : <class 'str'>
evaluation_run_id : str | None
limit : int | None
offset : int | None
wb_user_id : str | None
classe PredictionListRes
Champs Pydantic :
predictions : list[PredictionReadRes]
classe PredictionReadReq
Champs Pydantic :
project_id : <class 'str'>
prediction_id : <class 'str'>
wb_user_id : str | None
classe PredictionReadRes
Champs 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
classe ProcessedResourceSpans
Champs Pydantic :
entity : <class 'str'>
project : <class 'str'>
run_id : str | None
resource_spans : <class 'opentelemetry.proto.trace.v1.trace_pb2.ResourceSpans'>
classe ProjectStatsReq
Champs 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
classe ProjectStatsRes
Champs 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'>
classe ProjectTTLSettingsReadReq
Champs Pydantic :
project_id : <class 'str'>
classe ProjectTTLSettingsReadRes
Champs Pydantic :
retention_days : int | None
classe ProjectTTLSettingsUpdateReq
Champs Pydantic :
project_id : <class 'str'>
retention_days : int | None
wb_user_id : str | None
classe ProjectTTLSettingsUpdateRes
Champs Pydantic :
retention_days: int | None
classe RefsReadBatchReq
Champs Pydantic :
classe RefsReadBatchRes
Champs Pydantic :
classe RescoreBody
Corps de requête pour recalculer les scores via l’API REST (exclut les champs définis par le serveur).
Champs Pydantic :
source_evaluation_run_id : <class 'str'>
scorer_refs : list[str]
classe RescoreReq
Requête complète de réévaluation (rescore), y compris les champs définis côté serveur.
Champs Pydantic :
source_evaluation_run_id : <class 'str'>
scorer_refs : list[str]
project_id : <class 'str'>
wb_user_id : str | None
classe RescoreRes
Réponse à une requête de réévaluation (rescore).
Champs Pydantic :
call_id : <class 'str'>
evaluation_run_id : <class 'str'>
classe RescoringArgs
Arguments d’un job de réévaluation (rescore) envoyé au worker evaluate-model.
Contrairement à EvaluateModelArgs, aucun modèle n’est chargé et aucune prédiction n’est exécutée. Seuls le ou les scorers sont appliqués aux prédictions existantes issues de source_evaluation_run_id.
Champs 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'>
classe ScoreCreateBody
Corps de requête permettant de créer un Score via l’API REST.
Ce modèle exclut project_id, car cette valeur provient du chemin de l’URL dans les points de terminaison RESTful.
Champs Pydantic :
prediction_id: <class 'str'>
scorer: <class 'str'>
value: typing.Any
evaluation_run_id: str | None
classe ScoreCreateReq
Modèle de requête pour la création d’un Score.
Étend ScoreCreateBody en y ajoutant project_id pour un usage interne de l’API.
Champs 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
classe ScoreCreateRes
Champs Pydantic :
classe ScoreDeleteReq
Champs Pydantic :
project_id : <class 'str'>
score_ids : list[str]
wb_user_id : str | None
classe ScoreDeleteRes
Champs Pydantic :
num_deleted : <class 'int'>
classe ScoreListReq
Champs Pydantic :
project_id : <class 'str'>
evaluation_run_id : str | None
limit : int | None
offset : int | None
wb_user_id : str | None
classe ScoreReadReq
Champs Pydantic :
project_id : <class 'str'>
score_id : <class 'str'>
wb_user_id : str | None
classe ScoreReadRes
Champs Pydantic :
score_id : <class 'str'>
scorer : <class 'str'>
value : typing.Any
evaluation_run_id : str | None
wb_user_id : str | None
classe ScorerCreateBody
Champs Pydantic :
name : <class 'str'>
description : str | None
op_source_code : <class 'str'>
classe ScorerCreateReq
Champs Pydantic :
name: <class 'str'>
description: str | None
op_source_code: <class 'str'>
project_id: <class 'str'>
wb_user_id: str | None
classe ScorerCreateRes
Champs Pydantic :
digest : <class 'str'>
object_id : <class 'str'>
version_index : <class 'int'>
scorer : <class 'str'>
classe ScorerDeleteReq
Champs Pydantic :
project_id : <class 'str'>
object_id : <class 'str'>
digests : list[str] | None
wb_user_id : str | None
classe ScorerDeleteRes
Champs Pydantic :
num_deleted : <class 'int'>
classe ScorerListReq
Champs Pydantic :
project_id: <class 'str'>
limit: int | None
offset: int | None
wb_user_id: str | None
classe ScorerReadReq
Champs Pydantic :
project_id : <class 'str'>
object_id : <class 'str'>
digest : <class 'str'>
wb_user_id : str | None
classe ScorerReadRes
Champs 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'>
classe SourceDatasetMembership
Appartenance d’une paire (source, dataset) unique dans la requête inverse.
Champs 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'>
classe SourceDatasetsQueryReq
Requête inverse : sources -> datasets.
Champs Pydantic :
project_id: <class 'str'>
sources: list[SourceRef]
include_deleted: <class 'bool'>
wb_user_id: str | None
classe SourceDatasetsQueryRes
Réponse à la requête inverse sources -> datasets.
Champs Pydantic :
memberships : list[SourceDatasetMembership]
classe SourceKind
classe SourceRef
Référence à une source de provenance (un appel, un span d’agent ou une conversation).
Champs Pydantic :
source_kind : <enum 'SourceKind'>
source_id : <class 'str'>
source_trace_id : <class 'str'>
classe StartedCallSchemaForInsert
Champs 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
classe SummaryInsertMap
classe SummaryMap
classe TableAppendSpec
Champs Pydantic :
append : <class 'TableAppendSpecPayload'>
classe TableAppendSpecPayload
Champs Pydantic :
row : dict[str, typing.Any]
classe TableCreateFromDigestsReq
Champs Pydantic :
project_id : <class 'str'>
row_digests : list[str]
expected_digest : str | None
classe TableCreateFromDigestsRes
Champs Pydantic :
classe TableCreateReq
Champs Pydantic :
table : <class 'TableSchemaForInsert'>
classe TableCreateRes
Champs Pydantic :
digest : <class 'str'>
row_digests : list[str]
classe TableInsertSpec
Champs Pydantic :
insert : <class 'TableInsertSpecPayload'>
classe TableInsertSpecPayload
Champs Pydantic :
index: <class 'int'>
row: dict[str, typing.Any]
classe TablePopSpec
Champs Pydantic :
pop : <class 'TablePopSpecPayload'>
classe TablePopSpecPayload
Champs Pydantic :
classe TableQueryReq
Champs 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
classe TableQueryRes
Champs Pydantic :
rows : list[TableRowSchema]
classe TableQueryStatsBatchReq
Champs Pydantic :
project_id: <class 'str'>
digests: list[str] | None
include_storage_size: bool | None
classe TableQueryStatsBatchRes
Champs Pydantic :
tables : list[TableStatsRow]
classe TableQueryStatsReq
Champs Pydantic :
project_id : <class 'str'>
digest : <class 'str'>
classe TableQueryStatsRes
Champs Pydantic :
classe TableRowFilter
Champs Pydantic :
row_digests: list[str] | None
classe TableRowSchema
Champs Pydantic :
digest : <class 'str'>
val : typing.Any
original_index : int | None
classe TableSchemaForInsert
Champs Pydantic :
project_id : <class 'str'>
rows : list[dict[str, typing.Any]]
expected_digest : str | None
classe TableStatsRow
Champs Pydantic :
count: <class 'int'>
digest: <class 'str'>
storage_size_bytes: int | None
classe TableUpdateReq
Champs Pydantic :
project_id : <class 'str'>
base_digest : <class 'str'>
updates : list[TableAppendSpec | TablePopSpec | TableInsertSpec]
classe TableUpdateRes
Champs Pydantic :
digest : <class 'str'>
updated_row_digests : list[str]
Champs Pydantic :
project_id : <class 'str'>
wb_user_id : str | None
Champs Pydantic :
classe ThreadSchema
Champs 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
classe ThreadsQueryFilter
Champs Pydantic :
after_datetime : datetime.datetime | None
before_datetime : datetime.datetime | None
thread_ids : list[str] | None
classe ThreadsQueryReq
Interroge les threads avec des statistiques agrégées basées uniquement sur les appels de tour de conversation.
Les appels de tour de conversation sont les enfants directs des contextes de thread (où call.id == turn_id). On obtient ainsi des statistiques pertinentes au niveau de la conversation, sans inclure tous les détails d’implémentation imbriqués.
Champs Pydantic :
project_id: <class 'str'>
filter: ThreadsQueryFilter | None
limit: int | None
offset: int | None
sort_by: list[weave.trace_server.common_interface.SortBy] | None
classe TraceServerInterface
méthode agent_agents_query
méthode agent_conversation_chat
méthode agent_conversation_spans
méthode agent_custom_attrs_schema
méthode agent_search
méthode agent_spans_query
méthode agent_spans_stats
méthode agent_traces_chat
méthode agent_versions_query
méthode aliases_list
méthode annotation_queue_add_calls
méthode annotation_queue_create
méthode annotation_queue_delete
méthode annotation_queue_items_query
méthode annotation_queue_read
méthode annotation_queue_update
méthode annotation_queues_query_stream
méthode annotation_queues_stats
méthode annotator_queue_items_progress_update
méthode call_end
méthode call_read
méthode call_start
méthode call_start_batch
méthode call_stats
méthode call_update
méthode calls_delete
méthode calls_query
méthode calls_query_stats
méthode calls_query_stream
méthode calls_score
méthode calls_usage
méthode completions_create
méthode completions_create_stream
méthode cost_create
méthode cost_purge
méthode cost_query
méthode dataset_sources_link
méthode dataset_sources_link_delete
méthode dataset_sources_query
méthode evaluate_model
méthode evaluation_status
méthode feedback_aggregate
méthode feedback_create
méthode feedback_create_batch
méthode feedback_payload_schema
méthode feedback_purge
méthode feedback_query
méthode feedback_replace
méthode feedback_stats
méthode file_content_read
méthode file_create
méthode files_stats
méthode genai_otel_export
méthode image_create
méthode obj_create
méthode obj_delete
méthode obj_read
méthode obj_remove_aliases
méthode obj_set_aliases
méthode objs_query
méthode otel_export
méthode project_stats
méthode project_ttl_settings_read
méthode project_ttl_settings_update
méthode refs_read_batch
méthode rescore
méthode source_datasets_query
méthode table_create
méthode table_create_from_digests
méthode table_query
méthode table_query_stats
méthode table_query_stats_batch
méthode table_query_stream
méthode table_update
méthode threads_query_stream
méthode trace_usage
classe TraceStatus
classe TraceUsageReq
Requête permettant de calculer l’utilisation par appel pour une trace, avec agrégation des descendants.
Ce point de terminaison renvoie les métriques d’utilisation de chaque appel de la trace, les métriques de chaque appel incluant la somme de sa propre utilisation et de celle de tous ses descendants. Utilisez-le dans la vue de trace pour afficher les métriques agrégées par appel.
Remarque : tous les appels correspondants sont chargés en mémoire pour l’agrégation. Pour des ensembles de résultats très volumineux (plus de 10 000 appels), envisagez d’utiliser des filtres plus précis ou une pagination au niveau de la couche applicative.
Champs Pydantic :
project_id: <class 'str'>
filter: CallsFilter | None
query: weave.trace_server.interface.query.Query | None
include_costs: <class 'bool'>
limit: <class 'int'>
classe TraceUsageRes
Réponse contenant les métriques d’utilisation par appel (chacune inclut les contributions des appels descendants).
Champs Pydantic :
call_usage : dict[str, dict[str, LLMAggregatedUsage]]
unfinished_call_ids : list[str]
classe UsageMetricSpec
Spécification d’une métrique d’utilisation à agréger (regroupée par modèle).
Champs 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]
classe WeaveSummarySchema
Dernière modification le 30 septembre 2026