> Discover all available pages from the documentation index: https://mastra.zisheng.pro/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`): 条目的最后更新时间。