メインコンテンツへ移動

Dataset クラス

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

Dataset クラスは、1つのデータセットに対する項目の CRUD、バージョン管理、Experiment 管理のメソッドを提供します。mastra.datasets.get() または mastra.datasets.create() で取得します。

使用例
使用例への直接リンク

項目を追加して Experiment を実行する
項目を追加して Experiment を実行するへの直接リンク

src/mastra/datasets/usage.ts
import { Mastra } from '@mastra/core'

const mastra = new Mastra({/* storage config */})

const dataset = await mastra.datasets.create({
name: 'QA pairs',
})

// Add items
await dataset.addItems({
items: [
{ input: { question: 'What is AI?' }, groundTruth: { answer: 'Artificial Intelligence' } },
{ input: { question: 'What is ML?' }, groundTruth: { answer: 'Machine Learning' } },
],
})

// Run an experiment
const summary = await dataset.startExperiment({
targetType: 'agent',
targetId: 'my-agent',
scorers: ['accuracy'],
})

console.log(`${summary.succeededCount}/${summary.totalItems} succeeded`)

バージョンと履歴を管理する
バージョンと履歴を管理するへの直接リンク

src/mastra/datasets/versioning.ts
import { Mastra } from '@mastra/core'

const mastra = new Mastra({/* storage config */})

const dataset = await mastra.datasets.get({ id: 'dataset-id' })

// List versions
const { versions } = await dataset.listVersions()

// List items at a specific version
const items = await dataset.listItems({ version: 2 })

// Get item change history
const history = await dataset.getItemHistory({ itemId: 'item-id' })

アクセス
アクセスへの直接リンク

Dataset は直接インスタンス化しません。DatasetsManager から取得します:

const dataset = await mastra.datasets.get({ id: 'dataset-id' })
// or
const dataset = await mastra.datasets.create({ name: 'My dataset' })

プロパティ
プロパティへの直接リンク

完全なデータセットレコード(名前、説明、スキーマ、バージョン、タイムスタンプ)を取得するには、dataset.getDetails() を呼び出します。

id:

string
一意な識別子: dataset. Read-only.