데이터세트.목록실험()

추가된 항목: @mastra/core@1.4.0

선택적 필터 및 페이지 매김을 사용하여 이 데이터 세트에 대한 실험(실행)을 나열합니다. 필터는 스토리지 계층에 적용되므로 결과의 범위는 항상 현재 데이터 세트로 지정됩니다.

사용예

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})`)
}

매개변수

targetType?:

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

이 대상 유형을 상대로 실행된 실험의 결과로 제한합니다.

targetId?:

string

이 대상 ID를 상대로 실행된 실험의 결과로 제한합니다.

agentVersion?:

string

이 Agent 버전을 대상으로 기록된 실험의 결과로 제한합니다. 기준 실행과 변형 실행을 구분할 때 유용합니다.

status?:

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

이 상태의 실험 결과로 제한합니다.

filters?:

ExperimentTenancyFilters

멀티 테넌트 범위 필터(organizationId, projectId)입니다. 스토리지 계층으로 전달됩니다.

page?:

number

페이지 번호입니다. 기본값은 0입니다.

perPage?:

number

페이지당 실험 수입니다. 기본값은 20입니다.

보고

result:

Promise<object>

페이지가 매겨진 실험 목록입니다.

object

experiments:

Experiment[]

실험 레코드의 배열입니다.

Experiment

id:

string

실험의 고유 ID입니다.

name?:

string

표시 이름입니다.

description?:

string

설명입니다.

metadata?:

Record<string, unknown>

임의의 메타데이터입니다.

datasetId:

string

상위 데이터 세트의 ID입니다.

datasetVersion:

number | null

실험에 사용된 데이터 세트 버전입니다.

targetType:

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

사용된 대상의 유형입니다.

targetId:

string

사용된 대상의 ID입니다.

status:

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

실험의 현재 상태입니다.

totalItems:

number

전체 항목 수입니다.

succeededCount:

number

성공한 항목 수입니다.

failedCount:

number

실패한 항목 수입니다.

skippedCount:

number

건너뛴 항목 수입니다.

startedAt:

Date | null

실험이 시작된 시점입니다.

completedAt:

Date | null

실험이 완료된 시점입니다.

createdAt:

Date

실험 레코드가 생성된 시점입니다.

updatedAt:

Date

실험 레코드가 마지막으로 업데이트된 시점입니다.

pagination:

PaginationInfo

total, page, perPage, hasMore가 포함된 페이지네이션 메타데이터입니다.