API Vectors

L’API Vectors fournit des méthodes pour utiliser les embeddings vectoriels pour la recherche sémantique et la correspondance de similarité dans Mastra.

Utiliser les vecteurs

Récupérez une instance de magasin vectoriel :

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

Méthodes de vecteur

Obtenir les détails d’un index vectoriel

Récupérez les informations sur un index vectoriel spécifique :

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

Créer un index vectoriel

Créez un nouvel index vectoriel :

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

Mettre à jour ou insérer des vecteurs

Ajoutez ou mettez à jour des vecteurs dans un index :

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

Interroger des vecteurs

Recherchez des vecteurs similaires :

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

Obtenir tous les index

Listez tous les index disponibles :

const indexes = await vector.getIndexes()

Supprimer un index

Supprimez un index vectoriel :

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