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

# dataset.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`): 用於可觀測性的 Trace ID。

**result.results.createdAt** (`Date`): 結果記錄的建立時間。

**result.pagination** (`PaginationInfo`): 包含 total、page、perPage 及 hasMore 的分頁元資料。