Passer au contenu principal
Dans Weave, les vues enregistrées vous permettent de personnaliser la façon dont vous interagissez avec les appels de fonction tracés et les évaluations. En définissant une vue enregistrée, vous pouvez configurer des filtres, le tri et la visibilité des colonnes pour accéder rapidement aux données pertinentes. Les vues enregistrées vous permettent, à vous et à votre équipe, de revenir à la même sélection de traces ou d’évaluations sans devoir réappliquer la configuration à chaque fois. Vous pouvez créer, modifier et enregistrer des vues directement dans le SDK Python de Weave ou via l’interface utilisateur. Le SDK Python offre un contrôle précis pour le filtrage et les requêtes par programmation, tandis que l’interface utilisateur vous permet d’explorer et d’enregistrer différentes configurations de tableau dans les onglets Traces et Evals. Ce guide couvre :

Vues enregistrées dans le SDK Python

La classe SavedView de Weave permet d’enregistrer, de filtrer, de trier et de personnaliser des vues sur les données de trace et d’évaluation. Les sections suivantes expliquent comment initialiser une vue, configurer ses colonnes et ses filtres, puis l’enregistrer afin de pouvoir récupérer plus tard les appels correspondants.

Initialiser un SavedView

Initialisez une instance de SavedView dans votre projet Weave :
import weave
client = weave.init("[MY_PROJECT]")

view = weave.SavedView()

Afficher la SavedView sous forme de grille

Utilisez .to_grid() pour afficher la vue enregistrée sous forme de grille. Spécifiez le nombre maximal de lignes à afficher avec limit.
view.to_grid(limit=5)
Affichez la représentation en grille avec .show() :
view.to_grid().show()

Définir les colonnes affichées

Utilisez .set_columns() pour définir les colonnes à afficher dans la vue. Indiquez une ou plusieurs colonnes à afficher.
view.set_columns("id", "op_name")

Ajouter des colonnes

Utilisez .add_column() pour ajouter une ou plusieurs nouvelles colonnes à la vue. Indiquez une ou plusieurs colonnes à ajouter.
# Ajouter une colonne avec le spécificateur de champ et le libellé "Created"
view.add_column("Created")
# Facultatif : vous pouvez ajouter un second argument pour spécifier un nom de libellé différent pour la nouvelle colonne. Par défaut, le spécificateur de champ est utilisé comme libellé.

Trier les colonnes

Utilisez .sort_by() pour trier les résultats selon une colonne spécifique. Indiquez le nom de la colonne à trier et l’ordre de tri (asc ou desc).
view.sort_by("started_at", "desc")

Filtrer par nom d’opération

Dans Weave, chaque trace ou évaluation est associée à un nom d’opération. Utilisez .filter_op() pour filtrer la SavedView afin de n’inclure que les appels pour lesquels cette opération précise s’est exécutée.
view.filter_op("Evaluation.predict_and_score")

Filtrer par opérateur et condition

Utilisez .add_filter() pour appliquer un filtre personnalisé à la vue. Définissez le filtre à l’aide de l’un des opérateurs de filtre pris en charge et d’une condition.
view.add_filter("output.model_latency", ">=", 5)

Opérateurs de filtre

OpérateurDescriptionExemple
"contains"Vérifie si une chaîne contient une sous-chaîne.view.add_filter("output.status", "contains", "error")
"equals"Vérifie si une chaîne correspond exactement à une valeur donnée.view.add_filter("input.category", "equals", "Alice")
"in"Vérifie si une chaîne figure dans une liste de valeurs.view.add_filter("category", "in", ["A", "B", "C"])
"="Vérifie si un nombre est égal à une valeur.view.add_filter("output.score", "=", 80)
"≠", "!="Vérifie si un nombre n’est pas égal à une valeur.view.add_filter("metrics.loss", "!=", 0.5)
"<"Vérifie si un nombre est inférieur à une valeur.view.add_filter("age", "<", 30)
"≤", "<="Vérifie si un nombre est inférieur ou égal à une valeur.view.add_filter("metric.value", "<=", 100)
">"Vérifie si un nombre est supérieur à une valeur.view.add_filter("output.score", ">", 90)
"≥", ">="Vérifie si un nombre est supérieur ou égal à une valeur.view.add_filter("output.model_latency", ">=", 5)
"is"Vérifie si un champ booléen a la valeur True ou False.view.add_filter("is_active", "is", True)
"after"Vérifie si une date est postérieure à un horodatage donné.view.add_filter("started_at", "after", "2024-01-01")
"before"Vérifie si une date est antérieure à un horodatage donné.view.add_filter("ended_at", "before", "2024-12-31")
"is empty"Vérifie si un champ est vide (None ou "").view.add_filter("comments", "is empty", None)
"is not empty"Vérifie si un champ n’est pas vide.view.add_filter("attachments", "is not empty", None)

