dataset.listExperimentResults()

新增於： @mastra/core@1.4.0

列出特定實驗中各個項目的結果，並支援選用篩選條件和分頁。篩選條件會套用在儲存層。

使用範例

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>

分頁的實驗結果。

object

results:

ExperimentResult[]

項目級結果陣列。

ExperimentResult

id:

string

結果的唯一 ID。

experimentId:

string

父實驗的 ID。

itemId:

string

資料集項目的 ID。

itemDatasetVersion:

number | null

執行項目時的資料集版本。

input:

unknown

傳遞給目標的輸入資料。

output:

unknown | null

目標的輸出。

groundTruth:

unknown | null

預期輸出。

error:

{ message: string; stack?: string; code?: string } | null

執行失敗時的結構化錯誤。

startedAt:

Date

執行開始時間。

completedAt:

Date

執行完成時間。

retryCount:

number

重試次數。

traceId:

string | null

用於可觀測性的 Trace ID。

createdAt:

Date

結果記錄的建立時間。

pagination:

PaginationInfo

包含 total、page、perPage 和 hasMore 的分頁中繼資料。