데이터 세트.listExperimentResults()

추가된 항목: @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' })

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

매개변수

experimentId:

string

결과를 나열할 실험의 ID입니다.

traceId?:

string

이 Trace ID에 연결된 결과로 제한합니다.

status?:

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

결과별 검토 상태가 이 상태인 결과로 제한합니다.

filters?:

ExperimentTenancyFilters

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

page?:

number

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

perPage?:

number

페이지당 결과 수입니다. 기본값은 20입니다.

보고

result:

Promise<object>

페이지가 매겨진 실험 결과입니다.

object

results:

ExperimentResult[]

항목 수준 결과의 배열입니다.

ExperimentResult

id:

string

결과의 고유 ID입니다.

experimentId:

string

상위 실험의 ID입니다.

itemId:

string

데이터 세트 항목의 ID입니다.

itemDatasetVersion:

number | null

실행 당시 항목의 데이터 세트 버전입니다.

input:

unknown

대상에 전달된 입력 데이터입니다.

output:

unknown | null

대상에서 생성된 출력입니다.

groundTruth:

unknown | null

예상 출력입니다.

error:

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

실행에 실패한 경우의 구조화된 오류입니다.

startedAt:

Date

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

completedAt:

Date

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

retryCount:

number

재시도 횟수입니다.

traceId:

string | null

Observability를 위한 Trace ID입니다.

createdAt:

Date

결과 레코드가 생성된 시점입니다.

pagination:

PaginationInfo

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