dataset.listExperimentResults()

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

任意のフィルターとページネーションを使用して、特定の Experiment の項目別結果を一覧表示します。フィルターはストレージ層で適用されます。

使用例

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 結果。

object

results:

ExperimentResult[]

項目単位の結果の配列。

ExperimentResult

id:

string

一意な結果 ID。

experimentId:

string

親 Experiment の 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

Observability に使う Trace ID。

createdAt:

Date

結果レコードが作成された日時。

pagination:

PaginationInfo

total、page、perPage、hasMore を含むページネーションメタデータ。