> Discover all available pages from the documentation index: https://mastra.zisheng.pro/zh-HK/llms.txt

# DatasetsManager

**新增於：** `@mastra/core@1.4.0`

`DatasetsManager` 類別提供管理資料集的公開 API，包括 CRUD 操作及跨資料集的實驗比較。可透過 `mastra.datasets` 存取。

## 使用範例

### 建立及列出資料集

```typescript
import { Mastra } from '@mastra/core'

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

// Create a dataset
const dataset = await mastra.datasets.create({
  name: 'QA pairs',
  description: 'Question-answer evaluation set',
})

// List all datasets
const { datasets } = await mastra.datasets.list()
```

### 取得及刪除資料集

```typescript
import { Mastra } from '@mastra/core'

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

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

// Delete by ID
await mastra.datasets.delete({ id: 'dataset-id' })
```

### 取得實驗

按 ID 取得指定實驗（執行）。與 `dataset.getExperiment()` 不同，此方法適用於所有資料集，毋須先取得資料集參照。

```typescript
import { Mastra } from '@mastra/core'

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

// Get experiment directly without knowing the dataset
const experiment = await mastra.datasets.getExperiment({
  experimentId: 'exp-id',
})

console.log(`Dataset: ${experiment.datasetId}`)
console.log(`Status: ${experiment.status}`)
```

### 比較實驗

```typescript
import { Mastra } from '@mastra/core'

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

const comparison = await mastra.datasets.compareExperiments({
  experimentIds: ['exp-1', 'exp-2'],
  baselineId: 'exp-1',
})
```

## 存取方式

不會直接建立 `DatasetsManager` 執行個體。請從 `Mastra` 執行個體存取：

```typescript
const mastra = new Mastra({/* storage config */})
const datasetsManager = mastra.datasets
```

## 相關內容

- [Dataset 類別](https://mastra.zisheng.pro/zh-HK/reference/datasets/dataset)
- [DatasetsManager.create()](https://mastra.zisheng.pro/zh-HK/reference/datasets/create)
- [DatasetsManager.compareExperiments()](https://mastra.zisheng.pro/zh-HK/reference/datasets/compareExperiments)