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

# 데이터 세트.listExperimentResults()

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

선택적 필터 및 페이지 매김을 사용하여 특정 실험에 대한 개별 항목 결과를 나열합니다. 필터는 저장 계층에 적용됩니다.

## 사용예

```typescript
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>`): 페이지가 매겨진 실험 결과입니다.

**result.results** (`ExperimentResult[]`): 항목 수준 결과의 배열입니다.

**result.results.id** (`string`): 결과의 고유 ID입니다.

**result.results.experimentId** (`string`): 상위 실험의 ID입니다.

**result.results.itemId** (`string`): 데이터 세트 항목의 ID입니다.

**result.results.itemDatasetVersion** (`number | null`): 실행 당시 항목의 데이터 세트 버전입니다.

**result.results.input** (`unknown`): 대상에 전달된 입력 데이터입니다.

**result.results.output** (`unknown | null`): 대상에서 생성된 출력입니다.

**result.results.groundTruth** (`unknown | null`): 예상 출력입니다.

**result.results.error** (`{ message: string; stack?: string; code?: string } | null`): 실행에 실패한 경우의 구조화된 오류입니다.

**result.results.startedAt** (`Date`): 실행이 시작된 시점입니다.

**result.results.completedAt** (`Date`): 실행이 완료된 시점입니다.

**result.results.retryCount** (`number`): 재시도 횟수입니다.

**result.results.traceId** (`string | null`): Observability를 위한 Trace ID입니다.

**result.results.createdAt** (`Date`): 결과 레코드가 생성된 시점입니다.

**result.pagination** (`PaginationInfo`): total, page, perPage, hasMore가 포함된 페이지네이션 메타데이터입니다.