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 的分页元数据。