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

# dataset.addItem()

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

將單一項目加入資料集。每個項目都有輸入及可選的基準答案；元資料亦為可選。

## 使用範例

```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`): 用於評分的預期輸出或基準答案。

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

## 傳回值

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

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

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

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

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

**result.groundTruth** (`unknown`): 基準答案資料。

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

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

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