> Discover all available pages from the documentation index: https://mastra.zisheng.pro/fr/llms.txt

# dataset.listExperiments()

**Ajouté dans :** `@mastra/core@1.4.0`

Liste les expériences (exécutions) de ce dataset avec des filtres facultatifs et une pagination. Les filtres sont appliqués au niveau du stockage, de sorte que les résultats sont toujours limités au dataset actuel.

## Exemple d’utilisation

```typescript
import { Mastra } from '@mastra/core'

const mastra = new Mastra({/* storage config */})

const dataset = await mastra.datasets.get({ id: 'dataset-id' })

// Basic pagination
const { experiments, pagination } = await dataset.listExperiments({ page: 0, perPage: 10 })

// Filter to a specific agent version — useful for baseline vs variant comparisons
const { experiments: v2Runs } = await dataset.listExperiments({
  targetType: 'agent',
  targetId: 'my-agent',
  agentVersion: 'v2',
  status: 'completed',
})

for (const exp of experiments) {
  console.log(`${exp.id}: ${exp.status} (${exp.succeededCount}/${exp.totalItems})`)
}
```

## Paramètres

**targetType** (`'agent' | 'workflow' | 'scorer' | 'processor'`): Limite les résultats aux expériences exécutées pour ce type de cible.

**targetId** (`string`): Limite les résultats aux expériences exécutées pour cet ID de cible.

**agentVersion** (`string`): Limite les résultats aux expériences enregistrées pour cette version d’Agent. Utile pour distinguer les exécutions de référence des variantes.

**status** (`'pending' | 'running' | 'completed' | 'failed'`): Limite les résultats aux expériences ayant ce statut.

**filters** (`ExperimentTenancyFilters`): Filtres de portée multilocataire (organizationId, projectId). Transmis au niveau du stockage.

**page** (`number`): Numéro de page. Utilise 0 par défaut.

**perPage** (`number`): Nombre d’expériences par page. Utilise 20 par défaut.

## Valeur renvoyée

**result** (`Promise<object>`): Liste paginée d’expériences.

**result.experiments** (`Experiment[]`): Tableau d’enregistrements d’expériences.

**result.experiments.id** (`string`): ID unique de l’expérience.

**result.experiments.name** (`string`): Nom d’affichage.

**result.experiments.description** (`string`): Description.

**result.experiments.metadata** (`Record<string, unknown>`): Métadonnées arbitraires.

**result.experiments.datasetId** (`string`): ID du dataset parent.

**result.experiments.datasetVersion** (`number | null`): Version du dataset utilisée pour l’expérience.

**result.experiments.targetType** (`'agent' | 'workflow' | 'scorer' | 'processor'`): Type de cible utilisé.

**result.experiments.targetId** (`string`): ID de la cible utilisée.

**result.experiments.status** (`'pending' | 'running' | 'completed' | 'failed'`): Statut actuel de l’expérience.

**result.experiments.totalItems** (`number`): Nombre total d’éléments.

**result.experiments.succeededCount** (`number`): Nombre d’éléments réussis.

**result.experiments.failedCount** (`number`): Nombre d’éléments ayant échoué.

**result.experiments.skippedCount** (`number`): Nombre d’éléments ignorés.

**result.experiments.startedAt** (`Date | null`): Date de début de l’expérience.

**result.experiments.completedAt** (`Date | null`): Date de fin de l’expérience.

**result.experiments.createdAt** (`Date`): Date de création de l’enregistrement de l’expérience.

**result.experiments.updatedAt** (`Date`): Date de dernière mise à jour de l’enregistrement de l’expérience.

**result.pagination** (`PaginationInfo`): Métadonnées de pagination avec total, page, perPage et hasMore.