Supprimer des filtres

Utilisez .remove_filter() pour supprimer un filtre spécifique de la vue en indiquant son index ou le nom du champ.
view.remove_filter("output.model_latency")
Utilisez .remove_filters() pour supprimer tous les filtres.
view.remove_filters()

Enregistrez la SavedView

Utilisez .save() pour publier la vue enregistrée sur Weave.
view.save()

Récupérer les appels de fonction

Utilisez .get_calls() pour récupérer les appels de fonction correspondant aux filtres de la vue enregistrée. Vous pouvez spécifier des paramètres facultatifs, comme limit et offset.
calls = view.get_calls(limit=10)

Vues enregistrées dans l’UI

Vous pouvez créer, charger, renommer et modifier des vues enregistrées dans l’interface Weave. L’interface utilisateur est le moyen le plus rapide de capturer une configuration ad hoc de tableau sous forme de vue réutilisable. Pour un contrôle programmatique, utilisez le Python SDK.

Créer une vue enregistrée

  1. Accédez à l’onglet Traces ou Evals.
  2. Ajustez l’un des paramètres suivants dans la configuration de votre tableau :
    • Filtres
    • Ordre de tri
    • Taille de la page
    • Visibilité des colonnes
    • Épinglage des colonnes
  3. Enregistrez la vue de l’une des deux manières suivantes :
    • Dans le coin supérieur droit, cliquez sur Enregistrer la vue.
    • Cliquez sur le bouton menu () à gauche de Enregistrer la vue. Dans le menu déroulant, cliquez sur + Save as new view.

Charger une vue enregistrée

  1. Accédez à l’onglet Traces ou Evals.
  2. Cliquez sur le bouton menu () à gauche du titre de l’onglet. Un menu déroulant contenant toutes les vues enregistrées apparaît.
  3. Cliquez sur la vue que vous souhaitez ouvrir. La vue enregistrée s’affiche dans l’onglet Traces ou Evals.

Renommer une vue enregistrée

  1. Suivez les étapes décrites dans Charger une vue enregistrée.
  2. Dans l’angle supérieur gauche de l’onglet Traces ou Evals, cliquez sur le nom de la vue.
  3. Saisissez un nouveau nom pour la vue.
  4. Pour enregistrer le nouveau nom de la vue, appuyez sur Entrée.

Modifier une vue enregistrée

  1. Suivez les étapes décrites dans Charger une vue enregistrée.
  2. Ajustez la configuration de votre tableau.
  3. Dans le coin supérieur droit, cliquez sur Enregistrer la vue.

Supprimer une vue enregistrée

Vous pouvez supprimer une vue si vous estimez qu’elle ne vous est plus utile, à vous et à votre équipe. Vous ne pouvez pas annuler cette action.
  1. Accédez à l’onglet Traces ou Evals.
  2. Chargez la vue que vous souhaitez supprimer.
  3. Cliquez sur le bouton menu () à gauche de Enregistrer la vue.
  4. Dans le menu déroulant, cliquez sur Supprimer la vue.
  5. Dans la fenêtre modale, confirmez en cliquant sur Supprimer la vue. Sinon, cliquez sur Annuler pour annuler la suppression.

Revenir à la vue par défaut

  1. Accédez à l’onglet Traces ou Evals.
  2. Cliquez sur le bouton menu () à droite de l’onglet Traces ou Evals. Un menu déroulant répertoriant toutes les vues enregistrées s’affiche.
  3. En bas du menu, cliquez sur Traces ou Evals. La vue par défaut s’affiche.