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

# 데이터 세트 개요

**추가된 항목:** `@mastra/core@1.4.0`

데이터세트는 Agent와 Workflow의 성능을 측정하기 위해 실험을 실행하는 테스트 사례 모음입니다. 각 돌연변이는 새로운 버전을 생성하므로 과거 실험을 정확하게 재현할 수 있습니다. 데이터세트를 다음과 페어링하세요.[scorers](https://mastra.zisheng.pro/ko/docs/evals/overview) 를 사용하여 Prompt, Model 또는 코드 변경 전반의 품질을 추적할 수 있습니다.

**AI Agent의 경우:**달리다`npx mastra api dataset create '{"name":"translation-pairs"}'` 를 사용하면 Studio를 열거나 임시 스크립트를 작성하지 않고 데이터 세트를 직접 생성할 수 있습니다. 이 명령을 사용하려면 데이터 세트를 지원하는 스토리지 어댑터가 구성된 Mastra 서버가 실행 중이어야 합니다. 다음 명령으로 로컬 서버를 시작하세요: `npx mastra dev`또는 다음을 사용하여 접근 가능한 서버의 기본 URL을 전달하세요: `--url`. 달리다`npx mastra api dataset create --schema`다른 데이터 세트 필드를 추가하기 전에. 마스트라의 스킬을 설치하세요.`npx skills add mastra-ai/skills --skill mastra`완전한 API CLI 검색, 타겟팅, 스키마, 인증 및 오류 처리 지침을 제공합니다.

## 용법

### 스토리지 구성

Mastra 인스턴스에서 스토리지를 구성합니다. 데이터 세트에는 다음을 제공하는 스토리지 어댑터가 필요합니다.`datasets` domain:

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

export const mastra = new Mastra({
  storage: new LibSQLStore({
    id: 'my-store',
    url: 'file:./mastra.db',
  }),
})
```

### 데이터 세트 API에 액세스

모든 데이터세트 작업은 다음을 통해 가능합니다.`mastra.datasets`:

```typescript
const datasets = mastra.datasets

// Create a dataset
const dataset = await datasets.create({ name: 'my-dataset' })

// Retrieve an existing dataset
const existing = await datasets.get({ id: 'dataset-id' })

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

방문[`DatasetsManager` reference](https://mastra.zisheng.pro/ko/reference/datasets/datasets-manager) for the full list of methods.

## 사진관

다음에서 데이터 세트를 관리할 수도 있습니다.[Studio](https://mastra.zisheng.pro/ko/docs/studio/overview). After opening Studio, select **Datasets** 를 사이드바에서 선택하여 사용 가능한 모든 데이터 세트를 확인하거나 새 데이터 세트를 생성하세요.

시작하려면 다음을 선택하세요.**Create Dataset** 를 선택하고 이름, 설명 및 선택적 스키마를 설정합니다. 확인하면 다음 두 개의 탭이 있는 데이터 세트 세부 정보 페이지가 표시됩니다: **Items** and [**Experiments**](https://mastra.zisheng.pro/ko/docs/datasets/running-experiments).

에서**Items** 보기에서는 항목을 추가, 업데이트 및 삭제하고 버전 기록을 확인할 수 있습니다. **Add Item** 를 선택하여 입력과 정답을 위한 JSON 편집기로 새 항목을 삽입합니다. 이 보기에서는 CSV 또는 JSON 파일에서 항목을 대량으로 가져올 수도 있습니다. 가져올 때 각 열을 해당 데이터 세트 필드에 매핑하세요.

선택하다**Versions** 를 선택하여 데이터 세트의 전체 변경 기록을 확인합니다. **Compare Versions**, choose any two versions and select **Compare** 를 선택하여 해당 버전 간에 추가, 변경 또는 제거된 모든 항목의 차이를 나란히 확인합니다.

## 데이터세트 만들기

부르다[`create()`](https://mastra.zisheng.pro/ko/reference/datasets/create) with a name and optional description:

```typescript
import { mastra } from '../index'

const dataset = await mastra.datasets.create({
  name: 'translation-pairs',
  description: 'English to Spanish translation test cases',
})

console.log(dataset.id) // auto-generated UUID
```

### 스키마 정의

모양을 강제할 수 있습니다.`input` and `groundTruth` by passing a [Standard JSON Schema](https://standardschema.dev/json-schema) ([Zod](https://zod.dev/), [Valibot](https://valibot.dev/), [ArkType](https://arktype.io/), etc.) when creating the dataset:

```typescript
import { z } from 'zod'
import { mastra } from '../index'

const dataset = await mastra.datasets.create({
  name: 'translation-pairs',
  inputSchema: z.object({
    text: z.string(),
    sourceLang: z.string(),
    targetLang: z.string(),
  }),
  groundTruthSchema: z.object({
    translation: z.string(),
  }),
})
```

스키마와 일치하지 않는 항목은 삽입 시 거부됩니다.

## 항목 추가

사용[`addItem()`](https://mastra.zisheng.pro/ko/reference/datasets/addItem) for a single item or [`addItems()`](https://mastra.zisheng.pro/ko/reference/datasets/addItems) to insert in bulk:

```typescript
// Single item
await dataset.addItem({
  input: { text: 'Hello', sourceLang: 'en', targetLang: 'es' },
  groundTruth: { translation: 'Hola' },
})

// Bulk insert
await dataset.addItems({
  items: [
    {
      input: { text: 'Goodbye', sourceLang: 'en', targetLang: 'es' },
      groundTruth: { translation: 'Adiós' },
    },
    {
      input: { text: 'Thank you', sourceLang: 'en', targetLang: 'es' },
      groundTruth: { translation: 'Gracias' },
    },
  ],
})
```

## 항목 업데이트 및 삭제

[`updateItem()`](https://mastra.zisheng.pro/ko/reference/datasets/updateItem), [`deleteItem()`](https://mastra.zisheng.pro/ko/reference/datasets/deleteItem), and [`deleteItems()`](https://mastra.zisheng.pro/ko/reference/datasets/deleteItems) let you modify or remove existing items by `itemId`:

```typescript
await dataset.updateItem({
  itemId: 'item-abc-123',
  groundTruth: { translation: '¡Hola!' },
})

await dataset.deleteItem({ itemId: 'item-abc-123' })

await dataset.deleteItems({ itemIds: ['item-1', 'item-2'] })
```

## 항목 나열 및 검색

[`listItems()`](https://mastra.zisheng.pro/ko/reference/datasets/listItems)페이지 매김 및 전체 텍스트 검색을 지원합니다.

```typescript
// Paginated list
const { items, pagination } = await dataset.listItems({
  page: 0,
  perPage: 50,
})

// Full-text search
const { items: matches } = await dataset.listItems({
  search: 'Hello',
})

// Search and pagination can be combined with a specific version
const { items: v2Matches } = await dataset.listItems({
  version: 2,
  search: 'Hello',
  page: 0,
  perPage: 50,
})

// Version-only snapshot returns a bare DatasetItem[]
const v2Items = await dataset.listItems({ version: 2 })
```

## 버전 관리

데이터세트 항목에 대한 모든 변형(추가, 업데이트 또는 삭제)으로 인해 데이터세트 버전이 변경됩니다. 이를 통해 데이터의 특정 스냅샷에 실험을 고정할 수 있습니다.

### 버전 나열

사용[`listVersions()`](https://mastra.zisheng.pro/ko/reference/datasets/listVersions) to see the paginated history of versions:

```typescript
const { versions, pagination } = await dataset.listVersions()

for (const v of versions) {
  console.log(`Version ${v.version} — created ${v.createdAt}`)
}
```

### 항목 내역 보기

호출을 통해 버전에 따라 특정 항목이 어떻게 변경되었는지 확인하세요.[`getItemHistory()`](https://mastra.zisheng.pro/ko/reference/datasets/getItemHistory) with the `itemId`:

```typescript
const history = await dataset.getItemHistory({ itemId: 'item-abc-123' })

for (const row of history) {
  console.log(`Version ${row.datasetVersion}`, row.input, row.groundTruth)
}
```

### 버전에 고정

이전 버전에 존재했던 정확한 항목을 가져옵니다.

```typescript
const items = await dataset.listItems({ version: 2 })
```

실험을 버전에 고정할 수도 있습니다.[running experiments](https://mastra.zisheng.pro/ko/docs/datasets/running-experiments). Visit the [`Dataset` reference](https://mastra.zisheng.pro/ko/reference/datasets/dataset) 에서 전체 메서드 및 매개변수 목록을 확인하세요.

## 관련된

- [실험 진행 중](https://mastra.zisheng.pro/ko/docs/datasets/running-experiments)
- [득점자 개요](https://mastra.zisheng.pro/ko/docs/evals/overview)
- [DatasetsManager 참조](https://mastra.zisheng.pro/ko/reference/datasets/datasets-manager)
- [데이터 세트 참조](https://mastra.zisheng.pro/ko/reference/datasets/dataset)
- 📹 [Mastra evals, datasets, and experiments workshop](https://www.youtube.com/watch?v=Vla5LfmOOrM)