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

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

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

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

**result.experiments** (`Experiment[]`): 실험 레코드의 배열입니다.

**result.experiments.id** (`string`): 실험의 고유 ID입니다.

**result.experiments.name** (`string`): 표시 이름입니다.

**result.experiments.description** (`string`): 설명입니다.

**result.experiments.metadata** (`Record<string, unknown>`): 임의의 메타데이터입니다.

**result.experiments.datasetId** (`string`): 상위 데이터 세트의 ID입니다.

**result.experiments.datasetVersion** (`number | null`): 실험에 사용된 데이터 세트 버전입니다.

**result.experiments.targetType** (`'agent' | 'workflow' | 'scorer' | 'processor'`): 사용된 대상의 유형입니다.

**result.experiments.targetId** (`string`): 사용된 대상의 ID입니다.

**result.experiments.status** (`'pending' | 'running' | 'completed' | 'failed'`): 실험의 현재 상태입니다.

**result.experiments.totalItems** (`number`): 전체 항목 수입니다.

**result.experiments.succeededCount** (`number`): 성공한 항목 수입니다.

**result.experiments.failedCount** (`number`): 실패한 항목 수입니다.

**result.experiments.skippedCount** (`number`): 건너뛴 항목 수입니다.

**result.experiments.startedAt** (`Date | null`): 실험이 시작된 시점입니다.

**result.experiments.completedAt** (`Date | null`): 실험이 완료된 시점입니다.

**result.experiments.createdAt** (`Date`): 실험 레코드가 생성된 시점입니다.

**result.experiments.updatedAt** (`Date`): 실험 레코드가 마지막으로 업데이트된 시점입니다.

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