Créer et gérer des vues enregistrées

Personnalisez votre interaction avec les appels de fonction tracés et les évaluations

Dans Weave, les vues enregistrées vous permettent de personnaliser votre interaction 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 afin d’accéder rapidement aux données pertinentes.

Vous pouvez créer, modifier et enregistrer des vues directement dans le SDK Python de Weave ou via l’UI. Le SDK Python offre un contrôle fin pour le filtrage et les requêtes par programmation, tandis que l’UI permet d’explorer et d’enregistrer facilement différentes configurations de tableau dans les onglets Traces et Evals.

Ce guide explique comment :

• créer et modifier des vues enregistrées dans le SDK Python.
• créer des vues enregistrées et interagir avec elles dans le Weave UI.

​

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.

​

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")
# Facultativement, 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é pour le 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 a été 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érateur	Description	Exemple
"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 appartient à 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 vaut True ou False.	view.add_filter("is_active", "is", True)
"after"	Vérifie si une date est postérieure à un timestamp donné.	view.add_filter("started_at", "after", "2024-01-01")
"before"	Vérifie si une date est antérieure à un timestamp 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 Weave UI. Pour un contrôle plus fin, 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 menu hamburger à 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 menu hamburger à 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. En haut à droite, 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. Cette action est irréversible.

1. Accédez à l’onglet Traces ou Evals.
2. Chargez la vue que vous souhaitez supprimer.
3. Cliquez sur le menu hamburger à 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 menu hamburger à 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.