> ## Documentation Index
> Fetch the complete documentation index at: https://docs.coreweave.com/llms.txt
> Use this file to discover all available pages before exploring further.
> Certaines fonctionnalités de cette page sont en version bêta et masquées derrière un indicateur de fonctionnalité. Ajoutez `weave-plot` à la biographie de votre page de profil pour débloquer toutes les fonctionnalités associées.
# 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](https://wandb.github.io/weave/?utm_source=wandb_docs\&utm_medium=docs\&utm_campaign=weave-nudge).
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](#expressions)** : les données que vous sélectionnez.
* **[Configuration](#configurations)** : les paramètres facultatifs du panneau, comme le type de panneau et les options du menu en forme d’engrenage.
* **[Panneau de résultats](#result-panels)** : 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](https://forge.coreweave.com/wandb/luis_team_test/weave_example_queries/reports/Weave-queries---Vmlldzo1NzIxOTY2?accessToken=bvzq5hwooare9zy790yfl3oitutbvno2i6c2s81gk91750m53m2hdclj0jvryhcr) public. Les types et ops générés sont répertoriés dans l’[aperçu du langage d’expressions de requête](/fr/products/wandb/ref/query-panel).
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.
1. Accédez au workspace de votre projet.
2. Dans le coin supérieur droit, cliquez sur **Add panel**.
3. Dans le menu déroulant, sélectionnez **Panneau de requête**.
* Saisissez **/Panneau de requête**, puis sélectionnez cette option.
Vous pouvez également associer une requête à un ensemble de runs :
1. Dans votre rapport, saisissez **/Panel grid**, puis sélectionnez cette option.
2. Cliquez sur le bouton **Add panel**.
3. 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"` :
```python theme={"system"}
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 :
```python theme={"system"}
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](/fr/products/wandb/track/public-api-guide#understanding-the-different-attributes).
* `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](https://forge.coreweave.com/wandb/luis_team_test/weave_example_queries/reports/Weave-queries---Vmlldzo1NzIxOTY2?accessToken=bvzq5hwooare9zy790yfl3oitutbvno2i6c2s81gk91750m53m2hdclj0jvryhcr).
**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](#combine-tables-in-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](https://forge.coreweave.com/wandb/luis_team_test/weave_example_queries/reports/Weave-queries---Vmlldzo1NzIxOTY2?accessToken=bvzq5hwooare9zy790yfl3oitutbvno2i6c2s81gk91750m53m2hdclj0jvryhcr).
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).
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](https://forge.coreweave.com/wandb/luis_team_test/weave_example_queries/reports/Weave-queries---Vmlldzo1NzIxOTY2?accessToken=bvzq5hwooare9zy790yfl3oitutbvno2i6c2s81gk91750m53m2hdclj0jvryhcr).
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.
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](#join) pour un exemple complet. Les éléments **Concat** et **Paginate** de la section [Options du panneau](#panel-options) 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 :
```python theme={"system"}
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 :
```python theme={"system"}
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 :
```python theme={"system"}
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](https://forge.coreweave.com/wandb/luis_team_test/weave_example_queries/reports/Weave-queries---Vmlldzo1NzIxOTY2?accessToken=bvzq5hwooare9zy790yfl3oitutbvno2i6c2s81gk91750m53m2hdclj0jvryhcr#3.-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](https://forge.coreweave.com/wandb/luis_team_test/weave_example_queries/reports/Weave-queries---Vmlldzo1NzIxOTY2?accessToken=bvzq5hwooare9zy790yfl3oitutbvno2i6c2s81gk91750m53m2hdclj0jvryhcr#4.-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.
