Aperçu des panneaux de requête

Vous recherchez W&B Weave, la suite d’outils de W&B pour créer des applications d’IA générative ? Consultez la documentation de Weave.

Utilisez les panneaux de requête pour interroger vos données et les visualiser de manière interactive. Un panneau de requête vous permet de rassembler dans une seule vue des runs, des artifacts, des tableaux et d’autres objets W&B précis, puis de les explorer sous forme de tableaux ou de graphiques sans quitter votre workspace ou votre rapport. Cette page s’adresse aux utilisateurs qui souhaitent rédiger des requêtes ad hoc sur des données W&B journalisées et en afficher les résultats dans un workspace ou un rapport. Un panneau de requête se compose de trois éléments :

Expression : les données que vous sélectionnez.
Configuration : les paramètres facultatifs du panneau, comme le type de panneau et les options du menu en forme d’engrenage.
Panneau de résultats : la manière d’afficher les résultats, par exemple dans un tableau ou un graphique.

Pour découvrir des exemples interactifs et suivre un guide pas à pas sur la syntaxe des requêtes, consultez le rapport d’exemples du panneau de requête public. Les types et ops générés sont répertoriés dans l’aperçu du langage d’expressions de requête.

Créer un panneau de requête

Ajoutez un panneau de requête pour disposer d’un espace où rédiger des expressions et visualiser leurs résultats. Vous pouvez l’ajouter à un workspace de projet ou à un rapport.

Workspace de projet
W&B Report

Accédez au workspace de votre projet.
Dans le coin supérieur droit, cliquez sur Add panel.
Dans le menu déroulant, sélectionnez Panneau de requête.

Composants d’une requête

Les sections suivantes décrivent les trois éléments qui constituent un panneau de requête : l’expression qui sélectionne les données, la configuration qui détermine le comportement du panneau et le panneau de résultats qui effectue le rendu de la sortie.

Expressions

Utilisez des expressions de requête pour interroger les données que vous stockez dans W&B, comme les runs, les artifacts, les modèles, les tableaux, etc.

Exemple : interroger un tableau

Supposons que vous souhaitiez interroger une W&B Table. Dans votre code d’entraînement, vous journalisez un tableau nommé "cifar10_sample_table" :

import wandb
with wandb.init() as run:
  run.log({"cifar10_sample_table":[MY-TABLE]})

Dans le panneau de requête, vous pouvez interroger votre tableau à l’aide de :

runs.summary["cifar10_sample_table"]

Dans le détail :

runs est une variable injectée automatiquement dans les expressions du panneau de requête lorsque celui-ci se trouve dans un workspace. Sa valeur correspond à la liste des runs visibles dans ce workspace. Pour en savoir plus sur les différents attributs disponibles dans un run, consultez Comprendre les différents attributs.
summary est un op qui renvoie l’objet Summary d’un run. Les ops sont mappés : cet op est appliqué à chaque run de la liste, ce qui produit une liste d’objets Summary.
["cifar10_sample_table"] est un op Pick (signalé par des crochets) avec la clé cifar10_sample_table. Comme les objets Summary se comportent comme des dictionnaires ou des maps, cette opération extrait ce champ de chaque objet Summary.

Configurations

Dans le coin supérieur gauche du panneau, cliquez sur l’icône d’engrenage pour afficher la configuration de la requête. Celle-ci vous permet de définir le type de panneau ainsi que les paramètres du panneau de résultats.

Options du panneau

Le menu de configuration peut proposer des options qui modifient la façon dont le panneau combine ou charge les résultats de type tableau. Les libellés exacts et leur disponibilité dépendent de votre expression et du type de panneau. Pour des exemples de configurations concrètes, voir le rapport d’exemples du panneau de requête. Concat Utilisez Concat dans la configuration si vous souhaitez que le panneau fusionne des résultats de type tableau compatibles et les traite comme un tableau unique, pour l’affichage comme pour les opérations en aval. Ce paramètre est indépendant de la fusion de lignes au niveau de l’expression (par exemple, concat et join dans la requête). Pour plus d’informations, voir Combiner des tableaux dans les expressions. Paginate Utilisez Paginate lorsqu’un résultat de tableau risque d’être trop volumineux pour être rendu en une seule fois. La pagination charge les lignes par blocs afin que le panneau reste réactif. Combinez cette option avec des expressions qui renvoient de longues listes de lignes. Pour des modèles adaptés à la pagination, voir le rapport d’exemples du panneau de requête.

Panneaux de résultats

Le panneau de résultats de la requête affiche le rendu du résultat de l’expression de requête à l’aide du panneau de requête sélectionné, configuré pour présenter les données sous une forme interactive. Les images suivantes montrent les mêmes données sous forme de tableau (Table) et de graphique (Plot).

Panneau de résultats sous forme de tableau

Panneau de résultats sous forme de graphique

Parcourir l’historique du run étape par étape

Dans les tableaux et les graphiques créés à partir de runs ou de runs.history, l’application peut afficher un contrôle step (un curseur, par exemple) qui vous permet de parcourir les steps journalisés et d’examiner les métriques, le texte ou les médias tout au long de vos runs. Après avoir modifié l’expression, modifiez la configuration du panneau de requête et définissez Render As sur Stepper. Le contrôle peut suivre une autre métrique que _step si celle-ci correspond mieux à la façon dont vous avez journalisé les données. Pour des exemples d’expressions, consultez le rapport d’exemples du panneau de requête.

