> ## 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.

# Aperçu de l’API Reports et Workspaces

> Utilisez l’API W&B Reports et Workspaces pour créer et gérer des rapports et des workspaces par programmation

L’API W\&B Reports et Workspaces, accessible via `wandb_workspaces`, vous permet de créer des [rapports](/fr/products/wandb/reports), publiables sur le web pour partager vos résultats, et de personnaliser le [workspace](/fr/products/wandb/app/features/cascade-settings) dans lequel vous avez mené vos travaux d’entraînement et de fine-tuning.

<Card title="Voir le code source" href="https://github.com/wandb/wandb-workspaces/blob/main/wandb_workspaces/" icon="code" />

<Note>
  L’API W\&B Report et Workspace est en préversion publique.
</Note>

<h2 id="installation-and-setup">
  Installation et configuration
</h2>

<h3 id="sign-up-and-create-an-api-key">
  S’inscrire et créer une clé API
</h3>

Pour authentifier votre machine auprès de W\&B, vous devez d’abord générer une clé API dans les [Paramètres utilisateur](https://forge.coreweave.com/settings).

<h3 id="install-and-import-packages">
  Installer et importer les packages
</h3>

Installez la bibliothèque W\&B Report and Workspaces.

```python theme={"system"}
pip install wandb-workspaces
```

<h3 id="create-a-report">
  Créer un rapport
</h3>

Pour créer un rapport, indiquez l’entity de votre équipe et fournissez un nom pour votre rapport. Remplacez le texte encadré par vos propres valeurs :

```python theme={"system"}
import wandb_workspaces.reports.v2 as wr 
# Créer le rapport
report = wr.Report(
    entity="<team_entity>",
    project="<project_name>",
    title='Quickstart Report',
    description="That was easy!"
)

# Enregistrer le rapport
report.save()
```

Ajoutez ensuite des blocs et des panneaux à votre rapport. Par exemple, le code suivant crée un rapport contenant une table des matières, un en-tête et un paragraphe :

```python theme={"system"}
report.blocks = [
    wr.TableOfContents(),
    wr.H1("Text and images example"),
    wr.P("Lorem ipsum dolor sit amet."),
]
report.save()
```

Consultez le notebook Google Colab [Démarrage rapide de l’API Reports](https://colab.research.google.com/github/wandb/examples/blob/master/colabs/intro/Report_API_Quickstart.ipynb) pour un exemple complet de bout en bout.

<h3 id="create-a-workspace">
  Créer un workspace
</h3>

Le code suivant montre comment créer un workspace avec une section contenant trois panneaux : un graphique en courbes, un graphique à barres et un graphique scalaire. Remplacez le texte entre chevrons par vos propres valeurs :

```python theme={"system"}
# Importation
import wandb_workspaces.workspaces as ws

# Créer un workspace
ws.Workspace(
     entity="<team_entity>", # entity propriétaire du workspace
     project="<project_name>", # projet associé au workspace
     sections=[
         ws.Section(
             name="<Validation Metrics>",
             panels=[
                 wr.LinePlot(x="Step", y=["<val_loss>"]),
                 wr.BarPlot(metrics=["<val_accuracy>"]),
                 wr.ScalarChart(metric="<f1_score>", groupby_aggfunc="<mean>"),
             ],
             is_open=True,
         ),
     ],
)
workspace.save()
```

Consultez le notebook Google Colab [Démarrage rapide de l’API Workspace](https://colab.research.google.com/github/wandb/wandb-workspaces/blob/Update-wandb-workspaces-tuturial/Workspace_tutorial.ipynb#scrollTo=MmxL0wjvrNtQ) pour un exemple complet de bout en bout.