Référence du schéma de l’objet Appel

Référence de la structure et des propriétés de l’objet Appel

Cette page fournit une référence sur le schéma de l’objet Appel dans W&B Weave. Pour plus d’informations sur les requêtes portant sur les appels, voir Interroger et exporter des appels.

​

Propriétés de l’Appel

Le tableau ci-dessous présente les principales propriétés d’un Appel dans Weave. Pour l’implémentation complète, voir :

• classe : CallSchema dans le SDK Python.
• Interface : CallSchema dans le SDK TypeScript.

Propriété	Type	Description
id	string (uuid)	Identifiant unique de l’Appel
project_id	string (facultatif)	Identifiant du projet associé
op_name	string	Nom de l’opération (peut être une référence)
display_name	string (facultatif)	Nom lisible de l’Appel
trace_id	string (uuid)	Identifiant de la trace à laquelle cet Appel appartient
parent_id	string (uuid)	Identifiant de l’Appel parent
started_at	datetime	Horodatage auquel l’Appel a commencé
attributes	Dict[str, Any]	Métadonnées définies par l’utilisateur pour l’Appel (en lecture seule pendant l’exécution)
inputs	Dict[str, Any]	Paramètres d’entrée de l’Appel
ended_at	datetime (facultatif)	Horodatage de fin de l’Appel
exception	string (facultatif)	Message d’erreur si l’Appel a échoué
output	Any (facultatif)	Résultat de l’Appel
summary	Optional[SummaryMap]	Informations de synthèse après l’exécution. Vous pouvez les modifier pendant l’exécution pour enregistrer des métriques personnalisées.
wb_user_id	Optional[str]	ID utilisateur W&B associé
wb_run_id	Optional[str]	ID de run W&B associé
deleted_at	datetime (facultatif)	Horodatage de suppression de l’Appel, le cas échéant

​

Détails des propriétés

Les propriétés de CallSchema jouent un rôle important dans le suivi et la gestion des appels de fonction :

• Les propriétés id, trace_id et parent_id aident à organiser les appels et à établir leurs relations au sein du système.

• Les informations temporelles (started_at, ended_at) facilitent l’analyse des performances.

• Les propriétés attributes et inputs fournissent du contexte sur l’appel. Les attributs sont figés une fois l’appel démarré ; définissez-les donc avant l’invocation avec weave.attributes. output et summary capturent les résultats. -Vous pouvez stocker des métriques ou d’autres valeurs post-appel dans la propriété summary. Modifiez call.summary pendant l’exécution. Toutes les valeurs que vous ajoutez sont fusionnées avec les données de résumé calculées par Weave lorsque l’Appel se termine.

  • Données de résumé calculées par Weave :
    • costs : Le coût total de l’appel en fonction des données d’utilisation du modèle LLM et des données de tarification des tokens. Pour plus d’informations sur le calcul des coûts, voir Suivre les coûts.
    • latency_ms : La durée, en millisecondes, écoulée entre started_at et ended_at. null si status est RUNNING.
    • status : Le statut d’exécution : SUCCESS, ERROR, RUNNING, DESCENDANT_ERROR (ce qui signifie que l’appel lui-même a réussi, mais qu’un appel descendant a échoué).

• L’intégration avec W&B est facilitée par wb_user_id et wb_run_id.

Cet ensemble complet de propriétés permet un suivi et une analyse détaillés des appels de fonction dans l’ensemble de votre projet.