Opérations de base

Une fois que le panneau de requête a affiché les résultats, vous pouvez affiner l’affichage en triant, en filtrant, en mappant ou en regroupant les lignes. Voici les opérations courantes que vous pouvez effectuer dans vos panneaux de requête.

Trier

Triez depuis les options de colonne :

Filtre

Vous pouvez filtrer directement dans la requête ou utiliser le bouton de filtre situé dans le coin supérieur gauche du panneau.

Map

Les opérations Map parcourent des listes et appliquent une fonction à chaque élément des données. Vous pouvez les utiliser directement dans la requête d’un panneau ou en insérant une nouvelle colonne depuis les options de colonne.

Regrouper

Vous pouvez regrouper les données à l’aide d’une requête ou à partir des options de colonne.

Regroupement à partir des options de colonne

Combiner des tableaux dans les expressions

Utilisez concat, join et les ops associés dans votre expression lorsque vous devez empiler ou fusionner des listes de lignes issues de tableaux. Voir Jointure pour un exemple complet. Les éléments Concat et Paginate de la section Options du panneau sont des contrôles distincts, qui déterminent la façon dont l’interface fusionne et charge les résultats des tableaux.

Jointure

Vous pouvez également effectuer une jointure de tableaux directement dans la requête. Prenons l’expression de requête suivante :

project("luis_team_test", "weave_example_queries").runs.summary["short_table_0"].table.rows.concat.join(\
project("luis_team_test", "weave_example_queries").runs.summary["short_table_1"].table.rows.concat,\
(row) => row["Label"],(row) => row["Label"], "Table1", "Table2",\
"false", "false")

Le tableau de gauche est généré à partir de :

project("luis_team_test", "weave_example_queries").\
runs.summary["short_table_0"].table.rows.concat.join

Le tableau de droite est généré à partir de :

project("luis_team_test", "weave_example_queries").\
runs.summary["short_table_1"].table.rows.concat

Où :

(row) => row["Label"] sont les sélecteurs de chaque tableau, qui déterminent la colonne sur laquelle s’effectue la jointure.
"Table1" et "Table2" sont les noms attribués à chaque tableau après la jointure.
true et false correspondent aux paramètres de jointure interne/externe à gauche et à droite.

Objet runs

Utilisez les panneaux de requête pour accéder à l’objet runs. Les objets run conservent les enregistrements de vos expériences. Pour en savoir plus, consultez Accessing runs object. En résumé, l’objet runs donne accès aux éléments suivants :

summary : un dictionnaire d’informations qui synthétise les résultats du run. La synthèse peut contenir des valeurs scalaires, comme la précision et la perte, ou des fichiers volumineux. Par défaut, wandb.Run.log() affecte à la synthèse la valeur finale d’une série temporelle journalisée. Vous pouvez également définir directement le contenu de la synthèse. La synthèse correspond en quelque sorte aux sorties du run.
history : une liste de dictionnaires destinée à stocker les valeurs qui évoluent pendant l’entraînement du modèle, comme la perte. La commande wandb.Run.log() ajoute des éléments à cet objet.
config : un dictionnaire contenant les informations de configuration du run, comme les hyperparamètres d’un run d’entraînement ou les méthodes de prétraitement d’un run qui crée un artifact de jeu de données. Ces informations correspondent en quelque sorte aux entrées du run.

Accéder aux artifacts

Les artifacts sont un concept fondamental de W&B. Il s’agit de collections nommées et versionnées de fichiers et de répertoires. Utilisez les artifacts pour suivre les poids de modèle, les jeux de données et tout autre fichier ou répertoire. W&B stocke les artifacts, que vous pouvez ensuite télécharger ou réutiliser dans d’autres runs. Pour plus de détails et d’exemples, consultez Accessing artifacts. En général, vous accédez aux artifacts à partir de l’objet project :

project.artifactVersion() : renvoie la version d’artifact correspondant au nom et à la version indiqués dans un projet.
project.artifact("") : renvoie l’artifact correspondant au nom indiqué dans un projet. Vous pouvez ensuite utiliser .versions pour obtenir la liste de toutes les versions de cet artifact.
project.artifactType() : renvoie l’artifactType correspondant au nom indiqué dans un projet. Vous pouvez ensuite utiliser .artifacts pour obtenir la liste de tous les artifacts de ce type.
project.artifactTypes : renvoie la liste de tous les types d’artifacts du projet.

​Créer un panneau de requête

​Composants d’une requête

​Expressions

​Exemple : interroger un tableau

​Configurations

​Options du panneau

​Panneaux de résultats

​Parcourir l’historique du run étape par étape

​Opérations de base

​Trier

​Filtre

​Map

​Regrouper

​Combiner des tableaux dans les expressions

​Jointure

​Objet runs

​Accéder aux artifacts

Créer un panneau de requête

Composants d’une requête

Expressions

Exemple : interroger un tableau

Configurations

Options du panneau

Panneaux de résultats

Parcourir l’historique du run étape par étape

Opérations de base

Trier

Filtre

Map

Regrouper

Combiner des tableaux dans les expressions

Jointure

Objet runs

Accéder aux artifacts