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

# dataset.addItem()

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

向資料集新增單一項目。每個項目都有輸入和選用的 ground truth，也可以包含選用的中繼資料。

## 使用範例

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

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

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

const item = await dataset.addItem({
  input: { question: 'What is TypeScript?' },
  groundTruth: { answer: 'A typed superset of JavaScript' },
  metadata: { source: 'manual' },
})

console.log(item.id)
```

## 參數

**input** (`unknown`): 項目的輸入資料。

**groundTruth** (`unknown`): 用於評分的預期輸出或 ground truth。

**metadata** (`Record<string, unknown>`): 項目的任意中繼資料。

## 傳回值

**result** (`Promise<DatasetItem>`): 已建立的資料集項目。

**result.id** (`string`): 項目的唯一識別碼。

**result.datasetId** (`string`): 父資料集的 ID。

**result.datasetVersion** (`number`): 建立項目時的資料集版本。

**result.input** (`unknown`): 輸入資料。

**result.groundTruth** (`unknown`): Ground truth 資料。

**result.metadata** (`Record<string, unknown>`): 項目中繼資料。

**result.createdAt** (`Date`): 項目的建立時間。

**result.updatedAt** (`Date`): 項目的最後更新時間。