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

# 벡터 API

벡터 API는 Mastra의 의미 검색 및 유사성 일치를 위해 벡터 임베딩을 사용하는 방법을 제공합니다.

## 벡터 작업

벡터 저장소의 인스턴스를 가져옵니다.

```typescript
const vector = mastraClient.getVector('vector-name')
```

## 벡터 방법

### 벡터 인덱스 세부정보 가져오기

특정 벡터 인덱스에 대한 정보를 검색합니다.

```typescript
const details = await vector.details('index-name')
```

### 벡터 인덱스 생성

새 벡터 인덱스를 만듭니다.

```typescript
const result = await vector.createIndex({
  indexName: 'new-index',
  dimension: 128,
  metric: 'cosine', // 'cosine', 'euclidean', or 'dotproduct'
})
```

### 벡터 업서트

인덱스에 벡터를 추가하거나 업데이트합니다.

```typescript
const ids = await vector.upsert({
  indexName: 'my-index',
  vectors: [
    [0.1, 0.2, 0.3], // First vector
    [0.4, 0.5, 0.6], // Second vector
  ],
  metadata: [{ label: 'first' }, { label: 'second' }],
  ids: ['id1', 'id2'], // Optional: Custom IDs
})
```

### 쿼리 벡터

유사한 벡터 검색:

```typescript
const results = await vector.query({
  indexName: 'my-index',
  queryVector: [0.1, 0.2, 0.3],
  topK: 10,
  filter: { label: 'first' }, // Optional: Metadata filter
  includeVector: true, // Optional: Include vectors in results
})
```

### 모든 인덱스 가져오기

사용 가능한 모든 인덱스를 나열합니다.

```typescript
const indexes = await vector.getIndexes()
```

### 인덱스 삭제

벡터 인덱스 삭제:

```typescript
const result = await vector.delete('index-name')
```