dataset.listExperimentResults()

Ajouté dans : @mastra/core@1.4.0

Répertorie les résultats de chaque élément pour une expérience précise, avec des filtres et une pagination facultatifs. Les filtres sont appliqués au niveau de la couche de stockage.

Exemple d'utilisation

import { Mastra } from '@mastra/core'

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

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

const { results, pagination } = await dataset.listExperimentResults({
  experimentId: 'exp-id',
  page: 0,
  perPage: 50,
})

// Restrict to results that still need review
const { results: pending } = await dataset.listExperimentResults({
  experimentId: 'exp-id',
  status: 'needs-review',
})

// Restrict to results tied to a specific trace
const { results: byTrace } = await dataset.listExperimentResults({
  experimentId: 'exp-id',
  traceId: 'trace-abc',
})

for (const result of results) {
  console.log(`Item ${result.itemId}: ${result.error ? 'FAILED' : 'OK'}`)
}

Paramètres

experimentId:

string

Identifiant de l'expérience dont les résultats doivent être répertoriés.

traceId?:

string

Limite les résultats à ceux qui sont associés à cet identifiant de Trace.

status?:

'needs-review' | 'reviewed' | 'complete'

Limite les résultats à ce statut de vérification individuel.

filters?:

ExperimentTenancyFilters

Filtres de portée multilocataire (organizationId, projectId). Transmis à la couche de stockage.

page?:

number

Numéro de page. La valeur par défaut est 0.

perPage?:

number

Nombre de résultats par page. La valeur par défaut est 20.

Valeur renvoyée

result:

Promise<object>

Résultats paginés de l'expérience.

object

results:

ExperimentResult[]

Tableau des résultats individuels des éléments.

ExperimentResult

id:

string

Identifiant unique du résultat.

experimentId:

string

Identifiant de l'expérience parente.

itemId:

string

Identifiant de l'élément du Dataset.

itemDatasetVersion:

number | null

Version du Dataset de l'élément au moment de l'exécution.

input:

unknown

Données d'entrée transmises à la cible.

output:

unknown | null

Sortie de la cible.

groundTruth:

unknown | null

Sortie attendue.

error:

{ message: string; stack?: string; code?: string } | null

Erreur structurée en cas d'échec de l'exécution.

startedAt:

Date

Date et heure du début de l'exécution.

completedAt:

Date

Date et heure de la fin de l'exécution.

retryCount:

number

Nombre de nouvelles tentatives.

traceId:

string | null

Identifiant de Trace pour l'observabilité.

createdAt:

Date

Date et heure de création de l'enregistrement du résultat.

pagination:

PaginationInfo

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