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

# dataset.listExperimentResults()

**追加バージョン：** `@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' })

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`): 結果を一覧表示する Experiment の ID。

**traceId** (`string`): この Trace ID に関連付けられた結果に限定します。

**status** (`'needs-review' | 'reviewed' | 'complete'`): 結果ごとのレビューステータスがこの値のものに限定します。

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

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

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

## 戻り値

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

**result.results** (`ExperimentResult[]`): 項目単位の結果の配列。

**result.results.id** (`string`): 一意な結果 ID。

**result.results.experimentId** (`string`): 親 Experiment の 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 を含むページネーションメタデータ。