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

# DatasetsManager.list()

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

Liste les datasets avec pagination et filtres facultatifs. Les filtres sont appliqués au niveau du stockage, afin que les appelants n’aient pas à filtrer de nouveau les résultats.

## Exemple d’utilisation

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

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

const { datasets, pagination } = await mastra.datasets.list({ page: 0, perPage: 10 })

for (const ds of datasets) {
  console.log(`${ds.id}: ${ds.name} (v${ds.version})`)
}

// Filter by target type and name (case-insensitive substring)
const filtered = await mastra.datasets.list({
  page: 0,
  perPage: 20,
  filters: { targetType: 'agent', name: 'qa' },
})

// Filter by any-overlap match on target IDs
const forAgents = await mastra.datasets.list({
  filters: { targetIds: ['agent-a', 'agent-b'] },
})
```

## Paramètres

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

**perPage** (`number`): Nombre de datasets par page. Utilise 20 par défaut.

**filters** (`object`): Filtres facultatifs appliqués au niveau du stockage.

**filters.organizationId** (`string`): Filtre de cloisonnement : limite aux datasets de cette organisation.

**filters.projectId** (`string`): Filtre de cloisonnement : limite aux datasets de ce projet.

**filters.candidateKey** (`string`): Limite aux datasets appartenant à cette clé de candidat.

**filters.candidateId** (`string`): Limite aux datasets appartenant à cet ID de candidat.

**filters.targetType** (`'agent' | 'workflow' | 'scorer' | 'processor'`): Limite aux datasets ciblant ce type de composant.

**filters.targetIds** (`string[]`): Limite aux datasets dont les targetIds intersectent cette liste (correspondance avec chevauchement). Un tableau vide est traité comme l’absence de filtre.

**filters.name** (`string`): Correspondance de sous-chaîne insensible à la casse sur le name du dataset. Une chaîne vide est traitée comme l’absence de filtre.

## Valeur renvoyée

**result** (`Promise<object>`): Liste paginée de datasets.

**result.datasets** (`DatasetRecord[]`): Tableau d’enregistrements de dataset. Consultez dataset.getDetails() pour connaître la structure de l’enregistrement.

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