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

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.

object

experiments:

Experiment[]

Tableau d’enregistrements d’expériences.

Experiment

id:

string

ID unique de l’expérience.

name?:

string

Nom d’affichage.

description?:

string

Description.

metadata?:

Record<string, unknown>

Métadonnées arbitraires.

datasetId:

string

ID du dataset parent.

datasetVersion:

number | null

Version du dataset utilisée pour l’expérience.

targetType:

'agent' | 'workflow' | 'scorer' | 'processor'

Type de cible utilisé.

targetId:

string

ID de la cible utilisée.

status:

'pending' | 'running' | 'completed' | 'failed'

Statut actuel de l’expérience.

totalItems:

number

Nombre total d’éléments.

succeededCount:

number

Nombre d’éléments réussis.

failedCount:

number

Nombre d’éléments ayant échoué.

skippedCount:

number

Nombre d’éléments ignorés.

startedAt:

Date | null

Date de début de l’expérience.

completedAt:

Date | null

Date de fin de l’expérience.

createdAt:

Date

Date de création de l’enregistrement de l’expérience.

updatedAt:

Date

Date de dernière mise à jour de l’enregistrement de l’expérience.

pagination:

PaginationInfo

Métadonnées de pagination avec total, page, perPage et hasMore.