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

# 向量

向量儲存建構函式現在必須使用 `id` 屬性，而向量儲存方法也已重新命名，以遵循一致的命名慣例。

## 已變更

### 向量儲存執行個體必須使用 `id` 屬性

向量儲存執行個體現在必須使用 `id` 屬性。這個唯一識別碼用來在 Mastra 中追蹤及管理向量儲存執行個體。應為應用程式中的每個向量儲存設定具描述性且不重複的 `id` 字串。

遷移時，請在向量儲存建構函式中新增 `id` 欄位。

```diff
const vectorStore = new PgVector({
+   id: 'main-vector-store',
    connectionString: process.env.POSTGRES_CONNECTION_STRING,
  });

  const chromaStore = new ChromaVector({
+   id: 'chroma-embeddings',
    url: process.env.CHROMA_URL,
  });

  const pineconeStore = new PineconeVector({
+   id: 'pinecone-production',
    apiKey: process.env.PINECONE_API_KEY,
  });
```

### `getVectors` 改為 `listVectors`

`getVectors()` 方法已重新命名為 `listVectors()`。這項變更與整個 API 使用的命名慣例一致：回傳多筆資料的 getter 方法會使用 `list` 前綴。

遷移時，請將所有 `getVectors()` 呼叫替換成 `listVectors()`。

```diff
const vectorStore = new VectorStore({ ... });

- const vectors = await vectorStore.getVectors({ ... });
+ const vectors = await vectorStore.listVectors({ ... });
```

### `LibSQLVector`：`connectionUrl` 改為 `url`

`connectionUrl` 參數已重新命名為 `url`，以配合 `@libsql/client` API，並與 LibSQLStorage 一致。

```diff
const vectorStore = new LibSQLVector({
    id: 'my-vector',
-   connectionUrl: 'file:./db.sqlite',
+   url: 'file:./db.sqlite',
  });
```

### `OpenSearchVector`：`url` 改為 `node`

`url` 參數已重新命名為 `node`，以符合 OpenSearch `ClientOptions` API。建構函式現在接受所有 OpenSearch 使用者端選項，包括驗證、SSL 與壓縮。

```diff
const vectorStore = new OpenSearchVector({
    id: 'my-vector',
-   url: 'http://localhost:9200',
+   node: 'http://localhost:9200',
  });
```

### `PineconeVector`：移除 `environment`

`environment` 參數已移除。如果需要指定自訂控制器主機，請改用 `controllerHostUrl`。建構函式現在接受所有 Pinecone 設定選項。

```diff
const vectorStore = new PineconeVector({
    id: 'my-vector',
    apiKey: process.env.PINECONE_API_KEY,
-   environment: process.env.PINECONE_ENVIRONMENT,
  });
```

如果需要自訂控制器主機：

```ts
const vectorStore = new PineconeVector({
  id: 'my-vector',
  apiKey: process.env.PINECONE_API_KEY,
  controllerHostUrl: 'https://api.pinecone.io',
})
```