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

# dataset.listExperiments()

**追加バージョン：** `@mastra/core@1.4.0`

任意のフィルターとページネーションを使用して、このデータセットの Experiment（実行）を一覧表示します。フィルターはストレージ層で適用されるため、結果は常に現在のデータセットに限定されます。

## 使用例

```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'`): この対象種別に対して実行された Experiment に結果を限定します。

**targetId** (`string`): この対象 ID に対して実行された Experiment に結果を限定します。

**agentVersion** (`string`): この Agent バージョンに対して記録された Experiment に結果を限定します。ベースライン実行とバリアント実行の区別に役立ちます。

**status** (`'pending' | 'running' | 'completed' | 'failed'`): このステータスの Experiment に結果を限定します。

**filters** (`ExperimentTenancyFilters`): マルチテナントのスコープフィルター（organizationId、projectId）。ストレージ層へ転送されます。

**page** (`number`): ページ番号。デフォルトは 0 です。

**perPage** (`number`): 1ページあたりの Experiment 数。デフォルトは 20 です。

## 戻り値

**result** (`Promise<object>`): ページネーションされた Experiment 一覧。

**result.experiments** (`Experiment[]`): Experiment レコードの配列。

**result.experiments.id** (`string`): 一意な Experiment ID。

**result.experiments.name** (`string`): 表示名。

**result.experiments.description** (`string`): Description.

**result.experiments.metadata** (`Record<string, unknown>`): 任意のメタデータ。

**result.experiments.datasetId** (`string`): 親データセットの ID。

**result.experiments.datasetVersion** (`number | null`): Experiment に使用したデータセットバージョン。

**result.experiments.targetType** (`'agent' | 'workflow' | 'scorer' | 'processor'`): 使用した対象の種類。

**result.experiments.targetId** (`string`): 使用した対象の ID。

**result.experiments.status** (`'pending' | 'running' | 'completed' | 'failed'`): Experiment の現在のステータス。

**result.experiments.totalItems** (`number`): 項目の総数。

**result.experiments.succeededCount** (`number`): 成功した項目数。

**result.experiments.failedCount** (`number`): 失敗した項目数。

**result.experiments.skippedCount** (`number`): スキップされた項目数。

**result.experiments.startedAt** (`Date | null`): Experiment が開始された日時。

**result.experiments.completedAt** (`Date | null`): Experiment が完了した日時。

**result.experiments.createdAt** (`Date`): Experiment レコードが作成された日時。

**result.experiments.updatedAt** (`Date`): Experiment レコードが最後に更新された日時。

**result.pagination** (`PaginationInfo`): total、page、perPage、hasMore を含むページネーションメタデータ。