メインコンテンツへ移動

dataset.listExperiments()

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

// Basic pagination
const { experiments, pagination } = await dataset.listExperiments({ page: 0, perPage: 10 })

// Filter to a specific agent version — useful for baseline vs variant comparisons
const { experiments: v2Runs } = await dataset.listExperiments({
  targetType: 'agent',
  targetId: 'my-agent',
  agentVersion: 'v2',
  status: 'completed',
})

for (const exp of experiments) {
  console.log(`${exp.id}: ${exp.status} (${exp.succeededCount}/${exp.totalItems})`)
}

パラメータ
パラメータへの直接リンク

targetType?:

'agent' | 'workflow' | 'scorer' | 'processor'
この対象種別に対して実行された Experiment に結果を限定します。

targetId?:

string
この対象 ID に対して実行された Experiment に結果を限定します。

agentVersion?:

string
この Agent バージョンに対して記録された Experiment に結果を限定します。ベースライン実行とバリアント実行の区別に役立ちます。

status?:

'pending' | 'running' | 'completed' | 'failed'
このステータスの Experiment に結果を限定します。

filters?:

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

page?:

number
ページ番号。デフォルトは 0 です。

perPage?:

number
1ページあたりの Experiment 数。デフォルトは 20 です。

戻り値
戻り値への直接リンク

result:

Promise<object>
ページネーションされた Experiment 一覧。
object

experiments:

Experiment[]
Experiment レコードの配列。
Experiment

id:

string
一意な Experiment ID。

name?:

string
表示名。

description?:

string
Description.

metadata?:

Record<string, unknown>
任意のメタデータ。

datasetId:

string
親データセットの ID。

datasetVersion:

number | null
Experiment に使用したデータセットバージョン。

targetType:

'agent' | 'workflow' | 'scorer' | 'processor'
使用した対象の種類。

targetId:

string
使用した対象の ID。

status:

'pending' | 'running' | 'completed' | 'failed'
Experiment の現在のステータス。

totalItems:

number
項目の総数。

succeededCount:

number
成功した項目数。

failedCount:

number
失敗した項目数。

skippedCount:

number
スキップされた項目数。

startedAt:

Date | null
Experiment が開始された日時。

completedAt:

Date | null
Experiment が完了した日時。

createdAt:

Date
Experiment レコードが作成された日時。

updatedAt:

Date
Experiment レコードが最後に更新された日時。

pagination:

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