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

# Vector

Vector store constructor 現在必須提供 `id` 屬性，而 Vector store 方法亦已重新命名，以遵循一致的命名慣例。

## 已變更

### Vector store 實例必須提供 `id` 屬性

Vector store 實例現在必須提供 `id` 屬性。這個唯一識別碼用於在 Mastra 內追蹤及管理 Vector store 實例。每個應用程式內的 Vector store 都應使用具描述性且唯一的 `id` 字串。

如要遷移，請在 Vector store constructor 加入 `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` 前綴。

如要遷移，請以 `listVectors()` 取代所有 `getVectors()` 呼叫。

```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。Constructor 現在接受所有 OpenSearch client 選項，包括驗證、SSL 及壓縮。

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

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

`environment` 參數已移除。如需指定自訂 controller host，請改用 `controllerHostUrl`。Constructor 現在接受所有 Pinecone 設定選項。

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

如需自訂 controller host：

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