dataset.addItem()

Added in: @mastra/core@1.4.0

Adds a single item to the dataset. Each item has an input, optional ground truth, and optional metadata.

Usage example

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);

Parameters

input:

unknown

Input data for the item.

groundTruth?:

unknown

Expected output or ground truth for scoring.

metadata?:

Record<string, unknown>

Arbitrary metadata for the item.

Returns

result:

Promise<DatasetItem>

The created dataset item.

DatasetItem

id:

string

Unique identifier of the item.

datasetId:

string

ID of the parent dataset.

datasetVersion:

number

Dataset version when the item was created.

input:

unknown

Input data.

groundTruth?:

unknown

Ground truth data.

metadata?:

Record<string, unknown>

Item metadata.

createdAt:

Date

When the item was created.

updatedAt:

Date

When the item was last updated.